SNMP Trap 输入插件

要侦听的 SNMPv1 和 SNMPv2c community。要允许任何 community，请将此配置值设置为空 community => []。

示例

侦听 public 和 guest community

input {
  snmptrap {
    community => ["public", "guest"]
  }
}

侦听所有 community

input {
  snmptrap {
    community => []
  }
}

控制此插件与Elastic Common Schema (ECS)的兼容性。

要侦听的地址。

mib_paths 选项指定一个或多个导入的 MIB 文件的位置。该值可以是包含导入的 MIB (.dic、.yaml) 文件的目录路径，也可以是单个 MIB 文件的文件路径。

定义 Logstash 事件中 OID 的映射文本表示形式：* default 使用 MIB 解析的名称（以点分隔）转换每个标识符。示例：1.3.6.1.2.1.1.2.0 映射为 iso.org.dod.internet.mgmt.mib-2.system.sysObjectID.0 * ruby_snmp 生成以 MIB 模块名称为前缀的字段名称，后跟最新的已解析标识符名称和未知值。示例：1.3.6.1.2.1.1.2.0 映射为 SNMPv2-MIB::sysObjectID.0。* dotted_string 使用标准点字符串表示形式映射字段。示例：1.3.6.1.2.1.1.2.0 映射为 1.3.6.1.2.1.1.2.0

定义是否使用在oid_mapping_format选项上配置的 OID 文本表示形式映射类型为 OID 的 Logstash 事件字段值。

oid_root_skip 选项指定在事件字段名称中要忽略的 OID 根数字的数量。例如，在像“1.3.6.1.2.1.1.1.0”这样的数字 OID 中，可以通过设置 oid_root_skip => 5 来忽略前 5 位数字，这将导致字段名称为“1.1.1.0”。同样，当使用 MIB 时，诸如“1.3.6.1.2.mib-2.system.sysDescr.0”之类的 OID 将变为“mib-2.system.sysDescr.0”

oid_path_length 选项指定在事件字段名称中要保留的 OID 根数字的数量。例如，在像“1.3.6.1.2.1.1.1.0”这样的数字 OID 中，可以通过设置 oid_path_length => 2 来保留最后 2 位数字，这将导致字段名称为“1.0”。同样，当使用 MIB 时，诸如“1.3.6.1.2.mib-2.system.sysDescr.0”之类的 OID 将变为“sysDescr.0”

要侦听的端口。请记住，小于 1024 的端口（特权端口）可能需要 root 才能使用。因此默认值为 1062。

要侦听的受支持传输协议。

SNMP 最初设计用于将 UDP 作为传输协议，这是官方建议。TCP 是一种可选的传输映射，可以根据需要启用。有关通过 TCP 的 SNMP 的更多详细信息，请参阅RFC-3430。

要侦听的受支持的 SNMP 协议版本。对于不支持和/或禁用的版本，SNMP 消息会自动丢弃。

SNMP 有效负载分配的字段名称。如果未指定，数据将存储在事件的根目录中。

启用 ecs_compatibility 时，建议设置目标。

用于处理接收到的 SNMP trap 消息的线程数。

此插件提供了 libsmi 0.5.0 版本中公开提供的所有 IETF MIB（管理信息库）。启用后，它会自动加载捆绑的 MIB，并在生成的事件中提供数字 OID 到 MIB 字段名称的映射。

YAML MIB 映射目录（与 ruby-snmp 使用的格式相同）

auth_pass 选项指定 SNMPv3 身份验证密码或密码。

auth_protocol 选项指定 SNMPv3 身份验证协议或类型

priv_pass 选项指定 SNMPv3 加密密码。

priv_protocol 选项指定 SNMPv3 隐私/加密协议。

security_level 选项指定 SNMPv3 安全级别，取值范围为身份验证、无隐私；身份验证、隐私；或无身份验证、无隐私。

security_name 选项指定 SNMPv3 安全名称或用户名。

向事件添加一个字段

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

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

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

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

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

这有助于以后的处理。

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

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

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

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