fateame 发表于 2018-1-2 07:42:39

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端的配置文件,可作参考
  

# 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中的,一般在格式规整的查询中,需要多个查询的时候,可以直接使用变量进行传递即可以
  如下
  

# 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
  在上述举例中,useage后面的参数,被传递给后面的$1位置 ,而后面的$$2,是因为awk语法中需要print $2所致,为了转义,使用$$2,否则awk无法执行
  自定义key中的参数传递最多支持$1~$9,所有参数均写定在UserParameter后面的[]中,使用,进行分隔
  多个参数传递的简单举例,如下
  

统计一个文件中有多少行被匹配?  
UserParameter=wc
[*],grep -c "$2" $1
  
如下方法将会返回文件中出现指定字符的行数
  
wc
  
wc
  

  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>  

  实例如下
  

# zabbix_get -s 114.55.95.79-k "mysql.status"  
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>]  

  实际举例:
  

# zabbix_agentd -t tomcat.statuscode  
tomcat.statuscode                           
  

  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
  
zabbixALL=(ALL)   NOPASSWD:ALL
  
## 开启zabbix sudo权限
  

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

# 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 received value
  
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
页: [1]
查看完整版本: zabbix active模式以及自定义key not Supported的解决