Http 输入插件

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

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

控制此插件与Elastic Common Schema (ECS)的兼容性。有关详细信息，请参阅事件元数据和 Elastic Common Schema (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。当您有两个或多个相同类型的插件时，此 ID 特别有用，例如，如果您有 2 个 http 输入。在这种情况下添加命名的 ID 将有助于在使用监控 API 时监控 Logstash。

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

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

这有助于以后的处理。

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

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

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

如果您尝试在已经具有类型的事件上设置类型（例如，当您将事件从 shipper 发送到 indexer 时），则新的输入将不会覆盖现有的类型。在 shipper 上设置的类型会随着事件的生命周期保留，即使发送到另一个 Logstash 服务器也是如此。