要在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 中全局覆盖。 如果存在全局覆盖设置,将显示橙色 ![]() 建议将记录的值保留尽可能短的时间,以减少数据库中值历史记录的大小。可以存储趋势的更长数据,而不是存储值的长历史记录。 另见 History and trends。 |
Trends | 选择以下任一选项: 不存储 - 不存储趋势。 此设置无法被全局 housekeeper settings 覆盖。 存储至 - 指定在数据库中存储聚合(每小时 min,max,avg,count)历史记录的时长(1 天至 25 年)。更旧的数据将被 housekeeper 清除。以秒为单位存储。 Time suffixes 受支持,例如,24h,1d。User macros 受支持。 存储至 值可以在 管理 → Housekeeping 中全局覆盖。 如果存在全局覆盖设置,将显示橙色 ![]() 注意:对于非数字数据 - 字符,日志和文本 - 不支持存储趋势。 另见 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。
预处理 选项卡允许为接收到的值定义转换规则 。
要执行项目测试,请确保服务器和代理上的系统时间已 同步。如果服务器时间落后,监控项测试可能会返回错误消息“任务已过期”。但是,在服务器和代理上设置不同的时区不会影响测试结果。
可以对监控项进行测试,如果配置正确,则可以返回实际值。测试甚至可以在保存监控项之前进行。
可以对主机和模板的监控项、监控项原型和低级别自动发现规则进行测试。活动的监控项不能被测试。
监控项测试可用于以下被动式监控项:
icmpping*
, vmware.*
)要测试监控项,请单击监控项配置表单底部的测试按钮。请注意,对于无法测试的监控项(例如简单检查之外的其它主动检查),测试按钮将被禁用。
监控项测试表单包含主机参数(主机IP地址、端口、使用服务器/代理(代理名称)进行测试)和监控项相关的详情(如SNMPv2的团体名或SNMPv3的安全凭据)所需的字段。这些字段是上下文相关的:
要测试监控项,点击 获取值。如果成功获取到值,它会自动填充进对应的 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])。