Documentation
Table of Contents
2 SNMP代理
概述
您可能希望在打印机、网络交换机、路由器或 UPS 等设备上使用 SNMP 监控，这些设备通常启用 SNMP，并且在这些设备上尝试设置完整的操作系统和 Zabbix 代理是不切实际的。
为了能够在这些设备上检索 SNMP agent提供的数据，Zabbix 服务器必须 初始配置 通过指定 --with-net-snmp 支持 SNMP 标志。
SNMP 检查仅通过 UDP 协议执行。
Zabbix 服务器和代理守护进程在单个请求中查询 SNMP 设备的多个值。 这会影响所有类型的 SNMP 监控项（常规 SNMP 监控项、具有动态索引的 SNMP 监控项和 SNMP 底层自动发现）并且应该使 SNMP 处理更加高效。 请参阅 bulk processing 部分，了解有关其内部工作方式的技术细节。 使用每个接口的“使用批量请求”设置，也可以为无法正确处理批量请求的设备禁用批量请求。
如果 Zabbix 服务器和代理守护进程收到不正确的 SNMP 响应，日志行将类似于以下内容：
· 来自主机“网关”的 SNMP 响应不包含所有请求的变量绑定
虽然它们没有涵盖所有有问题的情况，但它们对于识别应该禁用批量请求的单个 SNMP 设备很有用。
Zabbix server/proxy 总是会在查询尝试失败后至少重试一次：通过 SNMP 库的重试机制或通过内部 bulk processing 机制。
如果监控 SNMPv3 设备，请确保 msgAuthoritativeEngineID（也称为 snmpEngineID 或“引擎 ID”）永远不会被两个设备共享。 根据 RFC 2571（第 3.1.1.1 节），每个设备都必须是唯一的。
RFC3414 要求 SNMPv3 设备保留其 engineBoots。 一些设备不这样做，这导致它们的 SNMP 消息在重新启动后被丢弃为过时的。 在这种情况下，需要在服务器/代理上手动清除 SNMP 缓存（通过使用 -R snmp_cache_reload）或者需要重新启动服务器/代理 .
配置SNMP监控
要通过SNMP开始监控设备，必须执行以下步骤：
步骤1
找出您要监控的项目的 SNMP 字符串（或 OID）。
要获取SNMP字符串列表，请使用 snmpwalk 命令（net-snmp的部分软件应该在Zabbix安装时同时安装）或等效工具：
此处的“2c”代表 SNMP 版本，您也可以将其替换为“1”，表示设备上的 SNMP 版本v1。
它会返回给你一个SNMP字符串及其最后一个值的列表。如果不是，那么SNMP 'community' 可能与标准的'public'不同，在这种情况下，请找出它是什么。
然后，您可以遍历列表，直到找到要监控的字符串，例如：如果要监视通过端口3进入交换机的字节，你将使用此行中的IF-MIB :: ifInOctets.3字符串：
你现在可以使用 snmpget 命令找出'IF-MIB :: ifInOctets.3'的数字OID：
请注意，字符串中的最后一个数字是您需要监控的端口号。另请参阅：动态索引。效果如下：
.1.3.6.1.2.1.2.2.1.10.3 = Counter32: 3472126941
同样，OID 中的最后一个数字是端口号。
一些最常用的SNMP OID，Zabbix将自动转换为数字表示。
在上面的例子中，值类型是“Counter32”它在内部对应于ASN_COUNTER类型。完整的支持类型包括 ASN_COUNTER, ASN_COUNTER64, ASN_UINTEGER, ASN_UNSIGNED64, ASN_INTEGER, ASN_INTEGER64, ASN_FLOAT, ASN_DOUBLE, ASN_TIMETICKS, ASN_GAUGE, ASN_IPADDRESS, ASN_OCTET_STR 和 ASN_OBJECT_ID (从2.2.8, 2.4.3之后). 这些类型大致对应于snmpget 输出的 "Counter32", "Counter64", "UInteger32", "INTEGER", "Float", "Double", "Timeticks", "Gauge32", "IpAddress", "OCTET STRING", "OBJECT IDENTIFIER", 但也有可能显示为 "STRING", "Hex-STRING", "OID" 或者其它, 这取这取决于显示提示的表达方式。
步骤2
为设备创建一台主机 。
为主机添加 SNMP 接口：
- 输入 IP 地址/DNS 名称和端口号
- 从下拉列表中选择 SNMP 版本
- 根据所选 SNMP 版本添加接口凭据：
- SNMPv1、v2 只需要community凭据（默认值是"'public'"）
- SNMPv3 需要更具体的选项（见下文）
- 保留 使用批量请求 复选框标记以允许批量处理 SNMP 请求
| SNMPv3参数 | 说明 |
|---|---|
| 上下文名称 | 输入上下文名称以识别 SNMP 子网上的监控项。 自 Zabbix 2.2 起，SNMPv3 监控项支持上下文名称。 在此字段中解析用户宏。 |
| 安全名称 | 输入安全名称。 用户宏在此字段中解析。 |
| 安全级别 | 选择安全级别： noAuthNoPriv - 不使用身份验证或隐私协议 AuthNoPriv - 使用身份验证协议，不使用隐私协议 AuthPriv - 使用身份验证和隐私协议 |
| 身份验证协议 | 选择身份验证协议 - MD5、SHA1、SHA224、SHA256、SHA384 或 SHA512。 |
| 身份验证密码 | 输入身份验证密码。 用户宏在此字段中解析。 |
| 隐私协议 | 选择隐私协议 - DES、AES128、AES192、AES256、AES192C (Cisco) 或 AES256C (Cisco)。 |
| 隐私密码 | 输入隐私密码。 用户宏在此字段中解析。 |
如果SNMPv3凭据（安全名称，验证协议/口令，隐私协议）错误：
- · Zabbix 从 net-snmp 接收到一个 ERROR，除了错误的 Privacy passphrase 在这种情况下 Zabbix 从 net-snmp 接收到一个 TIMEOUT 错误；
- ·（自 Zabbix 6.0.13 起）SNMP 接口可用性将切换为红色（不可用）。
在不更改安全名称的情况下，对验证协议、验证口令、隐私协议或私钥的更改只有在手动清除服务器/代理上的缓存（通过使用-R snmp_cache_reload）或重新启动服务器/代理后才会生效。如果安全名称也已更改，则所有参数将立即更新。
您可以使用zabbix提供的任意 SNMP 模板（SNMP 设备模板和其他模板），该模板将自动添加监控项。但是，那模板可能与主机不兼容。点击 “添加” 保存主机。
步骤 3
创建一个监控项。
所以现在回到Zabbix并点击前面创建的SNMP主机的 监控项 。 如果你在创建主机时选择使用模板，你将拥有与主机相关联的SNMP监控项列表。我们假设你要使用snmpwalk和snmpget采集的信息创建监控项，单击 创建监控项。在新的监控项表单中：
- 输入监控项"名称"。
- 将"类型"字段更改为"SNMP客户端"
- 输入“键值”为有意义的内容，例如，SNMP-InOctets-Bps。
- 确保“主机接口”字段中有你的交换机/路由器
- 将你之前检索到的文本或数字OID输入到'SNMP OID'字段中，例如：.1.3.6.1.2.1.2.2.1.10.3
- 将“信息类型”设置为 浮点数
- 如果你希望“更新间隔”和“历史数据保留时长”与默认值不同，请选择一个自定义乘数（如果需要），并输入数值
- 在进程预处理选项卡中，添加 Change per second 步骤（重要！，否则您将从 SNMP 设备获取累积值，而不是差异值）。
所有必填字段都标有红色星号。
现在保存监控项，进入 监测中 → 最新数据 来获取你的SNMP数据!
示例 1
通用示例：
| 参数 | 描述 |
|---|---|
| OID | 1.2.3.45.6.7.8.0 (or .1.2.3.45.6.7.8.0) |
| 键值 | 用作触发器引用的唯一字符串> 例如, "my_param". |
请注意，OID 可以以数字或字符串形式给出。但是，在某些情况下，必须将字符串 OID 转换为数字表示。实用程序 snmpget 可用于此目的：
shell> snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0
示例 2
监控正常运行时间：
| 参数 | 说明 |
|---|---|
| OID | MIB::sysUpTime.0 |
| Key | router.uptime |
| Value type | 浮点数 |
| Units | uptime |
| Multiplier | 0.01 |
| Preprocessing step: Custom multiplier | 0.01 |
Native SNMP bulk requests
The walk[OID1,OID2,...] item allows to use native SNMP functionality for bulk requests (GetBulkRequest-PDUs), available in SNMP versions 2/3.
A GetBulk request in SNMP executes multiple GetNext requests and returns the result in a single response. This may be used for regular SNMP items as well as for SNMP discovery to minimize network roundtrips.
The SNMP walk[OID1,OID2,...] item may be used as the master item that collects data in one request with dependent ityems that parse the response as needed using preprocessing.
Note that using native SNMP bulk requests is not related to the option of combining SNMP requests, which is Zabbix own way of combining multiple SNMP requests (see next section).
批量处理的内部工作原理
从 Zabbix server和proxy 2.2.3 版本开始查询 SNMP 设备开始在一个请求获取多个值。这会影响几种类型的 SNMP监控项：
具有相同参数的单个接口上的所有SNMP监控项都将同时进行查询。前两种类型的监控项由轮询器分批采集，最多128个监控项，而低级发现规则如前所述单独处理。
在较低级别上，执行查询值的操作有两种：获取多个指定对象和游历OID树。
对于"getting"，GetRequest-PDU最多使用128个变量绑定。 对于"walking"，GetNextRequest-PDU用于SNMPv1和GetBulkRequest，"max-repetitions"字段最多128个用于SNMPv2和SNMPv3。
因此，每个SNMP监控项类型的批量处理的优势如下：
- 常规SNMP监控项受益于“getting” 的改进;
- 具有动态索引的SNMP监控项受益于“getting”和“walking”改进：“getting”用于索引验证，“walking”用于构建缓存;
- SNMP低级发现规则受益于“walking”的改进。 然而，有一个技术问题，并非所有设备都能够根据请求返回128个值。有些总是给出正确的回应，其它情况则会以“tooBig（1）”错误做出回应，或者一旦潜在的回应超过了一定的限度，则一律不回应。
为了找到最佳数量的对象来查询给定的设备，Zabbix使用以下策略。它在请求中查询“值1”时谨慎开始。 如果成功，它会在请求中查询“值2”。 如果再次成功，则查询请求中的“值3”，并通过将查询对象的数量乘以1.5来继续，导致以下请求大小的顺序： 1, 2, 3, 4, 6, 9, 13, 19, 28, 42, 63, 94, 128。
然而，一旦设备拒绝给出适当的响应（例如，对于42个变量），Zabbix会做两件事情。
首先，对于当前批量监控项，它将单个请求中的对象数减半，并查询21个变量。 如果设备处于活动状态，那么查询应该在绝大多数情况下都有效，因为已知28个变量可以工作，21个变量明显少于此。 但是，如果仍然失败，那么Zabbix会逐渐回到查询值。 如果此时仍然失败，那么设备肯定没有响应，请求大小也不是问题。
Zabbix为后续批量监控项做的第二件事是它从最后成功的变量数量开始（在我们的示例中为28），并继续将请求大小递增1，直到达到限制。 例如，假设最大响应大小为32个变量，后续请求的大小为29,30,31,32和33。最后一个请求将失败，Zabbix将永远不再发出大小为33的请求。 从那时起，Zabbix将为该设备查询最多32个变量。
如果大型查询因此数量的变量而失败，则可能意味着两件事之一。 设备用于限制响应大小的确切标准无法知晓，但我们尝试使用变量数来近似。 因此，第一种可能性是，在一般情况下，此数量的变量大约是设备的实际响应大小限制：有时响应小于限制，有时它大于限制。 第二种可能性是任何方向的UDP数据包都丢失了。 由于这些原因，如果Zabbix查询失败，它会减少最大数量的变量以尝试深入到设备的舒适范围，但（从2.2.8开始）最多只能达到两次。
在上面的示例中，如果包含32个变量的查询失败，Zabbix会将计数减少到31.如果发生这种情况也会失败，Zabbix也会将计数减少到30。但是，Zabbix不会将计数减少到30以下， 因为它会假设进一步的失败是由于UDP数据包丢失，而不是设备的限制。
但是，如果设备由于其他原因无法正确处理批量请求，并且上述启发式方法不起作用，Zabbix 2.4版本之后每个接口都有“使用批量请求”设置，允许禁用该设备的批量请求。