HTTP 输入插件

为特定内容类型应用特定的编解码器。只有在此列表检查后且未找到请求内容类型的编解码器时，才会应用默认编解码器。

要使用的密码套件列表，按优先级列出。

控制此插件与 Elastic 通用架构 (ECS) 的兼容性。有关详细信息，请参阅 事件元数据和 Elastic 通用架构 (ECS)。

示例输出：ECS 已禁用

{
    "@version" => "1",
    "headers" => {
           "request_path" => "/twitter/tweet/1",
            "http_accept" => "*/*",
           "http_version" => "HTTP/1.1",
         "request_method" => "PUT",
              "http_host" => "localhost:8080",
        "http_user_agent" => "curl/7.64.1",
         "content_length" => "5",
           "content_type" => "application/x-www-form-urlencoded"
    },
    "@timestamp" => 2021-05-28T19:27:28.609Z,
    "host" => "127.0.0.1",
    "message" => "hello"
}

示例输出：ECS 已启用

{
    "@version" => "1",
    "user_agent" => {
        "original" => "curl/7.64.1"
    },
    "http" => {
        "method" => "PUT",
        "request" => {
            "mime_type" => "application/x-www-form-urlencoded",
            "body" => {
                "bytes" => "5"
            }
        },
        "version" => "HTTP/1.1"
    },
    "url" => {
          "port" => "8080",
        "domain" => "snmp1",
          "path" => "/twitter/tweet/1"
    },
    "@timestamp" => 2021-05-28T23:32:38.222Z,
    "host" => {
        "ip" => "127.0.0.1"
    },
    "message" => "hello",
}

要绑定的主机或 IP 地址

用于验证客户端证书的 JKS 密钥库

设置密钥库密码

基本身份验证的密码

要绑定的 TCP 端口

HTTP 请求的最大内容长度（字节）。默认为 100MB。

在由工作线程处理之前，要在临时队列中存储的传入请求的最大数量。如果请求到达且队列已满，则会立即返回 429 响应。此队列用于处理事件的微突发并提高整体吞吐量，因此应非常谨慎地更改此队列，因为它可能导致内存压力并影响性能。如果您需要同时处理定期或意外的传入请求激增，请考虑为 Logstash 管道启用持久队列。

如果请求成功处理，则为 HTTP 返回代码。

在错误情况下，可能会出现其他返回代码，例如无效凭据 (401)、内部错误 (503) 或反压 (429)。

如果设置为 204（无内容），则响应正文不会发送到响应中。

指定自定义的响应头集

为 HTTP 请求的客户端主机指定目标字段

指定 HTTP 请求客户端主机的目标字段

默认情况下，事件以纯文本形式发送。可以通过将 ssl 设置为 true 并配置 ssl_certificate 和 ssl_key 选项来启用加密。

要使用的 SSL 证书。

针对这些证书颁发机构验证客户端证书。您可以定义多个文件或路径。所有证书都将被读取并添加到信任库。您需要将 ssl_client_authentication 配置为 optional 或 required 以启用验证。

要使用的密码套件列表，按优先级列出。此默认列表适用于 OpenJDK 11.0.14 及更高版本。对于较旧的 JDK 版本，默认列表仅包含该版本支持的套件。例如，ChaCha20 系列密码在旧版本中不受支持。

控制服务器在请求客户端连接证书方面的行为：required 强制客户端提供证书，而 optional 请求客户端证书，但客户端不需要提供证书。默认为 none，这将禁用客户端身份验证。

默认情况下，事件以纯文本形式发送。可以通过将 ssl_enabled 设置为 true 并配置 ssl_certificate 和 ssl_key 选项来启用加密。

不完整的 ssl 握手超时的时间（毫秒）

要使用的 SSL 密钥。注意：此密钥需要为 PKCS8 格式，您可以使用 OpenSSL 进行转换，更多信息请参考。

要使用的 SSL 密钥密码。

包含私钥和证书的密钥库文件的路径。它必须是 Java 密钥库 (jks) 或 PKCS#12 文件。

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

设置 JKS 密钥库密码

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

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

设置信任库密码

包含要信任的证书的密钥库文件的路径。它必须是 Java 密钥库 (jks) 或 PKCS#12 文件。

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

默认情况下，服务器不执行任何客户端验证。

peer 将使服务器要求客户端提供证书。如果客户端提供证书，则将对其进行验证。

force_peer 将使服务器要求客户端提供证书。如果客户端不提供证书，则连接将被关闭。

此选项需要与 ssl_certificate_authorities 和已定义的 CA 列表一起使用。

用于接受连接和处理请求的线程数

允许的加密连接的最大 TLS 版本。值必须是以下值之一：1.1 表示 TLS 1.1，1.2 表示 TLS 1.2，1.3 表示 TLSv1.3

允许的加密连接的最小 TLS 版本。值必须是以下值之一：1.1 表示 TLS 1.1，1.2 表示 TLS 1.2，1.3 表示 TLSv1.3

基本身份验证的用户名

设置客户端证书验证方法。有效方法：none、peer、force_peer

向事件添加字段

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

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

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

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

向您的事件添加任意数量的任意标签。

这可以帮助以后进行处理。

向此输入处理的所有事件添加 type 字段。

类型主要用于过滤器激活。

类型存储为事件本身的一部分，因此您也可以使用类型在 Kibana 中搜索它。

如果您尝试在一个已经拥有类型的事件上设置类型（例如，当您从发件人将事件发送到索引器时），则新的输入不会覆盖现有的类型。即使发送到另一个 Logstash 服务器，在发件人处设置的类型也会一直保留在该事件中。