zabbix agent 类型key
来源自 “ttlsa”zabbix服务器端通过与zabbix agent通信来获取客户端服务器的数据，agent分为两个版本，其中一个是主动一个是被动，在配置主机我们可以看到一个是agent，另一个是agent（active）。前者为被动检测，后者为主动检测。那么主动和被动区别在哪里呢？
被动：zabbix server向zabbix agent讨要数据。
主动：zabbix agent提交数据给zabbix server。Zabbix培训
监控项keys列表
以下表格是zabbix agent所支持的所有.请大家一一过目，认识他们就行，不需要背下来。
Key
功能返回值参数描述
agent.hostname
-
agent.ping
agent.version
zabbix agent版本字符串-例如返回： 1.8.2
kernel.maxfiles
系统支持最大的openfiles整数
kernel.maxproc
系统支持最大的进程数量整数
log 下载地址
监控日志文件Logfile – 文件详细路径regexp – 正则encoding – 编码
maxlines – zabbix agent向server或者proxy发送最大的行数。这个参数覆盖配置文件zabbxi_agentd.conf中的’MaxLinesPerSecond’
mode – 可选值: all (默认), skip (跳过处理老数据).mode参数从2.0版本开始支持
output – 可选项，输出格式模板. The \0 escape sequence is replaced with the matched text while an \N(where N=1…9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).
If <output> is left empty
– the whole line containing the matched text is returned. Note that all global regular expression types except ‘Result is TRUE’ always return the whole matched line and the <output> parameter is ignored.
output是2.2中新加入的功能
这个监控项只能设置为 active check（主动模式）.如果文件不存在或者没有相应的权限，那么监控项状态会转变为unsupported.示例:
log log log
logrt
监控支持轮转的日志Logfile_pattern – 文件绝对路径regexp – 正则表达式encoding – 编码
maxlines – 客户端每秒发送给server的最大行数. 这个参数会覆盖客户端配置文件zabbix_agentd.conf中MaxLinesPerSecond的值
mode – 可选值: all (默认), skip (跳过老数据的处理).
Mode参数从2.0开始支持
output – an optional output formatting template. The \0 escape sequence is replaced with the matched text while an \N(where N=1…9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups). If <output> is left empty – the whole line containing the matched text is returned. Note that all global regular expression types except ‘Result is TRUE’ always return the whole matched line and the <output> parameter is ignored. The output parameter is supported from version 2.2.
The item must be configured as an active check. Log rotation is based on the last modification time of files.示例:logrt[“/home/zabbix/logs/^logfile{1,3}$”,,,100]
– will match a file like “logfile1″ (will not match “.logfile1″)
logrt[“/home/user/logfile_.*_{1,3}”,”pattern_to_match”,”UTF-8″,100]
– will collect data from files such “logfile_abc_1” or “logfile__001”.
net.dns[<ip>,zone,<type>,<timeout>,<count>]
检测DNS服务是否开启0 – DNS挂了 1 – DNS运行中ip – DNS服务器的ip地址(留空表示使用本地DNS, ignored on Windows)zone – 需要测试的域名type – 记录类型 (默认为 SOA)
timeout (ignored on Windows) – 超时时间(默认1秒)
count (ignored on Windows) – 重试次数 (默认值2)
示例key:net.dnstype可选值: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (除了windows), HINFO, MINFO, TXT, SRV
SRV记录从Zabbix agent versions 1.8.6 (Unix) and 2.0.0 (Windows)开始支持Zabbix 2.0
之前的命名方式: net.tcp.dns（目前依旧支持）
net.dns.record[<ip>,zone,<type>,<timeout>,<count>]
执行一个DNS查询获取DNS查询数据ip – DNS服务器的ip地址(留空表示使用本地DNS, ignored on Windows)zone – 需要测试的域名type – 记录类型 (默认为 SOA)
timeout (ignored on Windows) – 超时时间(默认1秒)
count (ignored on Windows) – 重试次数 (默认值2)
示例key:net.dns.recordtype的可选值: ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (except for Windows), HINFO, MINFO, TXT, SRV
SRV记录从Zabbix agent versions 1.8.6 (Unix) and 2.0.0 (Windows)开始支持Zabbix 2.0
之前的命名方式: net.tcp.dns（目前依旧支持）
net.if.collisions
Out-of-window collisionNumber of collisions数字if – 网卡
net.if.discovery
列出网卡. 通常用于低级别的discoveryJSON对象Zabbix agent 2.0开始支持 但是操作系统FreeBSD, OpenBSD and NetBSD上的 Zabbix agent 2.2开始支持
net.if.in
网卡入口流量整数if – 网卡名称mode – 可用值:bytes – 字节数 (默认)
packets – 包数量
errors – 错误数量
dropped – 丢包数量
示例keys: net.if.in net.if.in请使用增量存储方式
net.if.out
网卡出口流量整数if – 网卡名称mode – 可用值:bytes – 字节数 (默认)
packets – 包数量
errors – 错误数量
dropped – 丢包数量
范例keys:net.if.out net.if.out请使用增量存储方式
net.if.total
网卡进/出流量的总和整数if – 网卡名称mode – 可用值:bytes – 字节数 (默认)
packets – 包数量
errors – 错误数量
dropped – 丢包数量
范例keys:net.if.total net.if.total请使用增量存储方式
net.tcp.listen
检测端口是否开启0 – 未监听1 – 监听中port – TCP端口示例:net.tcp.listenlinux下的zabbix agent 1.8.4开始支持
net.tcp.port[<ip>,port]
是否可以连接到指定的TCP端口0 – 无法连接1 – 可以连接ip – IP地址(默认是 127.0.0.1)port – 端口范例:net.tcp.port[,80]检测web服务器端口是否运行中
老命名方式: check_port
net.tcp.service
检测服务是否开启，并且端口可用0 – 服务挂了1 – 服务运行中service – 如下: ssh, ntp, ldap, smtp, ftp, http, pop, nntp,imap, tcp, https, telnetip – IP地址 (默认127.0.0.1)port – 端口 (默认情况为标准端口号)示例key:net.tcp.service – 检测45端口上得FTP是否运行中Zabbix 1.8.3 支持的版本请使用service.ntp 代替ntp.
https 和telnet 服务从2.0和2.2开始支持
net.tcp.service.perf
检测服务器性能0 – 服务挂了;seconds – 链接到服务器端口消耗的时间service – 如下:ssh, ntp, ldap, smtp, ftp, http, pop, nntp,imap, tcp, https, telnetip – IP地址 (默认127.0.0.1)port – 端口 (默认情况为标准端口号)示例key:net.tcp.service.perf – 检测SSH服务器响应速度加密协议检测不被支持 (类似 IMAP端口 993或者POP端口995) .但是我们可以使用net.tcp.service.perf 来检测他们.Windows agent不能检测LDAP和HTTPS. Note that the telnet check looks for a prompt (‘:’ at the end).老命名方式: check_service_perf 注意：that before Zabbix 1.8.3 version service.ntp should be used instead of ntp. Zabbix 2.0支持 https和telnet服务
net.udp.listen
检测UDP端口是否在监听0 – 未监听1 – 监听中port – udp端口范例:net.udp.listenlinux系统的Zabbix agent 1.8.4开始支持
proc.mem[<name>,<user>,<mode>,<cmdline>]
用户进程消耗的内存内存使用量 (字节单位).name – 进程名 (默认值 “all processes”)user – 用户名 (默认值“all users”)mode – 可选值: avg, max, min, sum (默认)
cmdline – 命令行过滤(正则表达时)
示例keys:proc.mem[,root]– root的进程消耗了多少内存
proc.mem
– zabbix用户运行的zabbix_server使用了多少内存
proc.mem[,oracle,max,oracleZABBIX] – memory used by the most memory-hungry process running under oracle having oracleZABBIX in its command line
proc.num[<name>,<user>,<state>,<cmdline>]
某用户某些状态的进程的数量进程数量name – 进程名称 (默认“all processes”)user – 用户名 (默认 “all users”)state – 可用值: all (默认), run,sleep, zomb
cmdline – 命令行过滤(正则表达时)
示例keys: proc.num[,mysql]– MySQL用户运行的进程数量
proc.num
– www-data运行了多少个apache2进程proc.num[,oracle,sleep,oracleZABBIX] – number of processes in sleep state running under oracle having oracleZABBIX in its command line
备注：Windows系统只支持name和user两个参数
sensor
读取硬件传感器device – 设备名称sensor – 传感器名称mode – 可选值: avg,
max, min (if this parameter is omitted, device and sensor are treated verbatim).
On Linux 2.4, 读取/proc/sys/dev/sensors.
示例key:sensor Prior to Zabbix 1.8.4, the sensor format was used. On Linux 2.6+, 读取/sys/class/hwmon. On OpenBSD, 读取hw.sensors MIB.示例keys:
sensor – CPU0的温度
sensor$,temp,avg] – cpu平均温度
Zabbix 1.8.4开始支持OpenBSD
system.boottime
系统启动的时间鹾整数unix时间戳
system.cpu.intr
设备中断整数
system.cpu.load[<cpu>,<mode>]
CPU负载浮点数cpu – 可用值: all (默认), percpu (所有在线cpu的负载)mode – 可用值: avg1 (1分钟 默认值), avg5(5分钟平均), avg15 (15分钟平均值)范例key:system.cpu.load[,avg5]老命令方式: system.cpu.loadX
参数percpu is Zabbix 2.0.0开始支持
system.cpu.num[<type>]
CPU数量处理器个数type – 可用值: online (默认值), max范例:system.cpu.num
system.cpu.switches
上下文交换交换次数老命名方式: system
system.cpu.util[<cpu>,<type>,<mode>]
CPU利用率百分比cpu – cpu数量 (默认是所有cpu)type – 可用值: idle, nice, user (默认), system (windows系统默认值）, iowait, interrupt, softirq,stealmode – 可用值: avg1 (一分钟平均，默认值), avg5(5分钟平均, avg15 (15分钟平均值)范例key:system.cpu.util老命名方式:
system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX
system.hostname[<type>]
返回主机名字符串type (仅用于windows系统) – 可用值: netbios(默认) or host例如:on Linux: system.hostname → linux-w7x1 system.hostname → on Windows: system.hostname → WIN-SERV2008-I6 system.hostname → Win-Serv2008-I6LonG type参数从zabbix 1.8.6开始支持
system.hw.chassis[<info>]
返回机架信息字符串info – full (默认), model, serial, type 或vendor例如: system.hw.chassis Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop] 需要root权限，因为这些信息是从内存中读取的。 Zabbix agent version 2.0 开始支持
system.hw.cpu[<cpu>,<info>]
返回CPU信息字符/数字cpu – cpu数量或者all (默认)info – full (默认), curfreq, maxfreq, model 或者vendor例如:system.hw.cpuAuthenticAMD 从/proc/cpuinfo、/sys/devices/system/cpu//cpufreq/cpuinfo_max_freq获取信息. 如果指定了CPU数量和 curfreq或者maxfreq, 将会返回数值(Hz).
Zabbix agent 2.0 开始支持
system.hw.devices[<type>]
列出PCI或者USB文本值type – pci (默认) or usb范例:system.hw.devices00:00.0 Host bridge: Advanced Micro Devices RS780 Host Bridge [..] 返回lspci或者lsusb (不带参数)
Zabbix agent 2.0开始支持
system.hw.macaddr[<interface>,<format>]
列出MAC地址字符串interface – all (默认) 或者正则表达式format – full (默认) 、short范例:system.hw.macaddr[“eth0$”,full] 00:11:22:33:44:55 列出指定接口mac地址 如果format指定为short，MAC地址相同的将会被忽略掉
Zabbix agent 2.0开始支持
system.localtime[<type>]
系统时间数字或者字符串utc – (默认) (00:00:00 UTC, January 1, 1970)local – 本地时间格式 ‘yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm’zabbix 2.0开始支持带参数
system.run
在制定的主机上运行命令文本command – 命令mode – wait (默认值, 执行超时时间), nowait (不等待) 最大可用返回512KB数据，包含空白数据。命令输出数据必须是文本例如:system.run– 列出/的文件和目录.
备注: 启用这个方法, agent配置文件必须配置 EnableRemoteCommands=1选项
system.stat
虚拟内存状态数字ent - number of processor units this partition is entitled to receive (float)kthr,<type> - information about kernel thread states:r - average number of runnable kernel threads (float)
b - average number of kernel threads placed in the Virtual Memory Manager wait queue (float)
memory,<type> - information about the usage of virtual and real memory:
avm - active virtual pages (integer)
fre - size of the free list (integer)
page,<type> - information about page faults and paging activity:
fi - file page-ins per second (float)
fo - file page-outs per second (float)
pi - pages paged in from paging space (float)
po - pages paged out to paging space (float)
fr - pages freed (page replacement) (float)
sr - pages scanned by page-replacement algorithm (float)
faults,<type> - trap and interrupt rate:
in - device interrupts (float)
sy - system calls (float)
cs - kernel thread context switches (float)
cpu,<type> - breakdown of percentage usage of processor time:
us - user time (float)
sy - system time (float)
id - idle time (float)
wa - idle time during which the system had outstanding disk/NFS I/O request(s) (float)
pc - number of physical processors consumed (float)
ec - the percentage of entitled capacity consumed (float)
lbusy - indicates the percentage of logical processor(s) utilization that occurred while executing at the user and system level (float)
app - indicates the available physical processors in the shared pool (float)
disk,<type> - disk statistics:
bps - indicates the amount of data transferred (read or written) to the drive in bytes per second (integer)
tps - indicates the number of transfers per second that were issued to the physical disk/tape (float)
This item is supported starting from version 1.8.1.
system.sw.arch
返回软件信息字符串范例:system.sw.arch i686数据来自uname方法
Zabbix agent 2.0.开始支持
system.sw.os[<info>]
返回系统信息字符串info – full (default), short ,name范例:system.sw.osUbuntu 2.6.35-28.50-generic 2.6.35.11
信息来自如下文件
– /proc/version
– /proc/version_signature
– /etc/
Zabbix agent version 2.0.开始支持
system.sw.packages[<package>,<manager>,<format>]
已安装软件列表文本值package – all (默认)或者正则表达式manager – all (默认) or a package managerformat – full (默认) ，short范例:system.sw.packages python-minimal, python2.6-minimal, ubuntu-minimal Lists (alphabetically) installed packages whose names match the given package regexp (“all” lists them all).包管理:
manager (执行命令)
dpkg (dpkg –get-selections)
pkgtool (ls /var/log/packages)
rpm (rpm -qa)
pacman (pacman -Q)
如果format 为full, packages are grouped by package managers (each manager on a seperate line beginning with it’s name in square brackets).
如果format为short, 包不分组，并且都列在一行上.
Zabbix agent 2.0开始支持
system.swap.in[<device>,<type>]
交换分区IN（磁盘交换到内存）数字device – 交换分区设备 (默认all)type – 可选值: count (swapins数量), sectors(sectors swapped in), pages (pages swapped in).示例key:system.swap.in[,pages]数据采集自: Linux 2.4: /proc/swaps, /proc/partitions, /proc/stat
Linux 2.6: /proc/swaps, /proc/diskstats, /proc/vmstat
system.swap.out[<device>,<type>]
Swap out (f内存到磁盘)数字device – swap设备 (默认all)type – possible values: count (number of swapouts), sectors(sectors swapped out), pages (pages swapped out). See supported by platformfor details on defaults.示例key:system.swap.out[,pages]数据采集自:
Linux 2.4: /proc/swaps, /proc/partitions, /proc/stat
Linux 2.6: /proc/swaps, /proc/diskstats, /proc/vmstat
system.swap.size[<device>,<type>]
交换分区大小字节或者百分比device – 交换分区 (默认值 all)type – possible values: free (free swap space, default), pfree (free swap space, in percent), pused (used swap space, in percent), total (total swap space), used (used swap space)示例 key:system.swap.size[,pfree]– 空闲swap百分比
老命名格式:
system.swap.free, system.swap.total
system.uname
返回主机相信信息字符串示例值:FreeBSD localhost 4.2-RELEASEFreeBSD 4.2-RELEASE #0: Mon Nov i386
Since Zabbix 2.2.0, the value for this item is obtained by using the uname() system call, whereas previously it was obtained by invoking “uname -a” on Unix systems. Hence, the value of this item might differ from the output of “uname -a” and does not include additional information that “uname -a”
system.uptime
系统运行时长(秒)多少秒使用s/uptime来获取
system.users.num
登陆用户数量多少用户agent使用who命令获取
vfs.dev.read[<device>,<type>,<mode>]
磁盘读取状态整数（如果type为如下）: sectors,operations,bytes 浮点数（如果type为如下）: sps, ops,bpsdevice – 磁盘设备 (默认值 “all”1)type – 可选值: sectors, operations, bytes, sps, ops, bps(必须指定, 不同操作系统下不同). sps, ops, bps stand for: sectors, operations, bytes per second, respectively mode – 可选值: avg1 (一分平均, 默认值), avg5(五分内平均), avg15 (15分内平均值). 备注: 只有type为sps, ops, bps的时候，第三个参数才被支持。不同操作系统的TYPE参数： FreeBSD – bps
Linux – sps
OpenBSD – operations
Solaris – bytes
示例key:vfs.dev.read[,operations]老命名方式: io
Usage of the type parameters ops, bps and sps on supported platforms used to be limited to 8 devices (7 individual devices and one “all”).
Starting with Zabbix 2.0.1 this limit has been increased to 1024 (1023 individual devices and one for “all”).
Zabbix 1.8.6开始支持LVM Until Zabbix 1.8.6, only relative device names may be used (for example, sda), since 1.8.6 an optional /dev/ prefix may be used (for example, /dev/sda)
vfs.dev.write[<device>,<type>,<mode>]
磁盘写入状态整数（如下类型）: sectors,operations,bytes 浮点型（如下类型）: sps, ops,bpsdevice – 磁盘设备 (默认值 “all”1)type – sectors, operations, bytes, sps, ops, bps (must specify exactly which parameter to use, since defaults are different under various OSes). sps, ops, bps means: sectors, operations, bytes per second respectively mode – one of avg1 (default),avg5 (average within 5 minutes), avg15. Note: The third parameter is supported only if the type is in: sps, ops, bps.Default values of ‘type’ parameter for different OSes: FreeBSD – bps Linux – sps OpenBSD – operations Solaris – bytes Example: vfs.dev.write[,operations] Old naming: io The type parameters ops, bps and sps on supported platforms used to be limited to 8 devices (7 individual devices and one “all”). Starting with Zabbix 2.0.1 this limit has been increased to 1024 (1023 individual devices and one for “all”). Supports LVM since Zabbix 1.8.6. Until Zabbix 1.8.6, only relative device names may be used (for example, sda), since 1.8.6 optional /dev/ prefix may be used (for example, /dev/sda)
vfs.file.cksum 下载地址
计算文件校验File checksum, calculated by algorithm used by UNIX cksumfile – 文件完整路径例如，返回值: 1938292000例如:
vfs.file.cksum
老命名规范: cksum
vfs.file.contents 下载地址
获取文本内容Contents of a file or empty string if it is empty or it contains only LF/CR charactersfile – 文件完整路径例如:vfs.file.contents文件不可以超过64KB.
Zabbix agent 2.0开始支持
vfs.file.exists 下载地址
检测文件是否存在1 – 文件/硬链接/软连接文件存在 0 – 不存在file – 文件完整路径例如:vfs.file.exists
vfs.file.md5sum 下载地址
文件MD5校验码文件MD5哈希值file – 完整路径示例返回值:b5052decb577e0fffd622d6ddc017e82 示例:vfs.file.md5sum
1.8.6移除了64MB文件大小的限制
vfs.file.regexp 下载地址
文件中搜索字符串包含字符串的行，或者为空file – 文件完整路径regexp – GNU正则表达encoding – 编码
start line – 从哪一行开始，默认第一行
end line – 从哪一行结束，默认最后一行
output – an optional output formatting template. The \0 escape sequence is replaced with the matched text while an \N(where N=1…9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups). 如果 <output> 为空， 所有包含搜索字符串的行都会被返回
start line和end line从zabbix 2.0开始支持
仅返回首先匹配的行例如:vfs.file.regexp
vfs.file.regexp+)$”,,3,5,\1]
vfs.file.regexp+),,,,\1]
– getting the ID of user zabbix
vfs.file.regmatch 下载地址
文件中搜索字符串0 – 为找到1 – 找到file – 文件完整路径regexp – GNU 正则表达式encoding – 编码
start line – 哪行开始，默认第一行
end line – 哪行结束，默认最后一行 上面两个参数从
2.0版本开始支持。
例如:vfs.file.regmatch
vfs.file.size 下载地址
文件大小字节file – 完整路径zabbix必须有可读此文件的权限例如:vfs.file.size
Zabbix配置
vfs.fs.discovery
列出挂载的文件系统Used for low-level discoveryJSON对象从zabbix agent 2.0开始支持
vfs.fs.inode
inodes数量数字fs – 文件系统mode – total (默认), free, used, pfree (空闲百分比), pused (使用百分比)例如:vfs.fs.inode[/,pfree]老命名规则:
vfs.fs.inode.free , vfs.fs.inode.pfree , vfs.fs.inode.total
Zabbix安装
vfs.fs.size
磁盘空间字节fs – 文件系统mode – total (默认), free, used, pfree (空闲百分比), pused (使用百分比)返回本地文件系统的使用量.例如: vfs.fs.size老命名规则: vfs.fs.free , vfs.fs.total , vfs.fs.used , vfs.fs.pfree , vfs.fs.pused ,*是任意挂载点 开源监控软件
vm.memory.size[<mode>]
内存大小字节或者百分比mode – total (默认), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, wired, used, pused, available, available其中挑一个老命名规则: vm.memory.buffers, vm.memory.cached, vm.memory.free, vm.memory.shared, vm.memory.total监控项vm.memory.size[]允许三种类型的参数
第一类：包含total – 总内存
第二类： 系统指定内存类型:active, anon, buffers, cached, exec, file, free, inactive,pinned, shared, wired.
第三类：用户级别，一共使用了多少内存，还有多少内存可用: used, pused, available,pavailable.
web.page.get
获取网页内容网页源代码host – 主机名/域名path – 文件地址，默认/port – 端口，默认80返回空字符串表示失败.
Zabbix实施
例如:web.page.get[ ,/,80]
web.page.perf
获取完全加载网页消耗的时长秒host – 主机名/域名path – html地址，默认是/port – 端口,默认80返回0表示失败. 例如: web.page.perf[ ,/,80]
web.page.regexp
在网页中搜索字符串The matched string, or as specified by the optional<output>parameter. An empty string if no match was found.host – 主机名path – html文件路径 (默认值 /)port – 端口 (默认80)
regexp – GNU正则表达式
length – 返回的最大的字符串数量
output – 输出格式模板可选项. The \0 escape sequence is replaced with the matched text while an \N(where N=1…9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups). If <output> is left empty – the whole line containing the matched text is returned. The output parameter is supported from version 2.2.
失败则返回空字符 (不匹配).示例:web.page.regexp[ ,index.php,80,OK,2]
vfs.file.time 下载地址
监控软件
文件时间Unix时间戳.file – 文件路径mode - one of modify (default, modification time), access - last access time, change - last change time示例:vfs.file.time
The file size limit depends on large file support.
页:
[1]