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 自定义参数实例
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]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.05.在Web界面添加相应的Items，注意数据类型的选择。
