龙空技术网

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

Zabbix中国 849

前言:

此刻兄弟们对“netapp消除告警”大体比较看重,姐妹们都想要剖析一些“netapp消除告警”的相关知识。那么小编也在网摘上汇集了一些有关“netapp消除告警””的相关知识,希望大家能喜欢,大家一起来了解一下吧!

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

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

第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
2.4 重启SNMPTT
# systemctl restart snmptt
2.5 创建ZTE云桌面SNMPTRAP监控模板

SNMPTRAP模板

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

2.6 创建监控实例

创建SNMPTRAP实例

关联监控模板

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

2.7 查看最新数据

SNMPTRAP最新数据

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

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

经过编码的SNMPTRAP信息

通过SNMPTT规则配置文件的EXECPREXEC属性,可以实现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"  
第3章 应用案例3.1 应用案例1:通过外部脚本转码翻译SNMPTRAP信息3.1.1 案例描述

中兴云桌面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平台显示事件已恢复

标签: #netapp消除告警