SNMP 陷阱输入插件

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

示例

侦听 public 和 guest 社区

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

侦听所有社区

input {
  snmptrap {
    community => []
  }
}

控制此插件与 Elastic 通用模式 (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

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

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

选项 oid_path_length 指定在事件字段名称中保留的 OID 根数字的数量。例如，在像 "1.3.6.1.2.1.1.1.0" 这样的数字 OID 中，可以通过设置 oid_path_length => 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 陷阱消息的线程数。

此插件提供所有 IETF MIB（管理信息库），可在 libsmi 版本 0.5.0 中公开获取。启用后，它会自动加载捆绑的 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。当您有两个或多个相同类型的插件时，这尤其有用，例如，如果您有两个 snmptrap 输入。在这种情况下，添加一个命名 ID 将有助于在使用监控 API 时监控 Logstash。

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

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

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

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

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

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

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