第三方平台告警接入、翻译、关联恢复

原创 Zabbix开源社区 Zabbix开源社区 9月28日

收录于话题#Zabbix官方博文17个内容

点击了解 不粘“锅”秘籍！

感谢宏时数据技术经理王军投稿！

第1章 简介

1.1 说明

本文档描述了如何通过SNMPTT，将中兴云桌面以及中兴云桌面存储SnmpTrap告警接入Zabbix，并对产生的告警汉化翻译，通过Zabbix标签功能实现自动关联恢复告警。

1.2 环境

组件版本描述RedHat7.5操作系统版本SNMPTT1.4.2SNMP Trap Translator处理SNMPTRAPzabbix5.0.5zabbix 5.0.5net-snmp5.7.2提供snmptrapd服务ZXCLOUD7.01.01.P878中心云桌面应用平台

中兴云桌面平台

第2章 接入中兴云桌面平台SNMPTRAP2.1 导入ZTE桌面平台MIB

net-snmp组件默认只提供了通用的MIB文件，第三方私有MIB文件需要自行导入并配置搜索解析。

1. 创建自定义MIB目录

# mkdir /usr/share/snmp/mibs/ZTE/# ls -l /usr/share/snmp/mibs/ZTE/total 60-rw-r--r-- 1 root root   907 Feb  9  2012 ZTE-IRP-MIB-rw-r--r-- 1 root root 46864 Mar 23  2012 zxcomc-snmp-alarmirp-mib-v1.1.txt-rw-r--r-- 1 root root  2962 Feb  9  2012 zxcomc-snmp-csirp-mib.txt-rw-r--r-- 1 root root   907 Feb  9  2012 zxcomc-snmp-irp-common-mib.txt

2. 配置net-snmp加载自定义mib

#查看系统snmp模块默认加载配置路径# net-snmp-config --snmpconfpath#自定义第三方mib搜索目录# cat /usr/local/net-snmp/snmp.conf mibdirs +/usr/share/snmp/mibs/ZTE#测试自定义地示范mib搜索是否正常# snmptranslate -Dinit_mib .1.3 2>&1 |grep MIBDIR# snmptranslate -On ZTE-ALARM-IRP-MIB::alarmCleared

解析第三方MIB

2.2 转换MIB文件

MIB(SNMPTRAP)文件中定义了各种SNMPTRAP的通知信息，SNMPTT中可以使用工具snmpttconvertmib将所有包含snmp trap/notification信息的mib文件转换成相应的snmptt.conf.<vendor>文件,来实现SNMPTRAP信息的解析。

转换mib命令格式：

# snmpttconvertmib --in=path-to-mib --out=output-file-name –net_snmp_perl

提示: 转换结果会追加到output-file-name定义的文件中

由于snmpttconvertmib不支持批量转换，可能需要通过脚本来进行批量转换。

# for f in $(grep -l -i "notification" ./*);do snmpttconvertmib -in="$f" -out=/tmp/snmptt.conf.zte --net_snmp_perl;done;

mib转换结果报告

初始化转换后的配置文件

# sed  -r -i "s/^(FORMAT)/\1 ZBXTRAP \$aA/g" snmptt.conf.zte# grep "FORMAT" snmptt.conf.zte  

FORMAT行语法($aA会解析成IP)

每个 FORMAT 行都需要添加ZBXTRAP，否则ZABBIX无法解析,关于SNMPTT更多用法,请参考官方文档

2.3 追加新增conf配置

将自定义转换的conf文件追加到SNMPTT配置文件中

# vim /etc/snmp/snmptt.ini[TrapFiles]# A list of snmptt.conf files (this is NOT the snmptrapd.conf file).  The COMPLETE path # and filename.  Ex: '/etc/snmp/snmptt.conf'snmptt_conf_files = <<END/etc/snmp/snmptt.conf/etc/snmp/snmptt.conf.zteEND

# systemctl restart snmptt

SNMPTRAP模板

提示：为了能够很快看到效果，创建了“snmptrap[]”不过滤任何关键字的监控项

2.6 创建监控实例

创建SNMPTRAP实例

关联监控模板

提示：主机名称要和snmptt.conf.zte中定义的内置变量$aA保持一致

2.7 查看最新数据

SNMPTRAP最新数据

至此，就完成了如何通过SNMPTT将第三方平台的SNMPTRAP信息集成到Zabbix的操作步骤。

在实际环境中，由于某些需求或者通过转换后的规则，SNMPTRAP信息可读性依然不高。例如：TRAP信息是全英文或者应用平台对TRAP信息进行了编码。

经过编码的SNMPTRAP信息

通过SNMPTT规则配置文件的EXEC和PREXEC属性，可以实现SNMPTRAP信息的汉化翻译或者解码(在应用案例中实现)等。根据MIB或转换后配置文件的描述，可以看出最新数据中的trap信息属于平台组件之间的心跳探测信息。

ZTE云桌面平台心跳TRAP信息描述

2.8 汉化翻译SNMPTRAP

1. 编辑配置文件，汉化相关oid信息

# vim /etc/snmp/snmptt.conf.zteEVENT heartbeatNotification .1.3.6.1.4.1.3902.4101.4.2.1.1 "Status Events" NormalFORMAT ZBXTRAP $aA "中兴云桌面平台-NMS系统与北向网管心跳检查，heartbeatNotification:$1"SDESC

2. 重启SNMPTT

# systemctl restart snmptt

3. 查看汉化后的信息

经过翻译的信息

4. 创建触发器

根据trap描述，心跳trap设置值0代表不发送心跳trap。设置值超过300不生效。如果没有最新数据则代表心跳异常，触发告警。

5. 触发SNMPTRAP告警

心跳异常告警

2.9 修改SNMPTRAP日志级别

1. 通过snmpttconvertmib工具转换后的trap日志事件，格式如下：

EVENT event_name event_OID "category" severityFORMAT format_string[EXEC command_string][NODES sources_list][MATCH [MODE=[or | and]] | [$n:[!][(    ) | n | n-n | > n][SDESC][EDESC]

通过修改severity，可以将需要关注的日志级别调高，例如：Critical，然后通过触发器函数regexp ()匹配对应严重性级别的日志。例如：

EVENT heartbeatNotification .1.3.6.1.4.1.3902.4101.4.2.1.1 "Status Events" CriticalFORMAT ZBXTRAP $aA "中兴云桌面平台-NMS系统与北向网管心跳检查，$N:$1"

2. 创建指定事件级别触发器

创建指定事件类型的严重性触发器

3. 按照事件严重性触发告警

按照事件严重性触发告警

至此，完成了通过修改SNMPPT配置规则，来实现SNMPTRAP事件的汉化翻译和事件级别的调整。

2.10 SNMPTRAP恢复事件关联

对于周期性的SNMPTRAP信息，例如:平台组件之间的心跳TRAP。不存在恢复事件，只能通过有无数据来判断是否正常,实现告警恢复。

对于平台故障alarmNew信息，例如：磁盘读写异常,主机离线等。如果连续出现多条告警，新的TRAP事件就会将上一条TRAP事件信息冲掉，导致上一条告警被恢复。

如何防止事件被恢复或者通过相关恢复事件自动恢复？

1. 防止事件被恢复

如果事件严重性较高，或者由于特定需求不允许被恢复。可以通过创建模板或者主机宏变量**{$TRAPCONTORL}=1来实现。

防止事件被恢复

最新数据

不允许被恢复的事件

2. 通过恢复事件自动恢复已触发的告警

平台故障类事件和恢复事件，通常会在TRAP事件位置变量(例如：$14)中对应有一个相同alarmId。通过在Zabbix标签功能，提取事件的alarmId来实现事件的关联恢复。

# vim /etc/snmp/snmptt.conf.zte   14: alarmId     Syntax="OCTETSTR"     Descr="This object represents an alarm in EMS using                 the private format of vendor" 15: alarmCodeName     Syntax="OCTETSTR"     Descr="This object represents an alarm code name"  

中兴云桌面snmptrap告警内容是hexstring格式并通过 “gb2312”进行编码，直接对接到zabbix中可读性很差。

通过SNMPTT中”EXEC”属性，自定义外部python脚本，将SNMPTRAP信息进行转码翻译后，再将翻译后的消息写回到SNMPTrapperFile定义的文件中，实现告警事件接入ZABBIX并提升SNMPTRAP信息可读性。

通过zabbix标签功能，提取告警信息中的alarmid,实现SNMPTRAP恢复事件关联恢复操作。

中兴云桌面告警关联恢复

3.1.2 实现步骤

1. 创建解码脚本

# cat /etc/snmp/zte/translatetraptozbx.py#!/usr/bin/python# -*- coding:utf-8 -*-#version:1.0#user:jun#description: convert hex-string to string#import sysimport time# 定义日志信息logtime=time.strftime('%H:%M:%S %Y/%m/%d',time.localtime())snmptrapfile="/var/log/snmptt/snmptt.log"# 将hex转换成中文,hex to gb2312def hex_to_ascii(hex_str):  try:      hex_str = hex_str.replace('Hex-STRING', '').replace(':','').replace(' ', '').replace('0x', '').replace('\t', '').replace('\n', '')      ascii_str = hex_str.decode('hex').decode('gb2312',errors='ignore')  #except (TypeError):  except :      ascii_str = 'ZBXTRAP can not translate this message'  return ascii_str# 获取参数：IP [SNMPTRAP OIDS]，example:$aA $N $+*if len(sys.argv) >= 4:  ZBXTRAPHOST=sys.argv[1]   EVENTTYPE=sys.argv[2]  SNMPTRAPMESSAGE=''.join(sys.argv[3:])  KEYWORD='enterprises.3902.4101.1.3.1.3'  if KEYWORD in SNMPTRAPMESSAGE:      alertmessage=SNMPTRAPMESSAGE.replace('enterprises','\nenterprises').split('\n')      eventextnumber=alertmessage[1].replace('enterprises.3902.4101.1.3.1.3','').split(':')[0]      eventtime=alertmessage[1].replace('enterprises.3902.4101.1.3.1.3'+eventextnumber+':','')      eventseverity=alertmessage[9].replace('enterprises.3902.4101.1.3.1.6'+eventextnumber+':','').strip()            alarmid=alertmessage[14].strip()      # 告警等级转换      if eventseverity=='1':          severity="critical"      elif eventseverity=='2':          severity="critical"      elif eventseverity=='3':          severity="major"      elif eventseverity=='4':          severity="major"      elif eventseverity=='5':          severity="warning"      elif eventseverity=='6':          severity="cleared"      else:          severity="unknown"      eventtheme=hex_to_ascii(alertmessage[15].replace('enterprises.3902.4101.1.3.1.14'+eventextnumber+':','').replace(' ',''))      eventsource=hex_to_ascii(alertmessage[16].replace('enterprises.3902.4101.1.3.1.15'+eventextnumber+':','').replace(' ',''))            zbxtrapmessage=logtime+" ZBXTRAP "+ZBXTRAPHOST+" "+eventtime+"-"+ZBXTRAPHOST+" "+EVENTTYPE+",alarmuuid:"+alarmid+",severity:"+severity+" "+eventtheme+" "+eventsource      zbxtrapmessage2=zbxtrapmessage.encode("raw_unicode_escape").decode("raw_unicode_escape").encode("utf8")      with open(snmptrapfile,'a+') as f:          f.write(zbxtrapmessage2)          f.write("\n")          f.close()      print zbxtrapmessage2else: sys.exit()

2. 定义SNMPTRAP事件类型的格式化参数

在snmptt.conf.zte配置文件中修改ztedesktopalarmNew和ztedesktopalarmClear类型事件格式化参数

# vim /etc/snmp/snmptt.conf.zteEVENT ztedesktopalarmNew .1.3.6.1.4.1.3902.4101.1.4.1.1 "Status Events" NormalFORMAT  $aA $N "【中兴云桌面告警】$+*"REGEX(\n)()gREGEX(\(unknown\))()gREGEX(\s+)(-)g#EXEC /etc/snmp/zte/translatetraptozbx.py $aA $N $+*EVENT ztedesktopalarmCleared .1.3.6.1.4.1.3902.4101.1.4.1.2 "Status Events" NormalFORMAT  $aA $N "【中兴云桌面告警】$+*"REGEX(\n)()gREGEX(\(unknown\))()gREGEX(\s+)(-)g#EXEC /etc/snmp/zte/translatetraptozbx.py $aA $N $+*

3. 重启SNMPTT

# systemctl restart snmptt

4. 提取TRAP事件的alarmId

云桌面的SNMPTRAP信息经过了转码脚本处理，对于同一个事件ztedesktopalarmNew（告警事件）和ztedesktopalarmClear(恢复事件)类型内容，都有一个相同的alarmuuid，提取事件信息中的alarmuuid作为标签ztedesktopalarmuuid的值。

通过正则表达式提取事件Id

5. 根据触发器标签进行事件关联恢复

对已产生的SNMPTRAP事件，如果出现恢复事件(事件类型为：ztedesktopalarmClear)，则通过触发器标签来进行匹配ztedesktopalarmuuid，实现告警自动关闭。

匹配事件标签来关联恢复事件

6.实现效果

云桌面平台产生的告警

snmptt接收的告警事件内容

zabbix前端展示的告警

云桌面平台告警恢复

snmptt接收的恢复事件内容

zabbix平台显示事件已恢复

3.2 应用案例2：通过预处理翻译SNMPTRAP信息3.2.1 案例描述

中兴云分布式存储没有完整的mib文件，只提供了snmptrap事件类型的说明，根据oid描述，创建事件匹配规则。

云存储SNMPTRAP OID描述

通过SNMPTT配置规则文件中的PREEXEC属性，将事件等级(数字)转换成英文字符，将事件告警码转换成对应的中文描述。

3.2.2 实现步骤

1. 创建事件等级映射文件

# cat /etc/snmp/zte/variablemvaluemap_zte.txt#alarmPerceivedSeverityztestoragealarmSeverity-1:criticalztestoragealarmSeverity-2:seriousztestoragealarmSeverity-3:warningztestoragealarmSeverity-4:promptztestoragealarmSeverity-5:notice

2. 创建事件等级转换脚本

# cat /etc/snmp/zte/getvariablestring.sh #!/bin/bashLOGTIME=$(date "+%Y-%m-%d %H:%M:%S")zte_variables_file='/etc/snmp/zte/variablemvaluemap_zte.txt'zte_snmptt_log='/etc/snmp/zte/snmptt_preexec_zte.log'if [ $# -ne 2 ];thenexit 2fiif [ -s $zte_variables ];thenvalue=$(grep -w "$1-$2" "$zte_variables_file"|grep -v "#"|awk -F':' '{print $2}')if [ 'Z'"$value" != 'Z' ];then   echo $valueelse   echo "unknown"fielseecho "$LOGTIME zte variable map file is not found.File Format:<variabletype>:<variable>:<value>" >> $zte_snmptt_logfi#脚本需要传入两个参数:<alarmobject> <alarmseveritynumber>

3. 创建告警码说明映射文件

# cat /etc/snmp/zte/ztestorage_alarmcode.txt 100100#服务器网络网络异常#Critical100101#服务器网络网络断链#Critical100102#服务器状态下电#Critical100103#服务器状态所有存储服务离线#Critical100104#服务器状态处于维护模式#Info100105#服务器版本版本与集群版本不一致#Warning100106#服务器CPU 利用率超过 80%#Warning100107#服务器CPU 利用率超过 90%#Critical100108#服务器内存利用率超过 80%#Warning100109#服务器内存利用率超过 90%#Critical100110#服务器网络带宽利用率超过 80%#Warning100111#服务器网络带宽利用率超过 90%#Critical100114#硬盘状态离线#Critical100115#硬盘状态处于维护模式#Info100116#硬盘状态IO 读写慢#Warning100118#硬盘状态SMART 检测Critical异常#Critical100119#硬盘已用容量超过 50%#Warning100120#硬盘已用容量超过 80%#Critical100121#服务MON节点时钟未同步#Critical100122#服务MON磁盘可用空间不足#Critical100123#服务MON服务离线#Critical100129#服务MGR服务离线#Critical100130#服务AGENT服务离线#Critical100131#集群状态IO 请求异常#Critical100132#集群状态集群与管理系统连接中断#Critical100133#集群状态处于维护模式#Info100136#集群已用容量超过 50%#Warning100137#集群已用容量超过 80%#Critical100138#存储池状态存储池不可用#Critical100139#存储池状态存储池数据冗余度降级#Critical100140#存储池状态存储池数据重构中#Warning100141#存储池已用容量超过 50%#Warning100142#存储池已用容量超过 80%#Critical100143#共享设备已用容量超过 50%#Warning100144#共享设备已用容量超过 80%#Critical100145#共享设备状态共享设备状态异常#Critical100146#License有效期不足 30 天#Warning100147#License有效期不足 7 天#Critical100148#证书有效期不足 30 天#Warning100149#证书有效期不足 7 天#Critical100150#服务器状态主机名不一致#Critical100151#服务器状态主机名含有非法字符#Critical100152#服务器状态集群中主机名重复#Critical

4. 创建告警码转换脚本

# cat /etc/snmp/zte/ztestorage_transalarmcode.sh#!/bin/bashLOGTIME=$(date "+%Y-%m-%d %H:%M:%S")ztestorage_alarmcode='/etc/snmp/zte/ztestorage_alarmcode.txt'ztestorage_alarmcode_log='/etc/snmp/zte/ztestorage_alarmcode.log'if [ $# -ne 1 ];then  exit 2fiif [ -s $ztestorage_alarmcode ];then  value=$(grep -w "$1" "$ztestorage_alarmcode"|grep -v "^#"|awk -F'#' '{print $2}')  if [ 'Z'"$value" != 'Z' ];then     echo $value  else     echo "$LOGTIME zte storage alarm code is not found." >> $ztestorage_alarmcode_log  fielse  echo "$LOGTIME zte storage alarm code file is not found." >> $ztestorage_alarmcode_logfi#脚本需要传入一个参数:<alarmcode>，输出结果为告警码中文描述。

5. 定义云存储SNMPTRAP事件类型的解析参数

# cat /etc/snmp/snmptt.conf.zte# 新增中兴云桌面分布式存储trap信息EVENT ztestoragealarmNew .1.3.6.1.4.1.3902.2904.1.2.1.4.1.1 "Status Events" NormalFORMAT ZBXTRAP $ar $N "alarmuuid:$+4,severity:$p1($9),$12 $p2"PREEXEC /etc/snmp/zte/getvariablestring.sh ztestoragealarmSeverity $9PREEXEC /etc/snmp/zte/ztestorage_transalarmcode.sh $13##SDESC.1.3.6.1.4.1.3902.2904.1.2.1.4.1.1   表示 新的告警产生.1.3.6.1.4.1.3902.2904.1.2.1.4.1.2   表示 相应告警恢复.1.3.6.1.4.1.3902.2904.1.2.1.3.1.6:  告警级别，分5个等级('critical': 1,'serious': 2,'warning': 3,'prompt': 4,'notice': 5).1.3.6.1.4.1.3902.2904.1.2.1.3.1.8:  告警内容.1.3.6.1.4.1.3902.2904.1.2.1.3.1.10: 告警位置.1.3.6.1.4.1.3902.2904.1.2.1.3.1.11: 告警码.1.3.6.1.4.1.3902.2904.1.2.1.3.1.15: 告警主机hostnameEDESCEVENT ztestoragealarmClear .1.3.6.1.4.1.3902.2904.1.2.1.4.1.2 "Status Events" NormalFORMAT ZBXTRAP $ar $N "alarmuuid:$+4,severity:$p1($9),$12 $p2"##PREEXEC /etc/snmp/zte/getvariablestring.sh ztestoragealarmSeverity $9PREEXEC /etc/snmp/zte/ztestorage_transalarmcode.sh $13SDESC.1.3.6.1.4.1.3902.2904.1.2.1.4.1.1   表示 新的告警产生.1.3.6.1.4.1.3902.2904.1.2.1.4.1.2   表示 相应告警恢复.1.3.6.1.4.1.3902.2904.1.2.1.3.1.6:  告警级别，分5个等级('critical': 1,'serious': 2,'warning': 3,'prompt': 4,'notice': 5).1.3.6.1.4.1.3902.2904.1.2.1.3.1.8:  告警内容.1.3.6.1.4.1.3902.2904.1.2.1.3.1.10: 告警位置.1.3.6.1.4.1.3902.2904.1.2.1.3.1.11: 告警码.1.3.6.1.4.1.3902.2904.1.2.1.3.1.15: 告警主机hostnameEDESC

6. 重启SNMPTT

# systemctl restart snmptt

7. 提取TRAP事件信息的alarmId

云存储的SNMPTRAP信息经过了预处理后写入snmptt日志，对于同一个事件ztestoragealarmNew（告警事件）和ztestoragealarmClear(恢复事件)类型内容都有一个相同的alarmuuid，提取事件信息中的alarmuuid作为标签ztestoragealarmuuid的值。

通过正则表达式提取事件Id

8. 根据触发器标签进行事件关联恢复

对已产生的SNMPTRAP事件，如果出现恢复事件(事件类型为：ztestoragealarmClear)，则通过触发器标签来进行匹配ztestoragealarmuuid，实现告警自动关闭。

匹配事件标签来关联恢复事件

9. 实现效果

云分存储磁盘异常

snmptt接收的告警事件内容

zabbix前端展示的告警

云分存储磁盘故障恢复

snmptt接收的恢复事件内容

zabbix平台显示事件已恢复

备注“使用Zabbix年限+企业+姓名”

进入交流群，4000+用户已加入

一个人走得快，一群人走得远