Zabbix常用item汇总及说明................................................................................................................ 1

Keys配置及使用说明............................................................................................................................. 3

Keys配置......................................................................................................................................... 3

自定义keys............................................................................................................................. 3

检查自定义key返回结果..................................................................................................... 4

zabbix_agentd.conf的include选项..................................................................................... 4

Zabbix自带常用keys.............................................................................................................................. 5

一、 zabbix客户端相关............................................................................................................... 5

二、 系统配置............................................................................................................................... 5

三、 进程状态............................................................................................................................... 7

四、 网络........................................................................................................................................ 7

五、 文件系统............................................................................................................................... 9

Zabbix自带的key不需要再进行配置，可以直接在web端直接使用建立trigger（触发器）。

 自定义keys的配置流程：

### Option: UserParameter

#       User-defined parameter to monitor. There can be several user-defined parameters.

#       Format: UserParameter=,  #格式要求

#       See 'zabbix_agentd' directory for examples.

#

# Mandatory: no

# Default:

# UserParameter= 

UserParameter=dis.keepalived.nginx,/van/svr/zabbix-3.0.0/bin/dis_keepalived_nginx.py   #（例子）

UserParameter=keepalived.shift.check,/van/svr/zabbix-3.0.0/bin/keepastatus.py    #（例子）

     ①一般新建的keys应该自定义在客户端配置文件zabbix_agentd.conf

举个例子，若要添加一个名字为keepalived.shift.check的key，只需要在配置文件zabbix_agentd.conf按照格式：UserParameter=,添加就可以了：

#（例子）

   UserParameter=keepalived.shift.check,   /van/svr/zabbix-3.0.0/bin/keepastatus.py    

                        ↑                            ↑

              （key的名字）     （key调用脚本的路径，或者直接系统命令）

自定义key通过调用脚本返回的信息zabbix可接受的常用数据类型有：Numeric（整型），Numeric（浮点型），Text（文本）

客户端配置完成后，重启zabbix客户端，自定义的key才会生效。

在客户端配置好自定义key后，zabbix_get工具可以在服务器端直接测试key在Server端返回的结果，zabbix_get在/usr/zagt/bin下。

zabbix_get使用命令：

sudo  ../bin/zabbix_get   -s    192.168.182.87    -k    agent.ping

命令解释：

-s                     你要查的ip地址,本地的，或者远程的都可以     -p                     zabbix_agentd的端口     -k                     key值     1                      也就是我们得到的结果，说明87主机的zabbix客户端有起来。  

当keys的数量或者种类不断扩大的时候，配置文件一个个按照”UserParameter=”添加自定义keys会让配置文件zabbix_agentd.conf变得累赘而且自定义keys 难以管理，所以可以使用配置文件中的include选项。

### Option: Include

#       You may include individual files or all files in a directory in the configuration file.

#       Installing Zabbix will create include directory in /usr/local/etc, unless modified during the compile time.

#

# Mandatory: no

# Default:

# Include=

# Include=/usr/local/etc/zabbix_agentd.conf.d/*.conf

Include=/usr/zagt/etc/zabbix_params/*.conf   #指定读取此文件夹下所有后缀为.conf的文件

指定的include文件不一定只带有”UserParameter=”参数，可以带有所有配置文件支持的参数。

以下是使用include指定的一个配置文件，主要自定义了keepalived相关的keys：

UserParameter=dis.keepalived.nginx,/van/svr/zabbix-3.0.0/bin/dis_keepalived_nginx.py

UserParameter=keepalived.shift.check,/van/svr/zabbix-3.0.0/bin/keepastatus.py

文件路径及文件名：/usr/zagt/etc/zabbix_params/dis_keepalived.conf

Keys

说明

返回

agent.hostname

返回被监控端名称(字符串)

Cloudlab087

agent.ping

检测被监控端是否存活(1:运行中 其他:未运行)-使用函数 nodata()检测客户端是否正在运行

       agent.version

zabbix agent版本字符串

3.0.0

system.cpu.load[,]

CPU负载浮点数 cpu - 可用值: all (默认), percpu (所有在线cpu的负载) mode - 可用值:avg1 (1分钟 默认值), avg5(5分钟平均), avg15 (15分钟平均值)CPU负载浮点数 cpu - 可用值: all (默认), percpu (所有在线cpu的负载) mode - 可用值:avg1 (1分钟 默认值), avg5(5分钟平均), avg15 (15分钟平均值)

system.cpu.load[,avg5]

返回：0.010000

system.cpu.num[]

CPU数量处理器个数type - 可用值: online (默认值)

system.cpu.num

返回：2

system.cpu.util[,,]

CPU利用率百分比 cpu - cpu数量 (默认是所有cpu) type - 可用值: idle, nice, user (默认), system (windows系统默认值）, iowait, interrupt, softirq,steal mode - 可用值: avg1 (一分钟平均，默认值), avg5(5分钟平均, avg15 (15分钟平均值)

system.cpu.util[,idle,avg5]

返回：99.355550

system.hostname[]

返回主机名字符串type (仅用于windows系统) – 可用值: netbios(默认) or host

            system.hostname

           返回：cloudlab087

system.localtime[]

系统时间.数字或者字符串

            返回：1457597460

system.run[command,]

在制定的主机上运行命令文本（配置文件必须开启RemoteCommand）command - 命令 mode - wait (默认值, 执行超时时间), nowait (不等待)最大可用返回512KB数据，包含空白数据。 命令输出数据必须是文本

system.run[‘ls -l /tmp’]  列出/tmp的文件和目录.

system.stat[resource,]

虚拟内存状态数字ent

system.sw.os[]

返回系统信息字符串 info - full (default), short ,name 信息来自如下文件： /proc/version [short] /proc/version_signature [name] /etc/issue.net

system.sw.os[full]

返回： Linux version 3.10.0-229.20.1.el7.x86_64 ([email protected]) (gcc version 4.8.3 20140911 (Red Hat 4.8.3-9) (GCC) ) #1 SMP Tue Nov 3 19:10:07 UTC 2015

system.sw.packages[,,]

已安装软件列表文本值 package - all (默认)或者正则表达式 manager - all (默认) or a package manager format - full (默认) ，short

system.sw.packages[keepalived,,short]

返回：

keepalived-1.2.13-7.el7.x86_64

system.uname

返回主机相信信息.字符串

返回：

Linux cloudlab087 3.10.0-327.3.1.el7.x86_64 #1 SMP Wed Dec 9 14:09:15 UTC 2015 x86_64

system.uptime

系统运行时长(秒)多少秒使用s/uptime来获取

返回：5702506

system.users.num

登陆用户数量多少用户agent使用who命令获取

返回：2

proc.mem[,,,]

用户进程消耗的内存内存使用量 (字节单位). name - 进程名 (默认值 “all processes”) user - 用户名 (默认值“all users”) mode - 可选值: avg, max, min, sum (默认) cmdline - 命令行过滤(正则表达时)

 proc.mem[zabbix_server,zabbix]  zabbix用户运行的zabbix_server使用了多少内存

返回：6759755776

proc.num[,,,]

某用户某些状态的进程的数量进程数量 name - 进程名称 (默认“all processes”) user - 用户名 (默认 “all users”) state - 可用值: all (默认), run,sleep, zomb cmdline - 命令行过滤(正则表达时)

proc.num[nginx,root]  root运行了多少个nginx进程

返回：1

若返回0则表示nginx已经down掉

net.dns[,zone,,,]

检测DNS服务是否开启0 – DNS挂了  1 - DNS运行中 ip - DNS服务器的ip地址(留空表示使用本地DNS, ignored onWindows) zone - 需要测试的域名 type - 记录类型 (默认为 SOA),type可选值:  ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (除了windows), HINFO, MINFO, TXT, SRV SRV timeout (ignored on Windows) – 超时时间(默认1秒) count (ignored on Windows) – 重试次数 (默认值2)

net.dns[8.8.8.8,zabbix.com,MX,2,1]

net.if.discovery

列出网卡.通常用于低级别（low-discovery)的discovery.JSON对象

返回：{"data":[{"{#IFNAME}":"eth0"},{"{#IFNAME}":"eth1"},{"{#IFNAME}":"lo"}]}

net.if.in[if,]

网卡入口流量整数. if - 网卡名称 mode - 可用值: bytes - 字节数 (默认) packets - 包数量 errors - 错误数量 dropped - 丢包数量

net.if.in[ens192]

 返回：2742810501

net.if.in[ens192,errors]

返回：0

net.if.out[if,]

解释同net.if.in

net.if.out[eth0] net.if.out[eth0,errors]

net.if.total[if,]

解释net.if.in

net.if.total[eth0] net.if.total[eth1,errors]

net.tcp.listen[port]

检测端口是否开启0 – （not listen） 1 –  in LISTEN stateport

net.tcp.listen[80]

net.tcp.port[,port]

是否可以连接到指定的TCP端口 0 – cannot connect  1 – can connect    ip - IP地址(默认是 127.0.0.1)    port - 端口

net.tcp.port[,80]

返回：1

net.tcp.service[service,,]

   检测服务是否开启，并且端口可用    0 – 服务挂了    1 – 服务运行中    service - 如下:（ssh, ntp, ldap, smtp, ftp, http, pop, nntp,imap, tcp, https, telnet）    ip - IP地址 (默认127.0.0.1)    port - 端口 (默认情况为标准端口号)

net.tcp.service[http,,80]

返回：0

端口应用层挂了

net.tcp.service.perf[service,,]

检测服务器性能 0 – 服务挂了; seconds – 链接到服务器端口消耗的时间 service - 如下:ssh, ntp, ldap, smtp, ftp, http, pop, nntp,imap, tcp, https, telnet ip - IP地址 (默认127.0.0.1) port - 端口 (默认情况为标准端口号)

net.tcp.service.perf[http,192.168.182.87,80]

返回：0.000319

vfs.file.exists[file]

检测文件是否存在 1 – 存在 0 – 不存在

   vfs.file.exists[/etc/hosts]

           返回：1

vfs.file.size[file]

文件大小字节zabbix必须有可读此文件的权限

vfs.file.size[/van/svr/zabbix-3.0.0]

返回：78

vfs.fs.size[fs,]

磁盘空间，返回本地文件系统的使用量字节 fs - 文件系统 mode -  total (默认), free, used, pfree (空闲百分比), pused (使用百分比).

  vfs.fs.size[ext3,free]

vfs.file.time[file,]

文件时间信息Unix 时间戳. mode -  modify (默认, 修改时间), access – 最后访问时间, change – 最后改变时间

vfs.file.time[/etc/passwd,change]

返回： 1455674845

vm.memory.size[]

内存大小字节或百分比 mode - total (默认), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, wired, used, pused, available 监控项vm.memory.size[] 允许三种类型的参数： 第一类：包含total - 总内存 第二类： 系统指定内存类型:active, anon, buffers, cached, exec, file, free, inactive,pinned, shared, wired. 第三类：用户级别，一共使用了多少内存，还有多少内存可用: used, pused, available,pavailable.

vfs.dev.read[,,]

磁盘读取状态整数，浮点数（如果type为如下） device - 磁盘设备 (默认值 “all”)  type - 可选值:sectors, operations, bytes, sps, ops, bps(必须指定, 不同操作系统下不同).  sps, ops, bps stand for: sectors, operations, bytes per second, respectively mode - 可选值: avg1, avg5, avg15.  备注: 只有type为sps, ops, bps的时候，第三个参数才被支持。 不同操作系统的TYPE参数： FreeBSD – bps Linux – sps OpenBSD – operations Solaris – bytes

vfs.dev.read[,ops]

返回：0.000000

vfs.dev.write[,,]

磁盘写入状态整数， device - 磁盘设备 (默认 all)  type - sectors, operations, bytes, sps, ops, bps mode - one of avg1 (default),avg5 , avg15.

vfs.dev.write[,ops]

返回：55.888889

vfs.file.cksum[file]

计算文件校验 UNIX cksum.

vfs.file.cksum[/etc/passwd]

返回：1699646614