3 SNMP trap

概述

接收SNMP trap与查询启用SNMP的设备相反。

在这种情况下，信息发送自启用SNMP的设备并由Zabbix收集或"trapped"。

通常在某些条件更改时发送trap，并且代理通过端口162连接到服务器（相反的，代理端的161端口是用于查询代理的）。 使用trap可以检测在查询间隔期间发生的一些可能被查询数据遗漏的短期问题。

在Zabbix中接收SNMP trap旨在使用snmptrapd和内置机制之一来传递trap到Zabbix - 一个perl脚本或SNMPTT。

接收trap的工作流程：

1. snmptrapd 收到trap
2. snmptrapd将trap传递给SNMPTT或调用Perl trap接收器
3. SNMPTT或Perl trap接收器解析，格式化并将trap写入文件
4. Zabbix SNMP trap读取并解析trap文件
5. 对于每个trap，Zabbix发现主机接口与接收的trap地址匹配的所有“SNMP trap”监控项。请注意，在匹配期间只使用主机接口中选定的“IP”或“DNS”。
6. 对于每个找到的监控项，将trap与“snmptrap[regexp]”中的regexp进行比较。 trap设置为all匹配项的值。如果没有找到匹配的监控项，并且有一个“snmptrap.fallback”监控项，则将trap设置为该监控项的值。
7. 如果trap未设置为任何监控项的值，Zabbix默认记录未匹配的trap。（通过管理 → 常规 → 其它中的“记录未匹配的SNMP trap（Log unmatched SNMP traps）”进行配置。）

1 配置SNMP trap

在前端页面中配置此监控项类型的以下字段：

  * 你的主机必须具有SNMP接口

在 配置→主机 中，在主机接口字段中设置具有正确IP或DNS地址的SNMP接口。将每个收到的trap的地址与所有SNMP接口的IP和DNS地址进行比较，以查找相应的主机。

  * 配置监控项

在Key字段中使用一个SNMP trap Key：

将要解析的时间戳的信息类型设置为'Log'。 请注意，其它格式（如“数字”）也是可以接受的，但可能需要自定义trap处理程序。

2 设置SNMP trap监控

配置 Zabbix 服务器/代理服务器

要读取trap，必须将Zabbix服务器或代理服务器配置为启动SNMP trap进程，并指向由SNMPTT或perl trap接收器写入的trap文件。为此，请编辑配置文件(zabbix_server.conf 或者 zabbix_proxy.conf)：

1. StartSNMPTrapper=1
2. SNMPTrapperFile=[TRAP FILE]

<note warning>如果使用systemd参数PrivateTmp，则该文件不太可能在/tmp下使用。 :::

配置SNMPTT

首先，snmptrapd应该配置为使用SNMPTT。

<note tip>为了获得最佳性能，应将SNMPTT配置为使用snmptthandler-embedded的守护进程，并将trap传递给它。有关SNMPTT的配置，请查看其主页上的说明：
http://snmptt.sourceforge.net/docs/snmptt.shtml :::

当SNMPTT配置为接收trap时，配置SNMPTT记录trap：

1. 将trap记录到Zabbix将读取的trap文件中：
   log_enable = 1
   log_file = [TRAP FILE]
2. 设置日期时间格式：
   date_time_format = %H:%M:%S %Y/%m/%d = [DATE TIME FORMAT]

现在格式化Zabbix的trap来识别它们（编辑snmptt.conf）：

1. 每个FORMAT语句应以“ZBXTRAP [address]”开头，其中[address]将与Zabbix上SNMP接口的IP地址和DNS地址进行比较。例如:
   EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal
   FORMAT ZBXTRAP $aA Device reinitialized (coldStart)
2. 请参阅下面的SNMP trap格式说明，了解更多信息。

配置 Perl trap 接收器

要求：Perl，Net-SNMP使用--enable-embedded-perl编译（默认情况下从Net-SNMP 5.4支持）

Perl trap接收器（查找misc/snmptrap/zabbix_trap_receiver.pl）可以直接从snmptrapd将trap传递给Zabbix服务器。配置过程:

• 将perl脚本添加到snmptrapd配置文件（snmptrapd.conf）中，例如：
  perl do "[FULL PATH TO PERL RECEIVER SCRIPT]";
• 配置接收器, 例如:
  $SNMPTrapperFile = '[TRAP FILE]';
  $DateTimeFormat = '[DATE TIME FORMAT]';

SNMP trap 格式

所有定制的perl trap接收器和SNMPTT trap配置必须按以下方式格式化trap： [timestamp] [the trap, part 1] ZBXTRAP [address] [the trap, part 2], 说明

• [timestamp] - 用于日志监控项的时间戳
• ZBXTRAP - 头表示新的trap从此行开始
• [address] - 用于查找此trap的主机的IP地址

注意，“ZBXTRAP”和“[address]”将在处理过程中从消息中删除。如果trap格式化为其它方式，Zabbix也许能意外的解析trap。

trap示例:
11:30:15 2011/07/27 .1.3.6.1.6.3.1.1.5.3 Normal "Status Events" localhost - ZBXTRAP 192.168.1.1 Link down on interface 2. Admin state: 1. Operational state: 2
This will result in the following trap for SNMP interface with IP=192.168.1.1:
11:30:15 2011/07/27 .1.3.6.1.6.3.1.1.5.3 Normal "Status Events" localhost - Link down on interface 2. Admin state: 1.

3 系统要求

大文件支持

Zabbix为SNMP trap文件提供了“大文件支持”。Zabbix可以读取的最大文件大小为2^63（8 EiB）。请注意，文件系统可能会对文件大小施加下限。

日志轮换

Zabbix不提供任何日志轮换系统（它应由用户处理）。 日志轮换应该首先重命名旧文件，然后才能将其删除，以免丢失trap：

1. Zabbix在最后一个已知位置打开trap文件，并转到步骤3
2. Zabbix通过比较inode号和定义trap文件的inode号，检查当前打开的文件是否已经旋转。如果没有打开的文件，Zabbix将重置最后一个位置并转到步骤1。
3. Zabbix从当前打开的文件中读取数据并设置新的位置。
4. 新数据被解析。如果这是旋转的文件，文件将关闭并返回到步骤2。
5. 如果没有新的数据，Zabbix sleep 1秒钟，然后回到步骤2。

文件系统

由于Trap文件的执行，Zabbix需要文件系统支持inode来区分文件（该信息由stat()调用获取）。

4 设置示例

本示例使用snmptrapd + SNMPTT将陷阱传递给Zabbix服务器。设置：

1. zabbix_server.conf - 配置Zabbix启动SNMP trap并设置trap文件：
   StartSNMPTrapper=1
   SNMPTrapperFile=/tmp/my_zabbix_traps.tmp
2. snmptrapd.conf - 添加SNMPTT作为trap处理程序：
   traphandle default snmptt
3. snmptt.ini - 配置输出文件和时间格式：
   log_file = /tmp/my_zabbix_traps.tmp
   date_time_format = %H:%M:%S %Y/%m/%d
4. snmptt.conf - 定义默认trap格式：
   EVENT general .* "General event" Normal
   FORMAT ZBXTRAP $aA $ar
5. 创建一个SNMP监控项测试：
   Host's SNMP interface IP: 127.0.0.1
   Key: snmptrap["General"]
   Log time format: hh:mm:ss yyyy/MM/dd

结果如下：

1. 用于发送trap的命令：
   snmptrap -v 1 -c public 127.0.0.1 '.1.3.6.1.6.3.1.1.5.3' '0.0.0.0' 6 33 '55' .1.3.6.1.6.3.1.1.5.3 s "teststring000"
2. 接收到的trap:
   15:48:18 2011/07/26 .1.3.6.1.6.3.1.1.5.3.0.33 Normal "General event" localhost - ZBXTRAP 127.0.0.1 127.0.0.1
3. 测试监控项的值:
   15:48:18 2011/07/26 .1.3.6.1.6.3.1.1.5.3.0.33 Normal "General event" localhost - 127.0.0.1

<note tip>这个简单的例子使用SNMPTT作为traphandle。为了在生产系统上获得更好的性能，请使用嵌入式Perl将trap从snmptrapd传递到SNMPTT或直接传递到Zabbix。 :::

5 请参阅

• 来自zabbix.org的基于CentOS的SNMP trap教程

Log rotation

Zabbix does not provide any log rotation system - that should be handled by the user. The log rotation should first rename the old file and only later delete it so that no traps are lost:

1. Zabbix opens the trap file at the last known location and goes to step 3
2. Zabbix checks if the currently opened file has been rotated by comparing the inode number to the define trap file's inode number. If there is no opened file, Zabbix resets the last location and goes to step 1.
3. Zabbix reads the data from the currently opened file and sets the new location.
4. The new data are parsed. If this was the rotated file, the file is closed and goes back to step 2.
5. If there was no new data, Zabbix sleeps for 1 second and goes back to step 2.

File system

Because of the trap file implementation, Zabbix needs the file system to support inodes to differentiate files (the information is acquired by a stat() call).

6 Setup example

This example uses snmptrapd + SNMPTT to pass traps to Zabbix server. Setup:

1. zabbix_server.conf - configure Zabbix to start SNMP trapper and set the trap file:
   StartSNMPTrapper=1
   SNMPTrapperFile=/tmp/my_zabbix_traps.tmp
2. snmptrapd.conf - add SNMPTT as the trap handler:
   traphandle default snmptt
3. snmptt.ini -
   enable the use of the Perl module from the NET-SNMP package:
   net_snmp_perl_enable = 1
   configure output file and time format:
   log_file = /tmp/my_zabbix_traps.tmp
   date_time_format = %H:%M:%S %Y/%m/%d
4. snmptt.conf - define a default trap format:
   EVENT general .* "General event" Normal
   FORMAT ZBXTRAP $aA $ar
5. Create an SNMP item TEST:
   Host's SNMP interface IP: 127.0.0.1
   Key: snmptrap["General"]
   Log time format: hh:mm:ss yyyy/MM/dd

This results in:

1. Command used to send a trap:
   snmptrap -v 1 -c public 127.0.0.1 '.1.3.6.1.6.3.1.1.5.3' '0.0.0.0' 6 33 '55' .1.3.6.1.6.3.1.1.5.3 s "teststring000"
2. The received trap:
   15:48:18 2011/07/26 .1.3.6.1.6.3.1.1.5.3.0.33 Normal "General event" localhost - ZBXTRAP 127.0.0.1 127.0.0.1
3. Value for item TEST:
   15:48:18 2011/07/26 .1.3.6.1.6.3.1.1.5.3.0.33 Normal "General event" localhost - 127.0.0.1

7 See also

• Zabbix blog article on SNMP traps
• CentOS based SNMP trap tutorial on zabbix.org