zabbix专题：第九章自定义key（案例：监控内存，监控nginx状态）

川长思鸟来 2022-04-08 14:27 213阅读 0赞

### 第九章 自定义key    ###

**对Linux有兴趣的朋友加入QQ群：476794643 在线交流**

**本文防盗链：http://zhang789.blog.51cto.com**

### 为什么要自定义KEY ###

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

`语法如下:`

UserParameter=key,command

> 用户自定义参数包含一个key和一个命令，key必须整个系统唯一，配置好之后，重启客户端。  
> 然后配置item,在key的位置填上我们自定义的key即可。

#### `简单点的命令示例：` ####

UserParameter=ping,echo 1

如果调用ping这个key，将会收到返回值1.

#### `更复杂的命令示例:` ####

UserParameter=mysql.ping,mysqladmin -uroot ping|grep -c alive

如果返回1表示MySQL运行中，如果返回0表示MySQL挂了

#### `key的高级使用方法` ####

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

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

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

--------------------

### 案例：简单的key实现 ###

> 我们这个参数可以查出内存空闲了多少，如果我们zabbix要监控，但是zabbix服务器上面没有这个key怎么办呢，我们就要自定义了

[root@localhost ~]# free | awk '/^Mem:/{print $4}'
    88412

1、客户端必须安装了`zabbix-agentd客户端`，修改`zabbix_agentd.conf`

[root@localhost ~]# vim /etc/zabbix/zabbix_agentd.conf
    UserParameter=Mem.free,free | awk '/^Mem:/{print $4}'

2、重启`客户端`

[root@localhost ~]# service zabbix-agent restart
    Shutting down Zabbix agent:                                [  OK  ]
    Starting Zabbix agent:                                     [  OK  ]

3、在`zabbix服务端`上面zabbix\_get测试能否获取数据

[root@localhost ~]# zabbix_get -s 10.1.252.241 -k "Mem.free"
    87844

### 案例：高级的key监控内存总大小和当前使用 ###

我们都知道/proc是内核的反射区，/proc/meminfo 中显示的内存信息

[root@localhost ~]# cat /proc/meminfo 
    MemTotal:        1001332 kB
    MemFree:          121864 kB
    MemAvailable:     325308 kB
    Buffers:               0 kB
    Cached:           274108 kB
    ........

> 上面显示出来了内存的详细信息，我们如何定义key让zabbix服务端监控我们主机的内存信息

1、执行正则表达式命令可以把信息过滤出来，但是每个参数都用一个正则表达式来做，这不符合我们这些高级的搬服务器能干的出来的的，从上面的简单案例可以看出，我们可以使用`[*]`然后`$1`,`$2`这样的来调用

[root@localhost ~]# cat /proc/meminfo | awk "/^MemTotal:/{print $2}"
    MemTotal:        1004136 kB

2、我们就监控这些参数，用一个key实现

MemTotal:        1004136 kB
    MemFree:           87800 kB
    Buffers:          108264 kB
    Cached:           590832 kB

3、修改`zabbix_agentd.conf`  
`$1 是调用前面的[*]里面的参数的，为什么使用$$2，如果使用一个$会让这个shell命令认为是调用第二个[*]里面的参数`

UserParameter=memory.usage[*],/bin/cat /proc/meminfo | awk '/^$1:/{print $$2}

4、我们在服务器用zabbix\_get测试，看能不能获取key定义的值（`完全不用质疑，可以`）

[root@localhost ~]# zabbix_get -s 10.1.252.241 -k "memory.usage[MemTotal]"
    1004136
    [root@localhost ~]# zabbix_get -s 10.1.252.241 -k "memory.usage[MemFree]"
    85464
    [root@localhost ~]# zabbix_get -s 10.1.252.241 -k "memory.usage[Buffers]"
    108516
    [root@localhost ~]# zabbix_get -s 10.1.252.241 -k "memory.usage[Cached]"
    590900

5、到zabbix服务器上面添加对应的参数监控项，然后集中到一个图里面，应该不是什么事吧，不会设置监控项和图的，可以参考前面的文章

### 案例：利用高级的key监控nginx的状态 ###

1、nginx server的主配置文件 都配置status模块 代码端如下

location /ngst{  
        stub_status on;  
        access_log off;  
        allow 127.0.0.1;  
        deny all;  
    }

2、nginx-status的取值脚本

[root@localhost ~]# vim /home/zabbix/nginx_status.sh 
    #!/bin/bash
    #
    host='127.0.0.1'
    port='80'
    status='/status'
    
    active() {
        
            curl -s http://${host}:${port}${status} | awk '/^Active/{print $3}'
    }
    
    accepts() {
        
            curl -s http://${host}:${port}${status} | awk 'NR==3{print $1}'
    }
    
    handled() {
        
            curl -s http://${host}:${port}${status} | awk 'NR==3{print $2}'
    }
    
    requests() {
        
            curl -s http://${host}:${port}${status} | awk 'NR==3{print $3}'
    }
    
    reading() {
        
            curl -s http://${host}:${port}${status} | awk 'NR==4{print $2}'
    }
    
    writing() {
        
            curl -s http://${host}:${port}${status} | awk 'NR==4{print $4}'
    }
    
    waiting() {
        
            curl -s http://${host}:${port}${status} | awk 'NR==4{print $6}'
    }
    
    $1

3、加上执行权限

[root@localhost zabbix]# chmod +x nginx_status.sh

4、修改`zabbix_agentd.conf`

UserParameter=nginx.status[*],/home/zabbix/nginx_status.sh $1

[root@localhost zabbix]# service zabbix-agent restart
    Shutting down Zabbix agent:                                [  OK  ]
    Starting Zabbix agent:                                     [  OK  ]

5、zabbix服务端zabbix\_get测试自定义key

[root@localhost ~]# zabbix_get -s 10.1.252.241 -k "nginx.status[requests]"
    503

6、自定义已经执行成功，在web上面添加监控项

![QQ截图20161105155355.png][QQ_20161105155355.png]

7、添加好，把监控项做成一张图

![QQ截图20161105155444.png][QQ_20161105155444.png]

[QQ_20161105155355.png]: http://www.178linux.com/ueditor/php/upload/image/20161105/1478332590821376.png
[QQ_20161105155444.png]: http://www.178linux.com/ueditor/php/upload/image/20161105/1478332596272908.png