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