配置 Zabbix 通过 SNMP 监控 Yeastar P 系列 IPPBX

1. 在 主机名称 栏，填写一个名称，帮助你识别该主机。在本例中，填写 P-Series PBX。
2. 在 群组 栏，填写现有的群组名称，或者点击 选择 选择群组。
3. 在 接口 栏，添加主机。
   1. 点击 添加，选择 SNMP，然后完成以下设置：

      

      设置	说明
      IP 地址	填写 PBX 的 IP 地址。在本例中，填写 192.168.28.39。
      端口	填写 PBX 上配置的 SNMP 查询端口。在本例中，保留默认的 161。
      SNMP 版本	选择 SNMPv3。
      安全名称	填写 PBX 上配置的 SNMPv3 用户名。在本例中，填写 yeastardemo。
      安全级别	选择 PBX 上配置的认证方式。 noAuthNoPriv：此项即 PBX 上的 NoAuth。 authNoPriv：此项即 PBX 上的 Auth。 如果选择此项，你需要设置 验证协议 为 MD5，并填写验证口令。 authPriv：此项即 PBX 上的 Priv。 如果选择此项，你需要设置 验证协议 为 MD5， 设置 隐私协议 为 DES，并填写验证口令和私钥。 在本例中，选择 noAuthNoPriv。

   2. 可选： 若要启用 SNMP trap，重复 步骤 i 添加另一个主机接口。
      注： 该接口除端口外，其余配置与前一个主机接口相同。端口需与 PBX 上配置的 SNMP Trap 端口一致 (路径：系统 > SNMP > SNMP Trap > 端口)。

      

主机添加成功。你可以在 主机 列表查看新建的主机。

1. 通过 SSH 访问 PBX。
2. 执行 tcpdump -i any udp port 162 -vv -X，抓取 SNMP trap。
3. 触发一个 Trap 事件。

   例如，关闭某个已登录分机的网页。

4. 在抓包结果中，找到包含 ScopedPDU E 的行，复制其值，去掉所有下划线，并保存以供后续使用。

   在本例中，返回 ScopedPDU E=_80_00_1f_88_80_bd_69_d0_29_ad_d7_c4_69_00_00_00_00。我们保存的值为 80001f8880bd69d029add7c46900000000。

1. 执行 vi /etc/snmp/snmptrapd.conf，编辑 snmptrapd 配置文件。
2. 按 i 进入编辑模式。
3. 复制以下内容，将变量替换为实际值，然后执行命令。

   # 禁用认证检查 (接受所有 Trap)
   disableAuthorization yes
   
   # 以前台模式运行，不在后台运行
   doNotFork yes
   
   # 监听 SNMP Trap 端口
   snmpTrapdAddr udp:{trap_port}
   
   # 忽略认证失败消息
   ignoreAuthFailure yes
   
   # 允许 SNMPv3 用户处理 Trap
   authUser log,execute
   
   # 使用指定的 engine ID 创建 SNMPv3 用户
   createUser -e 0x{engine_id} {username}
   
   # 将所有 Trap 转发到 Zabbix 处理脚本
   traphandle default /bin/bash /usr/sbin/zabbix_trap_handler.sh

   在本例中，粘贴以下内容：

   # 禁用认证检查 (接受所有 Trap)
   disableAuthorization yes
   
   # 以前台模式运行，不在后台运行
   doNotFork yes
   
   # 监听 SNMP Trap 端口
   snmpTrapdAddr udp:162
   
   # 忽略认证失败消息
   ignoreAuthFailure yes
   
   # 允许 SNMPv3 用户处理 Trap
   authUser log,execute
   
   # 使用指定的 engine ID 创建 SNMPv3 用户
   createUser -e 0x80001f8880bd69d029add7c46900000000 yeastardemo
   
   # 将所有 Trap 转发到 Zabbix 处理脚本
   traphandle default /bin/bash /usr/sbin/zabbix_trap_handler.sh

4. 按 Esc，输入 :wq，然后按 Enter 保存并退出。

1. 执行 vi /usr/sbin/zabbix_trap_handler.sh 编辑脚本。
2. 按 i 进入编辑模式。
3. 复制以下内容，将变量替换为实际值，然后执行命令。

   #!/bin/bash
   
   ZABBIX_TRAPS_FILE="{directory_for_snmp_trap_logs}"
   
   ZBX_SNMP_TRAP_DATE_FORMAT=${ZBX_SNMP_TRAP_DATE_FORMAT:-"+%Y%m%d.%H%M%S"}
   
   ZBX_SNMP_TRAP_FORMAT=${ZBX_SNMP_TRAP_FORMAT:-"\n"}
   
   ZBX_SNMP_TRAP_USE_DNS=${ZBX_SNMP_TRAP_USE_DNS:-"false"}
   
   date=$(date "$ZBX_SNMP_TRAP_DATE_FORMAT")
   
   # The name of the host that sent the notification, as determined by gethostbyaddr(3).
   # In fact this line is irrelevant and useless since snmptrapd basically attempts to
   # perform reverse name lookup for the transport address (see below).
   # In case of failure it will print "<UNKNOWN>"
   read host
   # The transport address, like "[UDP: [172.16.10.12]:23456->[10.150.0.8]]"
   read sender
   # The first OID should always be SNMPv2-MIB::sysUpTime.0
   #read uptime
   # the second should be SNMPv2-MIB::snmpTrapOID.0
   #read trapoid
   
   # The remaining lines will contain the payload varbind list. For SNMPv1 traps, the final OID will be SNMPv2-MIB::snmpTrapEnterprise.0.
   vars=
   while read oid val
   do
       if [ "$vars" = "" ]
       then
           vars="$oid = $val"
       else
           vars="$vars$ZBX_SNMP_TRAP_FORMAT$oid = $val"
       fi
   
       if [[ "$oid" =~ snmpTrapAddress\.0 ]] || [[ "$oid" =~ 1\.3\.6\.1\.6\.3\.18\.1\.3\.0 ]]; then
           trap_address=$val
       fi
   done
   
   [[ ${sender} =~ \[(.*?)\].*\-\> ]] && sender_addr=${BASH_REMATCH[1]}
   
   ! [ -z $trap_address ] && sender_addr=$trap_address
   
   [[ "$ZBX_SNMP_TRAP_USE_DNS" == "true" ]] && ! [[ ${host} =~ \[(.*?)\].*\-\> ]] && sender_addr=$host
   
   # Header in Zabbix format shouldn't exist anywhere in vars, it is injection
   # Must exit with 0
   date_regex=$(echo "$ZBX_SNMP_TRAP_DATE_FORMAT" | sed -e 's/^+//g' \
           -e 's/%Y/[0-9]\{4\}/g' \
           -e 's/%m/[0-9]\{2\}/g' \
           -e 's/%d/[0-9]\{2\}/g' \
           -e 's/%T/[0-9]\{2\}:[0-9]\{2\}:[0-9]\{2\}/g' \
           -e 's/%z/[\+\-][0-9]\{4\}/g' \
           -e 's/%H/[0-9]\{2\}/g' \
           -e 's/%M/[0-9]\{2\}/g' \
           -e 's/%S/[0-9]\{2\}/g')
   
   zbx_trap_regex="$date_regex ZBXTRAP"
   echo "$vars" | grep -qE "$zbx_trap_regex" && exit 0
   
   echo -e "$date ZBXTRAP $sender_addr$ZBX_SNMP_TRAP_FORMAT$sender$ZBX_SNMP_TRAP_FORMAT$vars" >> $ZABBIX_TRAPS_FILE

   在本例中，粘贴以下内容：

   #!/bin/bash
   
   ZABBIX_TRAPS_FILE="/var/log/snmptrap/snmptrap.log"
   
   ZBX_SNMP_TRAP_DATE_FORMAT=${ZBX_SNMP_TRAP_DATE_FORMAT:-"+%Y%m%d.%H%M%S"}
   
   ZBX_SNMP_TRAP_FORMAT=${ZBX_SNMP_TRAP_FORMAT:-"\n"}
   
   ZBX_SNMP_TRAP_USE_DNS=${ZBX_SNMP_TRAP_USE_DNS:-"false"}
   
   date=$(date "$ZBX_SNMP_TRAP_DATE_FORMAT")
   
   # The name of the host that sent the notification, as determined by gethostbyaddr(3).
   # In fact this line is irrelevant and useless since snmptrapd basically attempts to
   # perform reverse name lookup for the transport address (see below).
   # In case of failure it will print "<UNKNOWN>"
   read host
   # The transport address, like "[UDP: [172.16.10.12]:23456->[10.150.0.8]]"
   read sender
   # The first OID should always be SNMPv2-MIB::sysUpTime.0
   #read uptime
   # the second should be SNMPv2-MIB::snmpTrapOID.0
   #read trapoid
   
   # The remaining lines will contain the payload varbind list. For SNMPv1 traps, the final OID will be SNMPv2-MIB::snmpTrapEnterprise.0.
   vars=
   while read oid val
   do
       if [ "$vars" = "" ]
       then
           vars="$oid = $val"
       else
           vars="$vars$ZBX_SNMP_TRAP_FORMAT$oid = $val"
       fi
   
       if [[ "$oid" =~ snmpTrapAddress\.0 ]] || [[ "$oid" =~ 1\.3\.6\.1\.6\.3\.18\.1\.3\.0 ]]; then
           trap_address=$val
       fi
   done
   
   [[ ${sender} =~ \[(.*?)\].*\-\> ]] && sender_addr=${BASH_REMATCH[1]}
   
   ! [ -z $trap_address ] && sender_addr=$trap_address
   
   [[ "$ZBX_SNMP_TRAP_USE_DNS" == "true" ]] && ! [[ ${host} =~ \[(.*?)\].*\-\> ]] && sender_addr=$host
   
   # Header in Zabbix format shouldn't exist anywhere in vars, it is injection
   # Must exit with 0
   date_regex=$(echo "$ZBX_SNMP_TRAP_DATE_FORMAT" | sed -e 's/^+//g' \
           -e 's/%Y/[0-9]\{4\}/g' \
           -e 's/%m/[0-9]\{2\}/g' \
           -e 's/%d/[0-9]\{2\}/g' \
           -e 's/%T/[0-9]\{2\}:[0-9]\{2\}:[0-9]\{2\}/g' \
           -e 's/%z/[\+\-][0-9]\{4\}/g' \
           -e 's/%H/[0-9]\{2\}/g' \
           -e 's/%M/[0-9]\{2\}/g' \
           -e 's/%S/[0-9]\{2\}/g')
   
   zbx_trap_regex="$date_regex ZBXTRAP"
   echo "$vars" | grep -qE "$zbx_trap_regex" && exit 0
   
   echo -e "$date ZBXTRAP $sender_addr$ZBX_SNMP_TRAP_FORMAT$sender$ZBX_SNMP_TRAP_FORMAT$vars" >> $ZABBIX_TRAPS_FILE
   

4. 按 Esc，输入 :wq，然后按 Enter 保存并退出。

授予 Bash 接收脚本执行权限。

chmod +x /usr/sbin/zabbix_trap_handler.sh

grep "traphandle" /etc/snmp/snmptrapd.conf

如果返回结果为 traphandle default /usr/sbin/zabbix_trap_handler.sh 或 traphandle default /bin/bash /usr/sbin/zabbix_trap_handler.sh，则表示配置正确。

• 方法 1：作为系统服务重启 snmptrapd

  systemctl restart snmptrapd

• 方法 2：停止 snmptrapd 并手动启动

  kill -9 $(pidof snmptrapd)
  snmptrapd -f -Lo -n -c /etc/snmp/snmptrapd.conf

ss -unlp | grep {port}

在本例中，执行以下命令：

ss -unlp | grep 162

如果返回结果中包含 snmptrapd 和 :162，则表示该服务正在正常监听该端口。

1. 配置 Zabbix 以启用 trap 接收功能。
   1. 执行 vi /etc/zabbix/zabbix_server.conf，编辑 Zabbix 配置文件。
   2. 按 i 进入编辑模式。
   3. 添加或更新以下参数：

      # 在 Zabbix 服务器中启用 SNMP trap 处理
      StartSNMPTrapper=1
      
      # 定义传入 trap 的日志文件路径
      SNMPTrapperFile={directory_for_snmp_trap_logs}

      在本例中，更新以下内容：

      # 在 Zabbix 服务器中启用 SNMP trap 处理
      StartSNMPTrapper=1
      
      # 定义传入 trap 的日志文件路径
      SNMPTrapperFile=/var/log/snmptrap/snmptrap.log

   4. 按 Esc，输入 :wq，然后按 Enter 保存并退出。
2. 重启 Zabbix 以应用配置。

   systemctl restart zabbix-server

1. 在左侧导航栏，进入 配置 > 主机。
2. 点击主机旁边的 监控项。

   

3. 在页面右上角，点击 创建监控项。
4. 完成以下配置。

   

   配置	说明
   名称	填写一个名称，用于识别该监控项。 在本例中，填写 PBXTrapData。
   类型	选择 SNMP 代理。
   键值	填写该监控项的唯一键值。 在本例中，填写 snmptrap.fallback。
   主机接口	选择用于 SNMP trap 的主机接口。
   信息类型	选择 日志。
   日志时间格式	指定用于解析日志时间戳的格式。 在本例中，填写 yyyyMMdd.hhmmss。

5. 点击 添加。

1. 在页面顶部，点击 所有主机，返回主机列表。

   

2. 点击主机旁边的 触发器。
3. 在页面右上角，点击 创建触发器。
4. 完成以下配置。

   

   配置	说明
   名称	填写一个名称，用于识别该触发器。在本例中，填写 ExtensionDown。
   表达式	设置用于检测 SNMP trap 事件的条件。 在本例中，填写 find(/P-Series PBX/snmptrap.fallback,,"like","pIPphoneDown")=1 or find(/P-Series PBX/snmptrap.fallback,,"like","pExtDown")=1。

5. 点击 添加。

1. 在左侧导航栏，进入 监测 > 最新数据。
2. 搜索目标主机。
3. 点击 SNMP Trap 监控项旁边的 历史记录。

   如果配置成功，底部面板会显示接收到的 Trap 消息。

   

你可以查看监控项对应的最新数据。