zabbix自定义用户key与参数User parameters

定位

为什么要自定义KEY

有时候我们想让被监控端执行一个zabbix没有预定义的检测，zabbix的用户自定义参数功能提供了这个方法。我们可以在客户端配置文件zabbix_angentd.conf里面配置UserParameter.
语法如下:
UserParameter=key,command

用户自定义参数包含一个key和一个命令，key必须整个系统唯一，配置好之后，重启客户端。
然后配置item,在key的位置填上我们自定义的key即可。
用户自定义参数里指定的脚本由zabbix agent来执行，最大可以返回512KB的数据.

用户自定义key实例

简单点的命令示例：
UserParameter=ping,echo 1
如果调用ping这个key，将会收到返回值1.

更复杂的命令示例:
UserParameter=mysql.ping,mysqladmin -uroot ping|grep -c alive
如果返回1表示MySQL运行中，如果返回0表示MySQL挂了

灵活的自定义key：
如下为灵活的用户自定义参数
UserParameter=key

,command

参数        描述
Key        唯一.

表示里面可以传递多个参数
Command        需要执行的脚本，key的[]里面的参数一一对应$1到$9，一共9个参数。$0表示脚本命令.

注意事项
1. 如果需要使用命令行里面出现$2这种变量，那么你要使用两个$$2，例如awk ’{ print $$2 }’，之前就遇到过这个问题，不停的测试自己脚本输出正常，但是zabbix却拿不到数据，原来是出在这里。为了防止和参数冲突，所以zabbix做了这个规定。
2. zabbix禁止使用一些不安全的参数，如下：
\ ' ” ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
3. 从zabbix 2.0开始，zabbix返回文本数据可以是空格。

示例1
UserParameter=ping

,echo $1
ping[0] - 将一直返回0
ping[aaa] - 将一直返回 'aaa'

示例2
UserParameter=mysql.ping

,mysqladmin -u$1 -p$2 ping | grep -c alive
如下参数用于监控MYSQL，并且可以传递用户名和密码。
mysql.ping[zabbix,our_password]

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

,grep -c "$2" $1

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