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]

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，注意数据类型的选择。