1 创建监控项

概述

要在Zabbix管理页面创建一个监控项,请执行以下操作:

  • 进入到: 数据采集主机
  • 在主机所在的行单击 监控项
  • 点击屏幕右上角的创建监控项
  • 在表单中输入监控项的参数

你也可以如此创建监控项:打开一个已有的监控项,按克隆 按钮,然后以不同的名称保存。

配置

监控项 选项卡包含通用的 监控项 属性。

所有必填输入字段都标有红色星号。

参数 描述
Name 监控项 名称。
支持 User macros
Type 监控项 类型。参见各个 item type 部分。
Key 监控项 键(最多2048个字符)。
支持的 item keys 可在各个 监控项 类型部分中找到。
键在单个主机内必须唯一。
如果键类型是 'Zabbix agent','Zabbix agent(主动)' 或 '简单检查',键值必须由 Zabbix agent 或 Zabbix server 支持。
另见:正确的 key format
Type of information 执行转换后存储在数据库中的数据类型。
数字(无符号) - 64位无符号 integer。
请注意,如果为 整数监控项 接收到浮点值,其小数部分将被截断。
数字(float) - 64位浮点数。
此类型将允许大约15位的精度,范围从大约 -1.79E+308 到 1.79E+308(PostgreSQL 11 and earlier versions 除外)。
也支持以科学记数法接收值。例如 1.23E+7,1e308,1.1E-4。
字符 - 短文本数据。
日志 - 带有可选日志相关属性(时间戳,来源,严重性,logeventid)的长文本数据。
文本 - 长文本数据。另见 text data limits
二进制 - 二进制数(仅支持依赖 监控项)。二进制数将在 最新数据 中解析为静态的“二进制值” string;{监控项.VALUE},{监控项.LASTVALUE} 和表达式宏将解析为 UNKNOWN。
对于返回特定格式数据的 监控项 键,将自动选择匹配的信息类型。
Host interface 选择主机接口。此字段在主机级别编辑 监控项 时可用。
Units 如果设置了单位符号,Zabbix 将对收到的 监控项 值应用后处理,并以指定的单位后缀显示。
支持的单位符号及其特殊格式(以及收到的 监控项 值 → 显示值示例):
B - 字节(1024 → 1 KB)
Bps - 每秒字节(1024 → 1 KBps)
s - 秒,使用最多三个最大的非零时间单位显示(881764 → 10d 4h 56m)
uptime - 以 hh:mm:ss 或 N 天,hh:mm:ss 格式显示的经过时间(881764 → 10 天,04:56:04)
unixtime - Unix 时间戳,格式为 yyyy.mm.dd hh:mm:ss(881764 → 1970-01-11 04:56:04 AM);为了正确格式化,收到的 监控项 值必须是 数字(无符号)
对于其他单位(如 Hz,W 等),如果接收到的值超过 1000,它将被除以 1000 并以相应的前缀显示(5000 → 5 KHz,881764 → 881.76 KW)。
如果单位符号前缀为 !,单位转换和前缀添加将被禁用(1024 !B → 1024 B,61 !s → 61 s)。
有关单位符号和单位转换的更多示例和详细信息,请参见 Item value suffixes
Update interval 每 N 秒为该 监控项 获取新值。允许的最大更新间隔为 86400 秒(1 天)。
Time suffixes更新间隔 字段中受支持,例如,30s,1m,2h,1d。
User macros 受支持。
单个宏必须填满整个字段。字段中的多个宏或与文本混合的宏不受支持。
注意:更新间隔只能设置为 '0',如果存在具有非零值的自定义间隔。如果设置为 '0',并且存在具有非零值的自定义间隔(灵活或计划),则 监控项 将在自定义间隔期间被轮询。
注意,在 监控项 变为活动状态或更新间隔更改后,第一次 监控项 轮询可能会早于配置的值。
新 监控项 将在创建后 60 秒内进行检查,除非它们具有调度或灵活更新间隔,并且 更新间隔 设置为 0。
可以通过点击 立即执行 button 立即轮询现有被动 监控项 的值。
Custom intervals 您可以为检查 监控项 创建自定义规则:
灵活 - 创建 更新间隔 的例外(具有不同频率的间隔)。
调度 - 创建自定义轮询时间表。
有关详细信息,请参见 Custom intervals
Time suffixes间隔 字段中受支持,例如,30s,1m,2h,1d。
User macros 受支持。
单个宏必须填满整个字段。字段中的多个宏或与文本混合的宏不受支持。
Timeout 设置 监控项 检查超时(适用于 supported 监控项 类型)。选择超时选项:
全局 - 使用 proxy/全局超时(在灰色的 超时 字段中显示)。
覆盖 - 使用自定义超时(在 超时 字段中设置;允许范围:1 - 600s)。支持 Time suffixes,例如 30s,1m,以及 user macros
点击 超时 链接允许您配置 proxy 超时或 global 超时(如果未使用 proxy)。请注意,超时 链接仅对 超级管理员 类型的用户可见,且具有对 管理General管理Proxies 前端部分的权限。
History 选择以下任一选项:
不存储 - 不存储 监控项 历史记录。对于仅需要存储依赖 监控项 历史记录的主 监控项 很有用。
此设置无法被全局 housekeeper settings 覆盖。
存储至 - 指定在数据库中存储详细历史记录的时长(1 小时至 25 年)。更旧的数据将被 housekeeper 清除。以秒为单位存储。
Time suffixes 受支持,例如,2h,1d。User macros 受支持。
存储至 值可以在 管理 → Housekeeping 中全局覆盖。
如果存在全局覆盖设置,将显示橙色 信息图标。如果将鼠标定位在其上,将显示警告消息,例如,由全局 housekeeper 设置覆盖 (1d)
建议将记录的值保留尽可能短的时间,以减少数据库中值历史记录的大小。可以存储趋势的更长数据,而不是存储值的长历史记录。
另见 History and trends
Trends 选择以下任一选项:
不存储 - 不存储趋势。
此设置无法被全局 housekeeper settings 覆盖。
存储至 - 指定在数据库中存储聚合(每小时 min,max,avg,count)历史记录的时长(1 天至 25 年)。更旧的数据将被 housekeeper 清除。以秒为单位存储。
Time suffixes 受支持,例如,24h,1d。User macros 受支持。
存储至 值可以在 管理 → Housekeeping 中全局覆盖。
如果存在全局覆盖设置,将显示橙色 信息图标。如果将鼠标定位在其上,将显示警告消息,例如,由全局 housekeeper 设置覆盖 (7d)
注意:对于非数字数据 - 字符,日志和文本 - 不支持存储趋势。
另见 History and trends
Value mapping 为该 监控项 应用值映射。Value mapping 不会更改收到的值,仅用于显示数据。
它适用于 数字(无符号)数字(float)字符 监控项。
例如,“Windows 服务状态”。
Log time format 仅适用于类型为 日志 的 监控项。支持的占位符:
y年(1970-2038)
M月(01-12)
d日(01-31)
h小时(00-23)
m分钟(00-59)
s秒(00-59)
如果留空,时间戳将被设置为 Unix 时间的 0,代表 1970 年 1 月 1 日。
例如,考虑以下行来自 Zabbix agent 日志文件:
" 23480:20100328:154718.045 Zabbix agent 启动。Zabbix 1.8.2(修订版 11211)。"
它以六个字符位置的 PID 开始,后面是日期,时间,以及消息的其余部分。
此行的日志时间格式将是 "pppppp:yyyyMMdd:hhmmss"。
请注意,“p”和“:”字符是占位符,可以是除“yMdhms”之外的任何字符。
Populates host inventory field 您可以选择一个主机清单字段,监控项 的值将填充该字段。如果为该主机启用了自动 inventory 填充,这将起作用。
如果 信息类型 设置为 '日志',则此字段不可用。
Description 输入 监控项 描述。User macros 受支持。
Enabled 选中标记以启用 监控项,以便进行处理。
Latest data 点击链接查看 监控项 的最新数据。
此链接仅在编辑现有 监控项 时可用。

监控项 类型特定字段在 corresponding pages 中描述。

在主机级别编辑现有 template 级别 监控项 时,多个字段为只读。您可以使用表单标题中的链接并转到模板级别进行编辑,同时请记住,模板级别的更改将更改链接到该模板的所有主机的 监控项。

标签 选项卡允许定义 监控项 级别的 tags

监控项值预处理

预处理 选项卡允许为接收到的值定义转换规则

测试

要执行项目测试,请确保服务器和代理上的系统时间已 同步。如果服务器时间落后,监控项测试可能会返回错误消息“任务已过期”。但是,在服务器和代理上设置不同的时区不会影响测试结果。

可以对监控项进行测试,如果配置正确,则可以返回实际值。测试甚至可以在保存监控项之前进行。

可以对主机和模板的监控项、监控项原型和低级别自动发现规则进行测试。活动的监控项不能被测试。

监控项测试可用于以下被动式监控项:

  • Zabbix agent
  • SNMP agent (v1, v2, v3)
  • IPMI agent
  • SSH checks
  • Telnet checks
  • JMX agent
  • Simple checks(除了监控项 icmpping*, vmware.*
  • Zabbix internal
  • Calculated items
  • External checks
  • Database monitor
  • HTTP agent
  • Script

要测试监控项,请单击监控项配置表单底部的测试按钮。请注意,对于无法测试的监控项(例如简单检查之外的其它主动检查),测试按钮将被禁用。

监控项测试表单包含主机参数(主机IP地址、端口、使用服务器/代理(代理名称)进行测试)和监控项相关的详情(如SNMPv2的团体名或SNMPv3的安全凭据)所需的字段。这些字段是上下文相关的:

  • 所需的参数值会尽可能预填充,例如,对于需要agent的监控项,所需信息就会从主机下所选的agent接口传递过来
  • 模板内的监控项的相关参数需要手动填充
  • 纯文本宏的值会被解析
  • 值(或部分值)为密码或Vault宏的字段为空,必须手动输入。如果监控项参数中存在加密宏值,则会显示如下警告信息:“监控项包含用户定义的带有密码的宏。这些宏的值应该手动输入。”
  • 在特定的监控项类型上下文中,不需要的字段会被禁用(例如,在可计算类型的监控项中主机地址字段和proxy字段被禁用)

要测试监控项,点击 获取值。如果成功获取到值,它会自动填充进对应的 Value(值)字段,将当前值(如果有的话)移动到 Previous value(前一次值)字段,同时计算Prev. time(前一次)字段,即两个值(两次测试)之间的时间差,并尝试检测EOL序列,若在接收到的值中检测到“\n\r”时切换到CRLF。

从主机检索的值和测试结果在发送到前端时被截断为最大 512KB。如果结果被截断,则会显示警告图标。鼠标悬停时会显示警告描述。请注意,大于 512KB 的数据仍会由 Zabbix 服务器完全处理。

如果配置不正确,则返回错误提示,并描述可能的原因。

从主机接收成功的值也可以用于测试预处理步骤

表单按钮

表单底部的按钮允许执行多项操作。

添加项目。此按钮仅适用于新项目。
更新项目的属性。
根据当前项目的属性创建另一个项目。
立即执行对新项目值的检查。仅支持被动检查(请参阅更多详细信息)。
请注意,立即检查值时,配置缓存不会更新,因此值不会反映项目配置的最新更改。
通过获取值来测试项目配置是否正确。
删除项目历史记录和趋势。
删除项目。
取消编辑物品属性。

文本数据限制

文本数据限制取决于后端数据库。在将文本值存储到数据库之前,它们会被截断以符合数据库值类型限制:

数据库 信息类型
Character(字符) Log(日志) Text(文本)
MySQL 255 字符 65536 字节 65536 字节
PostgreSQL 255 字符 65536 字符 65536 字符
Oracle 255 字符 65536 字符 65536 字符
SQLite (仅限 Zabbix proxy) 255 字符 65536 字符 65536 字符

自定义脚本的限制

可用的自定义脚本长度取决于使用的数据库:

数据库 字符限制 字节限制
MySQL 65535 65535
PostgreSQL 65535 无限制
Oracle 数据库 2048 4000
SQLite(仅Zabbix proxy) 65535 无限制

不支持的 监控项

不支持的 监控项 将被报告为具有 Not supported 状态,并且仍会按照其标准 [LINK_34b2a781] 进行重新检查。

当由于某种原因(例如,连接错误,未配置轮询器来处理 监控项)无法检索其值时,监控项 将变为不支持状态。此外,未接收历史数据的 监控项 会保持在 Not supported 状态。这是预期行为—只有当 监控项 接收到新的、有效的历史数据时,它才会转换为 Normal 状态。

与问题一样,只有在接收到新数据时,不支持的 监控项 才会被重新评估—即使该 监控项 再也没有可用的历史数据。换句话说,监控项 和触发器仅在接收到新数据时改变其状态。但是,如果触发器表达式包含 [LINK_de9ae509] 和/或 [LINK_8fb97f08] 函数,触发器将每 30 秒重新计算一次(详细信息请参见 [LINK_d4cc13ee])。