zabbix 内置key说明

原文参考：https://blog.csdn.net/whs_321/article/details/52939263

一、简介

Zabbix 内置了很多丰富的key，使得我们在添加linux os模板的时候，已经帮我们把key给定义好，这样我们就能够直接链接模板就可以使用了。

或者在自定义模板时也可以使用内置key；
当我们内置key可以采集到数据的时候，最好就用内置key，而不是自己去自定义；

内置key的官方文档：
https://www.zabbix.com/documentation/3.0/manual/config/items/itemtypes/zabbix_agent#supported_item_keys

二、内置key

agent.hostname

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

使用方式列举：后面使用的方式是一样的：

[root@BJ-monitor-h-01 bin]# ./zabbix_get -s 192.168.10.100 -k agent.hostname
Zabbix server

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

---------------------------------------------------------------------
agent.version     
  zabbix agent版本字符串

---------------------------------------------------------------------
kernel.maxfiles     
  系统支持最大的open files整数

---------------------------------------------------------------------
kernel.maxproc     
  系统支持最大的进程数量整数

---------------------------------------------------------------------
log[file,     
监控日志文件     
file - 文件详细路径     
regexp - 正则     
encoding - 编码     
maxlines - zabbix agent向server或者proxy发送最大的行数。   
这个参数覆盖配置文件zabbxi_agentd.conf中的’MaxLinesPerSecond’  mode - 可选值:all (默认), skip (跳过处理老数据).mode参数从2.0版本开始支持

output - 可选项，输出格式模板.

示例: log[/var/log/syslog] log[/var/log/syslog,error] log[/home/zabbix/logs/logfile,,,100]

---------------------------------------------------------------------
logrt[file_pattern,     
Monitoring of log file with log rotation support.     
file_pattern - 文件绝对路径

---------------------------------------------------------------------
net.if.discovery

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

---------------------------------------------------------------------
net.if.in[if,     
网卡入口流量整数.     

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

示例keys: net.if.in[eth0,errors] net.if.in[eth0]

---------------------------------------------------------------------
net.if.out[if,      
网卡出口流量（参数参见net.if.in）

---------------------------------------------------------------------
net.if.total[if,     
网卡进/出流量的总和（参数参见net.if.in）

---------------------------------------------------------------------
net.tcp.listen[port]      
检测端口是否开启0 – （not listen） 1 –  in LISTEN stateport      示例: net.tcp.listen[80]

---------------------------------------------------------------------
net.tcp.port[

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

范例: net.tcp.port[,80] 检测web服务器端口是否运行中

---------------------------------------------------------------------
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 - 端口 (默认情况为标准端口号)     
示例key: net.tcp.service.perf[ssh]

---------------------------------------------------------------------
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 - 端口 (默认情况为标准端口号)

示例key: net.tcp.service[ftp,,45]

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

示例keys: proc.mem[,root] – root的进程消耗了多少内存     
proc.mem[zabbix_server,zabbix] – zabbix用户运行的zabbix_server使用了多少内存     
proc.mem[,oracle,max,oracleZABBIX]

---------------------------------------------------------------------
proc.num[      
某用户某些状态的进程的数量进程数量      
name - 进程名称 (默认“all processes”)      
user - 用户名 (默认 “all users”)      
state - 可用值: all (默认), run,sleep, zomb      
cmdline - 命令行过滤(正则表达时)      
示例keys: proc.num[,mysql] – MySQL用户运行的进程数量       
proc.num[apache2,www-data] – www-data运行了多少个apache2进程       
proc.num[,oracle,sleep,oracleZABBIX]

备注：Windows系统只支持name和user两个参数

---------------------------------------------------------------------
system.boottime     
系统启动的时间戳整数.unix时间戳

---------------------------------------------------------------------
system.cpu.intr      
设备中断整数

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

范例key: system.cpu.load[,avg5]

---------------------------------------------------------------------
system.cpu.num[     
CPU数量处理器个数type - 可用值: online (默认值), max范例: system.cpu.num   

---------------------------------------------------------------------
system.cpu.switches     
上下文交换交换次数老命名方式: system[switches]

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

范例key: system.cpu.util[0,user,avg5]

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

---------------------------------------------------------------------
system.hw.cpu[     
返回CPU信息字符/数字     
cpu - cpu数量或者all (默认)     
info - full (默认), curfreq, maxfreq, model 或者vendor     
例如: system.hw.cpu[0,vendor] AuthenticAMD 从/proc/cpuinfo、   /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq获取信息.
 如果指定了CPU数量和    curfreq或者maxfreq, 将会返回数值(Hz).   

---------------------------------------------------------------------
system.hw.devices[

列出PCI或者USB文本值

type - pci (默认) or usb

范例: system.hw.devices[pci] 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge [..] 返回lspci或者lsusb (不带参数)

---------------------------------------------------------------------
system.hw.macaddr[

列出MAC地址字符串

interface - all (默认) 或者正则表达式

format - full (默认) 、short

范例: system.hw.macaddr["eth0$",full] [eth0] 00:11:22:33:44:55 列出指定接口mac地址 如果format指定为short，MAC地址相同的将会被忽略掉

---------------------------------------------------------------------
system.localtime[

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

---------------------------------------------------------------------
system.run[command,

在指定的主机上运行命令文本

command - 命令

mode - wait (默认值, 执行超时时间), nowait (不等待)最大可用返回512KB数据，包含空白数据。 命令输出数据必须是文本

例如: system.run[“ls -l /”] – 列出/的文件和目录.

Note: 启用这个方法, agent配置文件必须配置 EnableRemoteCommands=1选项

---------------------------------------------------------------------
system.sw.arch

返回软件信息字符串

范例: system.sw.arch

---------------------------------------------------------------------
system.sw.os[

返回系统信息字符串

info - full (default), short ,name

范例: system.sw.os[short] Ubuntu 2.6.35-28.50-generic 2.6.35.11

信息来自如下文件：

/proc/version [short]

/proc/version_signature [name]

/etc/issue.net

---------------------------------------------------------------------
system.sw.packages[

已安装软件列表文本值

package - all (默认)或者正则表达式

manager - all (默认) or a package manager

format - full (默认) ，short

范例: system.sw.packages[http]

---------------------------------------------------------------------
system.swap.in[

交换分区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[

Swap out (f内存到磁盘) .数字

device - swap设备 (默认all)

type - count (number of swapouts), sectors(sectors swapped out), pages (pages swapped out). 示

例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 - 交换分区 (默认值 all)

type - 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)

示例 system.swap.size[,pfree] – 空闲swap百分比   

---------------------------------------------------------------------
system.uname

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

---------------------------------------------------------------------
system.uptime

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

---------------------------------------------------------------------
system.users.num

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

---------------------------------------------------------------------
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

示例key: vfs.dev.read[,operations]

---------------------------------------------------------------------
vfs.dev.write[

磁盘写入状态整数，

device - 磁盘设备 (默认 all)  type - sectors, operations, bytes, sps, ops, bps

mode - one of avg1 (default),avg5 , avg15.

example: vfs.dev.write[,operations] Old naming: io

---------------------------------------------------------------------
vfs.file.cksum[file]

计算文件校验 UNIX cksum.

file - 文件完整路径

---------------------------------------------------------------------
vfs.file.contents[file,

获取文本内容若为空，只返回 LF/CR characters.

file - 文件完整路径

例如: vfs.file.contents[/etc/passwd] 文件不可以超过64KB.    

---------------------------------------------------------------------
vfs.file.exists[file]

检测文件是否存在1 – 存在 0 – 不存在     file - 文件完整路径

---------------------------------------------------------------------
vfs.file.md5sum[file]

文件MD5校验码文件MD5哈希值

file - 完整路径

---------------------------------------------------------------------
vfs.file.regexp[file,regexp,

文件中搜索字符串包含字符串的行，或者为空

file - 文件完整路径

regexp - GNU正则表达式

encoding - 编码

start line - 从哪一行开始，默认第一行

end line - 从哪一行结束，默认最后一行

如: vfs.file.regexp[/etc/passwd,zabbix]     
vfs.file.regexp[/path/to/some/file,”([0-9]+)$”,,3,5,\1]     
vfs.file.regexp[/etc/passwd,^zabbix:.:([0-9]+),,,,\1]

---------------------------------------------------------------------
vfs.file.regmatch[file,regexp,

文件中搜索字符串0 – 未找到 1 – 找到

file - 文件完整路径

regexp - GNU 正则表达式

encoding - 编码

start line - 哪行开始，默认第一行

end line - 哪行结束，默认最后一行

例如: vfs.file.regmatch[/var/log/app.log,error]

---------------------------------------------------------------------
vfs.file.size[file]

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

---------------------------------------------------------------------
vfs.file.time[file,

文件时间信息Unix 时间戳.

mode -  modify (默认, 修改时间), access – 最后访问时间, change – 最后改变时间

例如: vfs.file.time[/etc/passwd,modify] 备注：文件大小有限制

---------------------------------------------------------------------
vfs.fs.discovery

列出挂载的文件系统 用于lld.JSON对象

---------------------------------------------------------------------
vfs.fs.inode[fs,

inodes数量数字

fs - 文件系统

mode - total (默认), free, used, pfree (空闲百分比), pused (使用百分比)

例如: vfs.fs.inode[/,pfree]

---------------------------------------------------------------------
vfs.fs.size[fs,

磁盘空间，返回本地文件系统的使用量字节

fs - 文件系统

mode -  total (默认), free, used, pfree (空闲百分比), pused (使用百分比).

例如: vfs.fs.size[/tmp,free]   

---------------------------------------------------------------------
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.

---------------------------------------------------------------------
web.page.get[host,

获取网页内容网页源代码

host - 主机名/域名

path - 文件地址，默认/

port - 端口，默认80返回空字符串表示失败. 例如: web.page.get[

---------------------------------------------------------------------
web.page.perf[host,

获取完全加载网页消耗的时长秒，返回0表示失败

host - 主机名/域名

path - html地址，默认是/

port - 端口,默认80     [root@BJ-monitor-h-01 bin]# ./zabbix_get -s 192.168.10.100 -k web.page.perf[www.baidu.com]

---------------------------------------------------------------------
web.page.regexp[host,

在网页中搜索字符串  失败则返回空字符 (不匹配).

host - 主机名

path - html文件路径 (默认值 /)

port - 端口 (默认80)

regexp - GNU正则表达式

length - 返回的最大的字符串数量

output - 输出格式模板可选项.