Logstash 输入插件

此输入插件需要配置为绑定到 TCP 端口，并且可以通过提供 主机 的 IP 地址来限制绑定到特定接口。

除非禁用 SSL，否则此插件需要配置身份材料

通过 SSL 通信时，可以配置此插件以请求或要求连接的客户端通过 ssl_client_authentication 提供其自身的身份声明。

默认情况下，使用系统信任存储验证客户端提供的证书，以确保它们当前有效且受信任，并且客户端可以证明其拥有相关的私钥。您可以使用以下方法提供备用信任源

您还可以配置此插件以要求通过配置 username 和 password 来提供特定的用户名/密码。这样做需要连接的 logstash-output 插件客户端提供匹配的 username 和 password。

通过提供其 IP 地址来指定要侦听的接口。默认情况下，此输入侦听所有可用的接口。

用于基于密码的身份验证的密码。需要 username。

指定要侦听的端口。

PEM 编码的证书或证书链的路径，用于向连接的客户端标识此插件。该证书应包括有关客户端用于建立连接的 IP 地址或主机名的身份声明。

一个或多个 PEM 编码的文件，定义用于客户端身份验证的证书颁发机构。此设置可用于覆盖系统信任存储，以验证客户端提供的 SSL 证书。

默认情况下，服务器不执行任何客户端身份验证。这意味着启用 SSL 后，客户端的连接是私有的，但此输入将允许来自任何客户端的 SSL 连接。如果您希望配置此插件以拒绝来自不受信任主机的连接，则需要配置此插件以验证客户端，并且可能还需要配置其信任源。

默认情况下启用 SSL，这需要配置此插件以提供其身份。

您可以使用 +ssl_enabled => false+ 禁用 SSL。禁用后，设置任何 ssl_* 配置会导致配置失败。

PEM 编码的加密 PKCS8 SSL 证书密钥的路径。

ssl_keystore_path 的密码

JKS 或 PKCS12 格式的密钥库的路径，用于向 Elasticsearch 标识此插件。

ssl_key 的密码或密码短语。

用于基于密码的身份验证的用户名。当使用 username 配置此输入插件时，它还需要 password，并且任何上游 logstash-output 插件也必须配置为匹配的 username/password 对。

向事件添加字段

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

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

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

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

这有助于后续处理。

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

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

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

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