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 服务器也是如此。