zabbix active模式以及自定义key not Supported的解决
zabbix active模式
active模式适用场景
zabbix server端无法直连agent端,比如agent为内网机器,仅有内网ip,没有公网ip,但是内网机器能够访问server端
active模式相比于agent模式,是agent端通过自己对server端进行访问,获取server端对数据抓取的类型,然后自己向server端发送相关的数据。
active的配置文件示例
相比于agent端的配置文件设置,其配置文件主要变更在需要开启RefreshActiveChecks
与ServerActive
两个的值
如下有一份zabbix active模式下agent端的配置文件,可作参考
[root@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中的,一般在格式规整的查询中,需要多个查询的时候,可以直接使用变量进行传递即可以
如下
[root@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>
实例如下
[root@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>]
实际举例:
[root@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用户
[root@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