HTTP 输出插件

库级别重试适用于与 IO 相关的故障。不可重试的错误包括与 SSL 相关的故障、无法解析的主机、连接问题以及请求期间发生的 OS/JVM 级中断。

库级别重试的选项为：

插件级别重试的选项为：

客户端应重试失败的 URL 的次数。如果启用了 keepalive 选项，我们建议将此选项设置为非零值。某些服务器会错误地过早结束 keepalive，需要重试。有关详细信息，请参见 重试策略。

如果您需要使用自定义 X.509 CA（.pem 证书），请在此处指定其路径。

如果您要使用客户端证书（请注意，大多数人都不会使用此证书），请在此处设置 x509 证书的路径。

如果您使用客户端证书，请在此处指定加密密钥的路径。

等待建立连接的超时时间（以秒为单位）。默认为 10s

内容类型

如果未指定，则默认为：

启用 Cookie 支持。启用此选项后，客户端将像普通的 Web 浏览器一样在请求之间持久保存 Cookie。默认情况下启用。

是否应跟踪重定向？默认为 true

设置 HTTP 主体的格式。

如果为 json_batch，则此输出接收到的每个事件批次都将被放入单个 JSON 数组中，并通过一个请求发送。这对于高吞吐量场景（例如在 Logstash 实例之间发送数据）特别有用。

如果为 form，则主体将是转换为查询参数字符串的映射（或整个事件），例如 foo=bar&baz=fizz...

如果为 message，则主体将是根据 message 格式化事件的结果。

否则，事件将作为 json 发送。

要使用的自定义标头，格式为 headers => ["X-My-Header", "%{host}"]

启用请求压缩支持。启用此选项后，插件将使用 gzip 压缩 HTTP 请求。

HTTP 动词。“put”、“post”、“patch”、“delete”、“get”、“head” 之一

如果您想将某些非 2xx 代码视为成功，请在此处列出它们。返回这些代码的响应将被视为成功。

启用此选项以启用 HTTP keepalive 支持。我们强烈建议为此设置 automatic_retries 为至少 1，以修复与损坏的 keepalive 实现的交互。

如果您需要使用自定义密钥库（.jks），请在此处指定。这与 .pem 密钥不兼容！

在此处指定密钥库密码。请注意，大多数使用 keytool 创建的 .jks 文件都需要密码！

在此处指定密钥库类型。JKS 或 PKCS12 之一。默认为 JKS

这允许您选择要发送的事件的结构和部分。

例如

   mapping => {"foo" => "%{host}"
              "bar" => "%{type}"}

最大并发连接数。默认为 50

到单个主机的最大并发连接数。默认为 25

如果您要使用 HTTP 代理。这支持多种配置语法。

此模块基于[Manticore](https://github.com/cheald/manticore)简化了在Logstash中添加完全配置的HTTP客户端的过程。有关其用法的示例，请参阅https://github.com/logstash-plugins/logstash-input-http_poller整个请求的超时时间（以秒为单位）

请注意，此选项仅控制插件级别的重试。它对库级别的重试没有影响。

如果您想禁用对retryable_codes中定义的HTTP错误响应代码或可重试异常（超时、SocketException、ClientProtocolException、ResolutionFailure和SocketTimeout）的无限重试，请将此选项设置为false。有关更多信息，请参阅重试策略。

当此选项设置为false且automatic_retries启用时，将重试GET、HEAD、PUT、DELETE、OPTIONS和TRACE请求。

当设置为true且automatic_retries启用时，这将导致非幂等HTTP动词（如POST）被重试。有关更多信息，请参阅重试策略。

如果插件遇到这些响应代码，插件将无限期重试。有关更多信息，请参阅重试策略。

等待套接字上数据的超时时间（以秒为单位）。默认为10s

用于验证客户端的SSL证书。此证书应为OpenSSL风格的X.509证书文件。

用于验证服务器证书的.cer或.pem CA文件。

要使用的密码套件列表，按优先级列出。支持的密码套件因Java和协议版本而异。

启用SSL/TLS安全通信。对于其他ssl_选项生效，它必须为true。

与ssl_certificate相对应的OpenSSL风格的RSA私钥。

设置密钥库密码

用于向服务器提供证书的密钥库。它可以是.jks或.p12

密钥库文件的格式。它必须是jks或pkcs12。

建立与HTTP端点连接时要使用的允许的SSL/TLS版本列表。

对于Java 8，'TLSv1.3'仅从8u262（AdoptOpenJDK）开始支持，但需要在Logstash中设置LS_JAVA_OPTS="-Djdk.tls.client.protocols=TLSv1.3"系统属性。

设置信任库密码

用于验证服务器证书的信任库。它可以是.jks或.p12。

信任库文件的格式。它必须是jks或pkcs12。

控制服务器证书的验证。full选项验证提供的证书是由受信任的授权机构（CA）签名的，并且服务器的主机名（或IP地址）与证书中标识的名称匹配。

none设置不执行服务器证书的验证。此模式禁用了SSL/TLS的许多安全优势，只有在仔细考虑后才能使用。它主要作为尝试解决TLS错误时的临时诊断机制。强烈建议不要在生产环境中使用none。

如果您需要使用自定义信任库（.jks），请在此处指定。这与.pem证书不兼容！

在此处指定信任库密码。请注意，大多数使用keytool创建的.jks文件都需要密码！

在此处指定信任库类型。JKS或PKCS12。默认为JKS

要使用的URL

在使用keepalive对连接执行请求之前，等待多长时间才能检查连接是否陈旧。如果您经常遇到连接错误，您可能需要将其设置为更低的值，甚至设置为0。引用Apache commons文档（此客户端基于Apache Commmons）：_定义了在持久连接必须在被租借给消费者之前重新验证之前的非活动毫秒数。传递给此方法的非正值会禁用连接验证。此检查有助于检测在保持非活动状态的池中变得陈旧（半关闭）的连接。_有关更多信息，请参阅这些文档

用于输出数据的编解码器。输出编解码器是在数据离开输出之前对其进行编码的便捷方法，无需在Logstash管道中使用单独的过滤器。

禁用或启用此特定插件实例的指标日志记录。默认情况下，我们会记录所有可以记录的指标，但是您可以禁用特定插件的指标收集。

向插件配置添加唯一的ID。如果未指定ID，Logstash将生成一个。强烈建议您在配置中设置此ID。当您有两个或多个相同类型的插件时，这尤其有用。例如，如果您有两个http输出。在这种情况下，添加命名的ID将有助于在使用监控API监控Logstash时提供帮助。

output {
  http {
    id => "my_plugin_id"
  }
}