013.Zabbix的Items(监控项)

一 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 自定义参数实例

[root@imxhy01 ~]# vi /etc/zabbix/zabbix_agentd.conf		#编辑原配置文件
 UnsafeUserparameters=1					#开启对特殊字符的处理
Include=/etc/zabbix/zabbix_agentd.d/*.conf			#开启子配置文件
[root@imxhy01 ~]# vi /etc/zabbix/zabbix_agentd.d/my.conf	#新增子配置文件
 UserParameter=get.os.type, cat /etc/redhat-release		#新增获取系统的Items key
 UserParameter=wc[*], grep -c "$2" $1			#新增统计的Items key
[root@imxhy01 ~]# systemctl restart zabbix-agent.service	#重启agent服务
[root@imxhy01 ~]# zabbix_get -s 172.24.8.100 -k get.os.type
Red Hat Enterprise Linux Server release 7.0 (Maipo)
[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是否被支持

[root@imxhy01 ~]# zabbix_agentd -p | grep get\.os
get.os.type			[t|Red Hat Enterprise Linux Server release 7.0

5.在Web界面添加相应的Items，注意数据类型的选择。