SNMP 输入插件

smidump函数在其预先配置的路径列表中查找 mib 依赖项。您可能需要提供特定环境中 MIB 位置的路径。

您可以通过提供以下附加路径配置信息来避免failed to locate MIB module错误：

有关更多信息，请参阅smi_config 文档中的“模块位置”部分。

使用指向您的 mib 的路径设置SMIPATH环境变量。请确保为路径添加前置冒号 (:)。

$ SMIPATH=":/path/to/mibs/" smidump -k -f python CISCO-PROCESS-MIB.mib > CISCO-PROCESS-MIB_my.dic 

另一种方法是使用path选项创建一个配置文件。例如，您可以创建一个名为smi.conf的文件。

path :/path/to/mibs/

将配置与 smidump 一起使用

$ smidump -c smi.conf -k -f python CISCO-PROCESS-MIB.mib > CISCO-PROCESS-MIB_my.dic

使用get选项查询给定 OID 的标量值。一个或多个 OID 被指定为 OID 字符串数组。

示例

input {
  snmp {
    get => ["1.3.6.1.2.1.1.1.0", "1.3.6.1.2.1.1.3.0", "1.3.6.1.2.1.1.5.0"]
    hosts => [{host => "udp:127.0.0.1/161" community => "public"}]
  }
}

hosts选项指定要查询已配置的get和walk选项的主机列表。

每个主机定义都是一个哈希，并且必须定义host键和值。 host必须使用格式{tcp|udp}:{ip 地址}/{端口}，例如host => "udp:127.0.0.1/161"

每个主机定义可以选择性地包含以下键和值

指定所有主机选项

input {
  snmp {
    get => ["1.3.6.1.2.1.1.1.0"]
    hosts => [{host => "udp:127.0.0.1/161" community => "public" version => "2c"  retries => 2  timeout => 1000}]
  }
}

指定多个主机

input {
  snmp {
    get => ["1.3.6.1.2.1.1.1.0"]
    hosts => [{host => "udp:127.0.0.1/161" community => "public"}, {host => "udp:192.168.0.1/161" community => "private"}]
  }
}

指定 IPv6 主机

input {
  snmp {
    get => ["1.3.6.1.2.1.1.1.0"]
    hosts => [{host => "udp:[::1]/161" community => "public"}, {host => "udp:[2001:db8::2:1]/161" community => "private"}]
  }
}

interval选项指定以秒为单位的轮询间隔。如果轮询所有已配置的主机花费的时间超过此间隔，则会向日志发出警告。

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

此插件包含 IETF MIB。如果您需要其他 MIB，则需要导入它们。请参阅导入 MIB。

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”。

使用walk选项检索给定 OID 的信息子树。一个或多个 OID 被指定为 OID 字符串数组。

查询从给定 OID 开始的信息子树。

示例

  snmp {
    walk => ["1.3.6.1.2.1.1"]
    hosts => [{host => "udp:127.0.0.1/161" community => "public"}]
  }
}

tables选项用于查询给定列 OID 的表格值。

每个表定义都是一个哈希，必须定义名称键和值以及要返回的列。

指定单个表

input {
  snmp {
    hosts => [{host => "udp:127.0.0.1/161" community => "public" version => "2c"  retries => 2  timeout => 1000}]
    tables => [ {"name" => "interfaces" "columns" => ["1.3.6.1.2.1.2.2.1.1", "1.3.6.1.2.1.2.2.1.2", "1.3.6.1.2.1.2.2.1.5"]} ]
  }
}

指定多个表

input {
  snmp {
    get => ["1.3.6.1.2.1.1.1.0"]
    tables => [ {"name" => "interfaces" "columns" => ["1.3.6.1.2.1.2.2.1.1", "1.3.6.1.2.1.2.2.1.2", "1.3.6.1.2.1.2.2.1.5"]}, {"name" => "ltmPoolStatTable" "columns" => ["1.3.6.1.4.1.3375.2.2.5.2.3.1.1", "1.3.6.1.4.1.3375.2.2.5.2.3.1.6"]} ]
  }
}

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

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

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

priv_pass 选项指定 SNMPv3 加密密码。

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

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

security_level 选项指定身份验证、无隐私；身份验证、隐私；或无身份验证、无隐私之间的 SNMPv3 安全级别。

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

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

向事件添加字段

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

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

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

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

这有助于以后的处理。

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

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

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

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