一 Items简介
Items是从主机里面获取的所有数据，可以配置获取监控数据的方式、取值的数据类型、获取数值的间隔、历史数据保存时间、趋势数据保存时间、监控key的分组等。
通常情况下item由key+参数组成，如监控项中需要获取cpu信息，则需要一个对应的监控key：system.cpu.load。如果是获取网卡流量，那么获取网卡这个监控项需要key：net.if.in或者net.if.out。监控项的数据保存在Zabbix.items表中，即select * form zabbix.itesm；
一般情况下key要与参数结合起来使用，例如获取5分钟的负载情况：system.cpu.load[avg5]，avg5是对应的参数，如果是1分钟则使用avg1，如果是15分钟则使用avg15，网卡流量net.if.in[eth0]，使用eth0作为参数可以获取到eth0网卡的进入流量，同样看一看换成eth1，eth2等等。
二 Items的添加
Items可以存在于模板(Template)中，也可以存在于主机(Host)中，模板可以复用。
configuration---->Templates---->Templates
#此操作为Templates OS Linux模板创建一个用于监控CPU个数的Items(监控项)，为主机创建监控项可参考此操作。
新建Items
添加相应参数和选项
参数说明
|
属性
|
描述
|
|
Name
|
监控项 item 名称可以使用如下宏变量：
$1, $2…$9，这 9 个参数对应 item key 的参数位置。
例如--Name：Free disk space on $1
item key为"vfs.fs.size[/,free]",那么对应的名称会变成"Free disk space on /"。$1 对应了第一个参数"/"。
|
|
Type
|
item类型(常见 agent/SNMP/agent(active)等)。
|
|
Key
|
监控项item的 key，点击select可以选择系统很多自带key，也可用户自定义的key。
|
|
Type of information
|
获取到的数据类型：
Numeric (unsigned)：无符整型，表示从0开始到2^32-1的所有整数。
Numeric (float)：浮点数
Character：字符串，最长 255 字节
Log：日志文件，key必须为log[].
Text：大小无限制的文本
|
|
Data type
|
获取到整数数据的数据类型：
Boolean：数据为0或者1，true表示1，false为0，不区分大小写。
如下为True和False的定义：
TRUE：true, t, yes, y, on, up, running, enabled, available
FALSE：false, f, no, n, off, down, unused, disabled, unavailable
任何非0数字都被认为是TRUE，0被定义为 FALSE。
Octal：八进制
Decimal：十进制
Hexadecimal：十六进制
zabbix 将会自动把他们转为数字
|
|
Units
|
默认情况下，如果原始值超过1000，则先除以1000然后显示出来。例如，设置
了单位为 bps 并且收到的值为 11102，将会显示为 11.1Kbps
如果单位被指定为 B (byte), Bps (bytes per second) ，那么它会除以 1024 然后再显示数
据。所以大家在监控流量和文件大小的时候不要用错单位，否则会出现数据不一致的
情况。
如下为时间单位:
unixtime – 转为 “ yyyy.mm.dd hh:mm:ss” . 只能使用正数。
uptime – 转为“ hh:mm:ss” 或者“ N days, hh:mm:ss”
例如，收到的值为 881764 秒，他将会显示为“ 10 days, 04:56:04”
s – 转为“ yyy mmm ddd hhh mmm sss ms” ;
例如，收到的值为 881764(单位秒)，他将会被显示为 10d 4h 56m”，只会显示 3 个单元。
有时候只会显示 2 个单元，例如” 1m 5h”（不包含分，秒，毫秒），如果返回的值小于0.001， 则只显示"<1ms" 。
禁用单位：ms/rpm/RPM/%
|
|
Use custom multiplier
|
如果启用这个选项，所有接收到的整数或者浮点数都会乘以这个文本框里面的值。
使用这个选项，zabbix 将会把收到的KB,MBps等数据先转为B,Bps。否则zabbix 不能正
确设置前缀(K,M,G 等)。
|
|
Update interval (in sec)
|
数据更新时间。
注意：如果设置为0，则永久不更新。
|
|
Custom intervals
|
可以创建例外的更新间隔，例如:
Interval:10，Period:1-5,10:00-19:00，表示周一到周五的早上 10 点到晚上 19 点每十秒更新
一次数据。其余时间使用默认值。这边最多只能设置 7 个灵活更新间隔。
注意：1 若设置的多个灵活时间间隔有冲突，则使用最小的时间间隔。
2 如果时间间隔被设置为 0，那么数据永久不会更新，且不能用在 zabbix主动方式的 item
|
|
History storage period (in days)
|
历史记录在数据库中保存时间，过期的历史数据将会删除。
zabbix官方推荐开启后尽量使用一个较短的历史记录。
若需要查看历史数据，可将"趋势历史记录 Keep trends"的保留时间设置长一点。
注意：此值会被全局值(Administrator->General->Housekeeper->History覆盖。
|
|
Trend storage period (in days)
|
趋势数据（以小时为单位min，max，avg，count的数据）在数据库中保留时长，过期数据将会删除。
注意：1 此值会被全局值(Administrator->General->Housekeeper->History覆盖。
2 趋势数据只能存数字类型数据，字符、日志都无法存储。
|
|
Store value
|
As is：数据不作处理
Delta (speed per second)——计算公式为 (value-prev_value)/(time-prev_time)
value：获取到得原始值
value_prev：上一次接收到的值
time：当前时间
prev_time：上次接收数据的时间
一般用于数据增长的类型，例如：网卡流量，每次获取到得都是当前网卡总流量。
比如第一次给的值是 0 字节，第二获获取的为3000字节，则（3000-0）（/31-30），即100 字节/秒
备注：如果当前获取到的值比上一个值更小，则忽略这个值，等待下一次的值
Delta (simple change)——计算公式为 (value-prev_value)
value：获取到得原始值
value_prev：上一次接收到的值
|
|
Show value
|
值映射，需要配置数字映射到字符的映射表。
例如：1=>xhy.cn访问正常。
则key 返回的数据为1时，监控页面显示xhy.cn访问正常。
key返回数据只能为整数，且不做任何修改保存到数据库。仅在显示时才会根据映射表来展示相应的内容。
|
|
Log time format
|
只可以用在 LOG 类型中，支持占位符:
* y: 年(0001-9999)
* M: 月(01-12)
* d: 日(01-31)
* h: 小时(00-23)
* m: 分钟(00-59)
* s: 秒(00-59)如果时间搓留空不会被解析。
例如：
如下为 zabbix agent 日志"23480:20100328:154718.045 Zabbix agent started. Zabbix
1.8.2 (revision 11211)."，前面 6 个字符是PID，后面为日期，时间和日志内容。
日志时间类为"pppppp:yyyyMMdd:hhmmss”。
备注：“ p” 与 ” :” 为占位符，除了“ yMdhms”不能为占位符，其它任意字符都可以作为占位符
|
|
New application
|
创建一个新的应用
|
|
Applications
|
包含多个应用，例如：
cpu、 disk、 network，监控项可以属于多个应用
|
|
Populates host inventory field
|
数据自动填充到 inventory 资产清单的相应属性，前提是inventory 处于自动模式
|
|
Description
|
监控项的描述
|
|
Enabled
|
是否启用这个监控项。
|
注意：[root@imxhy01 ~]# zabbix_get -s 172.24.8.101 -k system.cpu.num可以测试key值是否正确。
三 Items key的添加
3.1 Items key的格式
key名[参数]：key的定义必须遵循如图所示规则，首先验证key名是否合法，若有参数则之后验证key的参数是否合法，若没有参数则跳过。
如：vfs.fs.size[/]或vfs.fs.size[/opt]
3.2 key参数
key可接参数分为引号字符串、非银引号字符串和数组。
- 引号字符串：若参数是引号字符串，可为任意字符串，若存在双引号，必须用反斜杠进行转移。
- 非引号字符串参数：除逗号、方括号外的其他字符都能引用。、
- 数组：如果key的参数是一个数组，用逗号将各参数分开。
|
属性
|
描述
|
|
quoted string
|
带引号字符串
|
|
unquoted string
|
不带引号字符串
|
|
array
|
数组
|
3.3 key的名称定义注意项
- key名称的取值范围如下：
- 所有的数字(0~9)；
- 所有的小写字母(a~z)；
- 所有的大写字母(A~Z)；
- 下划线(_)；
- 破折号(——)；
- 点(.)。
四 用户自定义key
注意：强烈建议将用户自定义的参数(UserParameter)写入新的配置文件，然后在原配置文件中引用，便于维护和管理。
4.1 自定义参数语法格式
UserParameter=key，command
UserParameter=key[*]，command $1 $2 $3……
|
参数
|
描述
|
|
key
|
Items key具有唯一性，定义[*]可以接受参数
|
|
command
|
Zabbix将[]中的参数传递给命令中的$1……$9，将值作为命令的一部分
|
注意：1 自定义key对特殊字符如".*?$!&;()<>#@等，默认情况下无法处理，需要在/etc/zabbix/zabbix_agentd.confabbix中开启参数。
UnsafeUserParameters=1
2 自定义参数可以返回文本(character/log/text)和空值，若返回的是一个无效值，则显示ZBX_NOTSUPPORTED。
4.2 自定义参数实例
1 [root@imxhy01 ~]# vi /etc/zabbix/zabbix_agentd.conf #编辑原配置文件
2 UnsafeUserparameters=1 #开启对特殊字符的处理
3 Include=/etc/zabbix/zabbix_agentd.d/*.conf #开启子配置文件
4 [root@imxhy01 ~]# vi /etc/zabbix/zabbix_agentd.d/my.conf #新增子配置文件
5 UserParameter=get.os.type, cat /etc/redhat-release #新增获取系统的Items key
6 UserParameter=wc[*], grep -c "$2" $1 #新增统计的Items key
7 [root@imxhy01 ~]# systemctl restart zabbix-agent.service #重启agent服务
8 [root@imxhy01 ~]# zabbix_get -s 172.24.8.100 -k get.os.type
9 Red Hat Enterprise Linux Server release 7.0 (Maipo)
10 [root@imxhy01 ~]# zabbix_get -s 172.24.8.100 -k wc[/etc/passwd,root]
2
4.3 配置自定义key总结
- 自定义key的语法；
- 特殊字符的处理开启；
- 子配置文件的注意事项；
- 多Agent则需要每个agent客户端分别配置。
4.4 配置定义key步骤
1.Agent配置文件修改
2.子配置文件配置相应key
3.重启服务测试key
4.用zabbix_agentd查看key是否被支持
1 [root@imxhy01 ~]# zabbix_agentd -p | grep get.os
2 get.os.type [t|Red Hat Enterprise Linux Server release 7.0
5.在Web界面添加相应的Items，注意数据类型的选择。
