zabbix active模式以及自定义key not Supported的解决

fateame

zabbix active模式

active模式适用场景
　　zabbix server端无法直连agent端，比如agent为内网机器，仅有内网ip，没有公网ip，但是内网机器能够访问server端
　　active模式相比于agent模式，是agent端通过自己对server端进行访问，获取server端对数据抓取的类型，然后自己向server端发送相关的数据。

active的配置文件示例
　　相比于agent端的配置文件设置，其配置文件主要变更在需要开启RefreshActiveChecks与ServerActive两个的值
　　如下有一份zabbix active模式下agent端的配置文件，可作参考
　　

[iyunv@RHEL6-WEB03-BSSWEB zabbix]# grep -v ^# zabbix_agentd.conf　　
UserParameter=tomcat.statuscode,sudo /etc/zabbix/monitorsmscode.sh
　　
##自定义key，通过运行脚本获得
　　
UserParameter=disk.free,sudo df -h | awk '/^\/dev\//{print $5}'  | awk -F% '{print $1}' | sort -n | tail -1
　　
##自定义key，通过运行命令直接获得
　　
PidFile=/var/run/zabbix/zabbix_agentd.pid
　　
##默认的pid文件路径
　　
LogFile=/var/log/zabbix/zabbix_agentd.log
　　
##默认的log文件路径
　　
LogFileSize=0
　　
##不限制log文件大小
　　
EnableRemoteCommands=1
　　
##开启远程执行zabbix server端的命令，适用于action中的自动恢复处理
　　
Server=123.56.78.170
　　
##zabbix server端的ip地址(agent模式)
　　
ListenPort=10050
　　
##zabbix agent监控的port
　　
ListenIP=0.0.0.0
　　
##监听本机所有ip
　　
ServerActive=123.56.78.170
　　
##zabbix server端的ip地址(active模式，active模式下必须要开启)
　　
Hostname=10.68.32.59
　　
##主机名，务必与在web界面中的hostname一致，并非一定为ip
　　
RefreshActiveChecks=120
　　
##agent在active模式获取server端取值类型的刷新时间，稳定后可设定为最大值
　　
Timeout=30
　　
##agent发送监控项的超时时间，有些自定义key可能需要运行很长时间才能获取值，超时时间过短会出现数据发送失败
　　
Include=/etc/zabbix/zabbix_agentd.d/
　　
UnsafeUserParameters=1
　　
##开启自定义key功能
　　

active模式在server端web界面中item的设定
　　1.单个建立active模式item

　　其相比于agent端中的item设定，需要将type变更为active选项
　　2.批量建立active模式的item
　　比如需要使用zabbix中常用的linux os templates，不太可能直接纯手动建立，我们可以通过复制的方式将item进行active模式的转化。

　　如上图，先新建一个templates，然后进入linux os template中的item，选择所有，然后选择copy selected to，然后在新的界面中选择templates，选中我们新建的templates即可。
　　新建的templates中即有了linux os templates中的所有item，然后同样操作，选择所有item，然后选择mass update，在下一步中，将所有type变更为active模式即可
　　此即将有所有item导入为active模式下的item。
　　但是在此并不推荐此种做法，因为在linux os templates中，除了item之外，还会有其它的设置，比如Discovery,screeen等，单纯的copy并不能将原先中所有参数设定变更为active模式中的参数。
　　在此推荐另外一种手法:
　　进入点击linux os templates进入templates，然后在下面选择clone，通过clone将原来的templates中的参数完成复制到另外一个templates中，然后再使用mass update将其中的type由agent模式变更为active模式

自定义key
　　1.自定义key的格式
　　UserParameter=
　　前面是键值，后面是命令。如下例:
　　

UserParameter=nginx.active,curl -s http://localhost/status | awk '/^Active/{print $3}'　　

　　2.自定义key中的参数传递与转义
　　在自定义key中的，一般在格式规整的查询中，需要多个查询的时候，可以直接使用变量进行传递即可以
　　如下
　　

[iyunv@iZ25b31bdp0Z zabbix]# cat /proc/meminfo　　
MemTotal:        3620188 kB
　　
MemFree:          588228 kB
　　
MemAvailable:    1549608 kB
　　
Buffers:          275780 kB
　　
Cached:           509336 kB
　　
SwapCached:            0 kB
　　
Active:          2174808 kB
　　
Inactive:         226312 kB
　　
Active(anon):    1709644 kB
　　
Inactive(anon):   159404 kB
　　
Active(file):     465164 kB
　　
Inactive(file):    66908 kB
　　
Unevictable:           0 kB
　　
Mlocked:               0 kB
　　
SwapTotal:             0 kB
　　
SwapFree:              0 kB
　　
Dirty:               408 kB
　　
Writeback:             0 kB
　　
AnonPages:       1616100 kB
　　
Mapped:           111140 kB
　　
Shmem:            253044 kB
　　
Slab:             552816 kB
　　
SReclaimable:     513752 kB
　　
SUnreclaim:        39064 kB
　　
KernelStack:        4112 kB
　　
PageTables:        30980 kB
　　
NFS_Unstable:          0 kB
　　
Bounce:                0 kB
　　
WritebackTmp:          0 kB
　　
CommitLimit:     1810092 kB
　　
Committed_AS:    4482560 kB
　　
VmallocTotal:   34359738367 kB
　　
VmallocUsed:        7944 kB
　　
VmallocChunk:   34359730291 kB
　　
HardwareCorrupted:     0 kB
　　
AnonHugePages:    483328 kB
　　
HugePages_Total:       0
　　
HugePages_Free:        0
　　
HugePages_Rsvd:        0
　　
HugePages_Surp:        0
　　
Hugepagesize:       2048 kB
　　
DirectMap4k:      198656 kB
　　
DirectMap2M:     3995648 kB
　　

　　在/proc/meminfo中，需要查询多个值，但是又不想多次重复书写key值
　　可以使用如下
　　

UserParameter=memory.useage

,/usr/bin/awk '/^$1/{print $$2}' /proc/meminfo　　

　　然后在server端的web界面中，设置自定义key时，在key中将所需要查询的具体值，直接书写在userparameter中的[]中即可
　　如果要获取MemFree的值
　　在web中key的书写应该为memory.useage[MemFree]
　　在上述举例中，useage后面的参数，被传递给后面的$1位置 ，而后面的$$2，是因为awk语法中需要print $2所致，为了转义，使用$$2，否则awk无法执行
　　自定义key中的参数传递最多支持$1~$9，所有参数均写定在UserParameter后面的[]中，使用,进行分隔
　　多个参数传递的简单举例，如下
　　

统计一个文件中有多少行被匹配?　　
UserParameter=wc

,grep -c "$2" $1
　　
如下方法将会返回文件中出现指定字符的行数
　　
wc[/etc/passwd,root]
　　
wc[/etc/services,zabbix]
　　

　　3.自定义key的测试
　　在自定义key设置完成之后，需要检测自定义key获取的值正确与否，可以使用zabbix_get命令进行获取
　　3.1 agent模式
　　使用方法:在server端直接获取
　　

zabbix_get [-hV] -s <host name or IP> [-p <port>] [-I <IP address>] -k <key>　　

　　实例如下
　　

[iyunv@iZ25i0aaqmzZ ~]# zabbix_get -s 114.55.95.79  -k "mysql.status[Active]"　　
159
　　

　　3.2 active模式
　　active模式因为server端无法直接get到agent端的信息，需要agent端自行将数据发送至server端，故zabbix_get是无法获取到值的
　　可以使用zabbix_agentd命令进行自我测试
　　

zabbix_agentd [-Vhp] [-R <runtime option>] [-c <config-file>] [-t <item key>]　　

　　实际举例:
　　

[iyunv@RHEL6-WEB03-BSSWEB ~]# zabbix_agentd -t tomcat.statuscode　　
tomcat.statuscode                             [t|1]
　　

　　4.自定义key not supported
　　在自定义key设置ok后，经常会在web界面中显示自定义key not supported
　　总结大概可能有以下几种可能:
　　4.1 agent端发送数据超时
　　此处可以更改zabbix.conf中的Timeout时间，将其值修改大一些。
　　4.2 数据类型不一致
　　agent端发送的数据类型与server端web界面里面的数据类型不一致，如本来agent端发送的是text格式，但是定义的却是Numeric格式，此处也会出现not supported
　　4.3 zabbix用户没有权限执行自定义key中的命令或者脚本
　　如上述举例中有一个自定义key
　　

UserParameter=tomcat.statuscode,sudo /etc/zabbix/monitorsmscode.sh　　

　　在此key中，因为执行该命令的用户为zabbix，而zabbix并没有sudo权限，故需要对/etc/sudoer中进行修改。相关修改如下:
　　

Defaults    !requiretty　　
## 不需要使用tty终端即能执行sudo命令，action中使用自动恢复设定时必须开启
　　
root    ALL=(ALL)   ALL
　　
zabbix  ALL=(ALL)   NOPASSWD:ALL
　　
## 开启zabbix sudo权限
　　

　　在此类权限问题中，在active模式中对自定义key的值获取进行自行检测获取时，可以直接su至zabbix用户
　　

[iyunv@RHEL6-WEB03-BSSWEB ~]# su - zabbix -s /bin/bash -c "zabbix_agentd -t tomcat.statuscode"　　

　　因为zabbix的shell为nologin，故使用su入的时候使用bash，从而有了交互界面。
　　如果zabbix用户有权限问题，在此处即无法获取到值。
　　4.4 not supported的其它解决
　　如果以上几种方式都无法解决的话，可以通过将zabbix agent的debug日志打开。通过查看其中的日志，具体寻找问题所在。
　　如上述zabbix没有sudo用户权限的时候，在/var/log/zabbix/zabbix_agentd.log中可以查看到如此一样的记录
　　

129440:20170727:145313.987 EXECUTE_STR() command:'sudo /etc/zabbix/monitorsmscode.sh' len:53 cmd_result:'sudo: no tty present'　　
129440:20170727:145313.987 for key [tomcat.statuscode] received value [sudo: no tty present and no askpass program specified]
　　
129440:20170727:145313.987 In process_value() key:'10.68.32.59:tomcat.statuscode' value:'sudo: no tty present and no askpass program specified'
　　

　　其中可以看到是因为zabbix没有sudo权限所致，无法获取到该自定义key的值。
　　打开zabbix debug日志收集，需要在/etc/zabbix/zabbix.conf中将DebugLevel的值设定为4