zabbix agent 类型所有key
引用 :http://www.ttlsa.com/zabbix/zabbix-agent-types-and-all-keys/zabbix服务器端通过与zabbix agent通信来获取客户端服务器的数据,agent分为两个版本,其中一个是主动一个是被动,在配置主机我们可以看到一个是agent,另一个是agent(active)。前者为被动检测,后者为主动检测。那么主动和被动区别在哪里呢?
被动:zabbix server向zabbix agent讨要数据。
主动:zabbix agent提交数据给zabbix server。
监控项keys列表
以下表格是zabbix agent所支持的所有.请大家一一过目,认识他们就行,不需要背下来。
Key
描述
返回值
参数
详细说明
agent.hostname
返回被监控端名称
字符串
-
返回配置文件中配置的被监控端的名称
agent.ping
检测被监控端是否存活
1 – 运行中其他 –未运行
-
使用函数 nodata()检测客户端是否正在运行
agent.version
zabbix agent版本
字符串
-
例如返回: 1.8.2
kernel.maxfiles
系统支持最大的open files
整数
kernel.maxproc
系统支持最大的进程数量
整数
log
监控日志文件
Log.
file –文件详细路径 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 emptystring 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
Monitoring of log file with log rotation support.
Log.
file_pattern –文件绝对路径 regexp – regular expression describing the required content pattern encoding – code page identifiermaxlines – maximum number of newlines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of ‘MaxLinesPerSecond’ inzabbix_agentd.conf mode – possible values:all (default), skip (skipprocessing of older data). The mode parameter is supported from version 2.0. output – an optional output formatting template. The \0 escape sequence is replaced with the matched text while an \N(whereN=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 typesexcept ‘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 onWindows)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.record type的可选值: 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)开始支持Zabbix2.0 之前的命名方式: net.tcp.dns(目前依旧支持)
net.if.collisions
Out-of-window collision.
Number of collisions. Integer.
if –网卡
net.if.discovery
列出网卡.通常用于低级别的discovery.
JSON对象
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 – it is not 1 – it is in LISTEN state
port – TCP port number
示例: net.tcp.listen linux下得zabbixagent 1.8.4开始支持
net.tcp.port[<ip>,port]
是否可以连接到指定的TCP端口
0 – cannot connect 1 – can connect
ip – IP地址(默认是 127.0.0.1) port –端口
范例: net.tcp.port[,80]检测web服务器端口是否运行中 老命名方式: check_port
[*]
简单的TCP性能检测:
net.tcp.service.perf不同的服务检测会有不同的响应数据
net.tcp.service
检测服务是否开启,并且端口可用
0 – 服务挂了 1 –服务运行中
service –如下:ssh, ntp, ldap, smtp, ftp, http, pop, nntp,imap, tcp, https, telnet ip –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 thetelnet check looks for a prompt (‘:’ at the end). 老命名方式: check_service_perf
[*]注意:that before Zabbix 1.8.3 version service.ntp shouldbe used instead of ntp. Zabbix 2.0支持 https和telnet服务
net.udp.listen
检测UDP端口是否在监听
0 – it is not 1 – it is in LISTEN state
port – udp端口
范例: net.udp.listen linux系统的Zabbix agent version 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 oraclehaving 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 →www.zabbix.com on Windows: system.hostname →WIN-SERV2008-I6system.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权限,因为这些信息是从内存中读取的。Zabbixagent version 2.0 开始支持
system.hw.cpu[<cpu>,<info>]
返回CPU信息
字符/数字
cpu – cpu数量或者all (默认) info –full (默认), curfreq, maxfreq, model或者vendor
例如: system.hw.cpu AuthenticAMD从/proc/cpuinfo、/sys/devices/system/cpu//cpufreq/cpuinfo_max_freq获取信息.如果指定了CPU数量和 curfreq或者maxfreq,将会返回数值(Hz). Zabbix agent version 2.0开始支持
system.hw.devices[<type>]
列出PCI或者USB
文本值
type – pci (默认) or usb
范例: system.hw.devices 00:00.0 Host bridge: Advanced Micro Devices RS780 Host Bridge [..]返回lspci或者lsusb (不带参数) Zabbix agent version 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 version 2.0开始支持
system.localtime[<type>]
系统时间.
数字或者字符串
utc – (默认)(00:00:00 UTC, January 1, 1970) local –本地时间格式 ‘yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm’ supported from version 2.0开始支持带参数
system.run
在制定的主机上运行命令
文本
command –命令 mode – wait (默认值,执行超时时间), nowait (不等待)
最大可用返回512KB数据,包含空白数据。命令输出数据必须是文本例如: system.run – 列出/的文件和目录. Note:启用这个方法, 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-outsper 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-replacementalgorithm (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/Orequest(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 occurredwhile 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 version 2.0.开始支持
system.sw.os[<info>]
返回系统信息
字符串
info – full (default), short ,name
范例: system.sw.os Ubuntu 2.6.35-28.50-generic 2.6.35.11信息来自如下文件 – /proc/version – /proc/version_signature – /etc/issue.net Zabbix agent version 2.0.开始支持
system.sw.packages[<package>,<manager>,<format>]
已安装软件列表
文本值
package – all (默认)或者正则表达式 manager –all (默认) or a package manager format – 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 (freeswap 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-RELEASE FreeBSD 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 previouslyit 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” prints based on other sources.
system.uptime
系统运行时长(秒)
多少秒
使用s/uptime来获取
system.users.num
登陆用户数量
多少用户
agent使用who命令获取
vfs.dev.read[<device>,<type>,<mode>]
磁盘读取状态
整数(如果type为如下): sectors,operations,bytes 浮点数(如果type为如下): sps, ops,bps
device –磁盘设备 (默认值 “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 maybe 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,bps
device –磁盘设备 (默认值 “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 respectivelymode – 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 Zabbix1.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 cksum.
file –文件完整路径
例如,返回值: 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 characters.
file –文件完整路径
例如: vfs.file.contents文件不可以超过64KB.Zabbix agent version 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(whereN=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从zabbix2.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
vfs.file.time
文件时间信息
Unix 时间戳.
file –文件完整路径 mode –modify (默认,修改时间), access –最后访问时间, change –最后改变时间
例如: vfs.file.time备注:文件大小有限制
vfs.fs.discovery
列出挂载的文件系统 Used for low-level discovery.
JSON对象
从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
[*]
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
返回空字符串表示失败.例如: web.page.get
web.page.perf
获取完全加载网页消耗的时长
秒
host –主机名/域名 path – html地址,默认是/ port –端口,默认80
返回0表示失败.例如: web.page.perf
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 exceedsthe 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.regexpphp,80,OK,2]
页:
[1]