要在Zabbix前端create一个监控项,请执行以下操作:
您也可以通过打开现有的监控项并按下create来执行此操作 克隆按钮,然后以不同名称保存。
监控项 选项卡包含通用的 监控项 属性。
所有必填字段均以红色星号标记。
参数 | 描述 |
---|---|
Name | 监控项 名称. |
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及更早版本的数值浮点数据类型范围除外)。 同时支持接收科学计数法表示的值,例如:1.23E+7、1e308、1.1E-4。 字符型 - 短文本数据 日志型 - 带可选日志属性(时间戳、来源、严重程度、日志事件ID)的长文本数据 文本型 - 长文本数据(参见文本数据限制) 对于仅返回特定格式数据的监控项监控项,系统会自动选择匹配的信息类型。 |
Host interface | 选择 主机 界面。当在 主机 级别编辑 监控项 时,此字段可用。 |
Units | 若设置了单位符号,Zabbix会对接收值进行后处理并显示带有所设单位后缀的值。 默认情况下,若原始值超过1000,则除以1000后显示。例如,若设置bps并收到值881764,将显示为881.76 Kbps。 以下单位会进行特殊处理:B、Bps、unixtime、uptime、s。 JEDEC memory标准用于处理B(字节)、Bps(字节/秒)单位,这些值会除以1024。因此,若单位设为B或Bps,Zabbix将显示: 1为1B/1Bps 1024为1KB/1KBps 1536为1.5KB/1.5KBps 若使用以下时间相关单位会进行特殊处理: unixtime - 转换为"yyyy.mm.dd hh:mm:ss"。要正确转换,接收值必须是Numeric (unsigned)信息类型。 uptime - 转换为"hh:mm:ss"或"N天, hh:mm:ss" 例如,若收到值881764(秒),将显示为"10天, 04:56:04" s - 转换为"yyy年 mmm月 ddd天 hhh时 mmm分 sss秒 ms毫秒";参数被视为秒数。 例如,若收到值881764(秒),将显示为"10天 4时 56分" 仅显示3个主要单位层级,如"1月 15天 5时"或"2时 4分 46秒"。若无天数可显示,则仅显示两个层级 - "1月 5时"(不显示分钟、秒或毫秒)。若值小于0.001,将转换为"< 1毫秒"。 注意:若单位前缀为 ! ,则不会对监控项值应用单位前缀/处理。参见防止单位转换。 |
Update interval | 每N秒为此监控项获取新值。允许的最大update间隔为86400秒(1天)。 支持Time suffixes,例如30s、1m、2h、1d。 支持User macros。 单个宏必须填满整个字段。不支持字段中包含多个宏或宏与文本混合的情况。 注意:仅当存在非零值的自定义间隔时,update间隔才能设置为'0'。如果设置为'0'且存在非零值的自定义间隔(灵活或计划),则会在自定义间隔期间轮询监控项。 注意:监控项激活后或update间隔更改后的首次监控项轮询可能早于配置值发生。 可通过点击立即执行按钮立即轮询现有被动监控项的值。 |
Custom intervals | 您可以create自定义规则来检查监控项: 灵活 - 为更新间隔(不同频率的间隔)create一个例外 调度 - create自定义轮询计划. 详细信息请参阅Custom intervals. 间隔字段支持Time suffixes,例如30s、1m、2h、1d. 支持User macros. 单个宏必须填满整个字段。不支持在字段中使用多个宏或将宏与文本混合. 调度功能自Zabbix 3.0.0起支持. 注意: 主动检查的自定义间隔仅由Zabbix agent 2支持. |
History storage period | 选择以下任一选项: 不保留历史记录 - 监控项 历史数据将不被存储。适用于主 监控项 仅需依赖 监控项 保留历史记录的场景。 此设置不受全局管家 管家服务 覆盖。 存储周期 - 指定详细历史数据在数据库中保留的时长(1小时至25年)。更早的数据将被管家清理。以秒为单位存储。 支持 Time suffixes 格式,例如 2h, 1d。支持 User macros 格式。 存储周期 值可在 管理 → 常规 → 管家服务 中进行全局覆盖。 若存在全局覆盖设置,将显示橙色 ![]() 建议尽可能缩短记录值的保留时间以减少数据库中历史值的大小。相较于长期保留详细历史值,可改为保留更长时间的趋势数据。 另见 History and trends。 |
Trend storage period | 选择以下任一选项: 不保留趋势数据 - 不存储趋势数据。 此设置无法被全局管家管家服务覆盖。 存储周期 - 指定在数据库中保留聚合(每小时最小值、最大值、平均值、计数)历史数据的时长(1天至25年)。更旧的数据将由管家删除。以秒为单位存储。 支持Time suffixes格式,例如24h、1d。支持User macros格式。 存储周期值可在管理 → 常规 → 管家服务中全局覆盖。 若存在全局覆盖设置,将显示橙色 ![]() 注意: 趋势保留不适用于非数值数据——字符型、日志型和文本型。 另见History and trends。 |
Value mapping | 对此监控项应用值映射。Value mapping不会改变接收到的值,仅用于数据显示。 它适用于无符号数值、数值(float)和字符监控项。 例如"Windows服务状态"。 |
Log time format | 仅适用于类型为Log的监控项. 支持的占位符: * y: 年(1970-2038) * M: 月(01-12) * d: 日(01-31) * h: 时(00-23) * m: 分(00-59) * s: 秒(00-59) 如果留空, 时间戳将被设置为Unix时间的0, 即1970年1月1日. 例如, 考虑file中Zabbix agent日志的以下行: " 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)." 它以六个字符位置的PID开头, 后跟日期、时间和消息的其余部分. 此行的日志时间格式应为"pppppp:yyyyMMdd:hhmmss". 请注意"p"和":"字符是占位符, 可以是除"yMdhms"之外的任何字符. |
Populates host inventory field | 您可以选择 一个主机 资产字段,监控项 的值将填充该字段。当 主机 启用了自动 inventory 填充功能时此设置生效。 若信息类型设置为 '日志' 则该字段不可用。 |
Description | 输入 监控项 描述。支持 User macros。 |
Enabled | 勾选复选框以启用监控项,使其能够被处理。 |
Latest data | 点击链接查看监控项的最新数据。 此链接仅在编辑已存在的监控项时可用。 |
监控项类型的特定字段描述见corresponding pages。
编辑现有 template 级别 监控项 在 一个主机 级别上 表单中的部分字段为只读。您可以使用表单标题中的链接 并前往模板层级并在该处编辑它们,需谨记 模板级别的更改将改变所有监控项的主机 该模板所关联的。
Tags标签页允许定义监控项级别的 tags.
预处理选项卡允许为接收到的值定义transformation rules。
为确保进行监控项测试,需保证服务器与proxy的系统时间时间同步。 当服务器时间滞后时,监控项测试可能会返回错误消息"任务已过期"。 在服务器和proxy上设置不同的时区不会影响测试结果。
可以测试一个监控项,如果配置正确,get真实的 返回值中的值。测试甚至可以在保存监控项之前进行。
测试可用于主机和模板监控项、监控项原型以及 低级发现规则。主动式监控项不支持测试功能。
监控项 测试可用于以下被动 监控项 类型:
icmpping*
、vmware.*
监控项 外)要测试一个监控项,点击监控项底部的Test按钮 配置表单。请注意,Test按钮将被禁用 无法测试的监控项(如主动检查、排除简单 检查)。
监控项测试表单包含必填主机参数字段(主机 地址、端口、proxy名称/无proxy)以及监控项特定细节(例如 SNMPv2团体或SNMPv3安全凭证). 这些字段是 上下文感知
这些值在可能的情况下会预先填充,例如对于需要监控项的情况 agent,通过从选定的agent接口获取信息 的 主机
这些值需要为模板监控项手动填写
纯文本宏值会被解析
字段值为机密信息或Vault(部分或全部)的情况 宏为空且需要手动输入。如果任何监控项 参数包含一个秘密宏值,将显示以下警告 显示消息: "监控项 包含带有秘密信息的用户自定义宏" 这些宏的值需要手动输入。
这些字段在监控项的上下文中不需要时会禁用
type (e.g., the host address field and the proxy field are disabled for calculated items)
要测试监控项,点击Get value。如果成功获取到值 成功时,它将填充Value字段,移动当前值 (如有)到Previous value字段,同时计算Prev. time 字段,即两个值(点击)之间的时间差 并尝试检测EOL序列,若检测到则切换为CRLF 检索值中的"\n\r"。
如果配置不正确,将显示错误消息 描述可能的原因。
从主机成功检索到的值也可用于测试 测试.
表单底部的按钮允许执行多种操作。
![]() |
添加一个监控项。此按钮仅对新监控项可用。 |
![]() |
更新监控项的属性。 |
![]() |
基于当前监控项的属性创建另一个监控项。 |
![]() |
立即执行新监控项值的检查。仅支持被动检查(参见more details)。 注意:当立即检查值时,configuration cache不会更新,因此该值不会反映监控项配置的最新更改。 |
![]() |
通过获取值来测试监控项配置是否正确。 |
![]() |
删除监控项的历史数据和趋势数据。 |
![]() |
删除监控项。 |
![]() |
取消编辑监控项属性。 |
文本数据限制取决于数据库后端。在将文本值存储到数据库之前,它们会被get截断以匹配数据库值类型限制:
数据库 | 信息类型 | ||
---|---|---|---|
Character | 日志 | 文本 | |
MySQL | 255 characters | 65536字节 | 65536字节 |
PostgreSQL | 255 characters | 65536字符 | 65536字符 |
Oracle | 255 characters | 65536字符 | 65536字符 |
SQLite (仅Zabbix proxy) |
255 characters | 65536字符 | 65536字符 |
可用自定义脚本长度取决于所使用的数据库:
数据库 | 字符数限制 | 字节数限制 |
---|---|---|
MySQL | 65535 | 65535 |
Oracle Database | 2048 | 4000 |
PostgreSQL | 65535 | 无限制 |
SQLite (仅Zabbix proxy) | 65535 | 无限制 |
不受支持的监控项会被报告为不支持状态,并仍按其标准配置进行重新检查。
当监控项的值因某些原因无法获取时(例如连接错误、未配置轮询器处理该监控项),它将变为不受支持状态。此外,未接收历史数据的监控项会保持不支持状态。这是预期行为——只有当监控项接收到新的有效历史数据时,才会转为正常状态。
与问题类似,不受支持的监控项仅在接收到新数据时重新评估——即使该监控项不再有可用的历史数据。换句话说,监控项和触发器仅在接收到新数据时改变状态。然而,如果触发器表达式包含date and time和/或nodata()函数,则该触发器会每30秒重新计算一次(详见计算时间)。