1 创建 监控项

概述

要在 Zabbix 前端中 create 一个 监控项，请执行以下操作：

• 转到：数据收集 → 主机
• 点击 监控项 在 主机 的行中
• 点击屏幕右上角的 创建监控项
• 在表单中输入监控项的参数

您也可以通过打开一个现有的create并按下 术语_447b7147来创建一个新的监控项。 克隆 按钮，然后以不同的名称保存。

配置

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

所有必填字段均以红色星号标记。

参数	描述
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及更早版本的数值浮点数据类型范围除外）。 支持科学计数法数值输入，例如：1.23E+7、1e308、1.1E-4. 字符 - 短文本数据。 日志 - 带日志相关属性（时间戳、来源、严重程度、日志事件ID）的长文本数据。 文本 - 长文本数据。另见文本数据限制。 二进制 - 二进制数值（仅支持依赖型监控项）。二进制数值在最新数据中会解析为静态"binary value"string；{ITEM.VALUE}、{ITEM.LASTVALUE}及表达式宏将解析为UNKNOWN。 对于仅返回特定格式数据的监控项键值，系统会自动选择匹配的信息类型。
Host interface	选择 主机 接口。该字段仅在 主机 级别编辑 监控项 时可用。
Units	若设置了单位符号，Zabbix会对接收到的监控项值进行后处理，并显示带指定单位后缀的数值。 支持特殊格式化的单位符号（接收的监控项值→显示值示例）： B - 字节（1024 → 1 KB） Bps - 字节每秒（1024 → 1 KBps） s - 秒，使用最多三个最大的非零时间单位显示（881764 → 10天4小时56分） 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）。 更多单位符号和单位转换的示例及细节，请参阅监控项值后缀。
Update interval	每N秒为此监控项获取新值。允许的最大update间隔为86400秒（1天）。 支持Time suffixes格式，例如30s、1m、2h、1d。 支持User macros。 单个宏必须填满整个字段，不支持字段中包含多个宏或宏与文本混合的情况。 注意：仅当存在非零值的自定义间隔时，update间隔才能设置为'0'。若设置为'0'且存在非零值的自定义间隔（弹性或计划间隔），则会在自定义间隔期间轮询监控项。 注意：监控项激活后或update间隔变更后的首次监控项轮询可能早于配置值。 新建的监控项将在创建后60秒内被检查，除非它们具有计划或弹性update间隔且更新间隔设置为0。 可通过点击立即执行按钮立即轮询现有被动监控项的值。
Custom intervals	您可以为检查监控项配置create自定义规则： 灵活性 - 为更新间隔（不同频率的间隔）create例外规则。 调度功能 - create自定义轮询计划。 详细信息请参阅Custom intervals。 间隔字段支持Time suffixes，例如30秒、1分钟、2小时、1天。 支持User macros。 单个宏必须填满整个字段，不支持在字段中使用多个宏或宏与文本混合使用。
Timeout	设置监控项检查超时（适用于超时类型的监控项）。选择超时选项： 全局 - 使用proxy/全局超时（显示在灰色超时字段中）。 覆盖 - 使用自定义超时（在超时字段中设置；允许范围：1 - 600秒）。支持Time suffixes格式，例如30s、1m以及user macros。 点击超时链接可配置配置超时或超时超时（若未使用proxy）。注意：超时链接仅对具有管理→General或管理→Proxies前端模块访问权限的超级管理员类型用户可见。
History	选择以下任一方式： 不存储 - 不保存监控项历史记录。适用于主监控项，当仅需依赖监控项保留历史时使用。 此设置不能被全局管家settings覆盖。 存储期限 - 指定数据库中保留详细历史记录的时长（1小时至25年）。更早的数据将被管家清除。以秒为单位存储。 支持Time suffixes格式，例如2h、1d。支持User macros格式。 存储期限值可在管理 → Housekeeping中进行全局覆盖。 若存在全局覆盖设置，将显示橙色信息图标。鼠标悬停时将显示警告信息，例如已被全局管家设置覆盖（1d）。 建议尽可能缩短记录值的保存时间以减少数据库中值历史的大小。与其存储长期的值历史，不如存储更长时间的趋势数据。 另见History and trends。
Trends	选择以下任一选项： 不存储 - 不存储趋势数据。 此设置无法被全局管家settings覆盖。 存储期限 - 指定在数据库中保留聚合（每小时最小值、最大值、平均值、计数）历史数据的时长（1天至25年）。较早的数据将被管家清除。以秒为单位存储。 支持Time suffixes格式，例如24h、1d。支持User macros格式。 存储期限值可在管理 → Housekeeping中全局覆盖。 若存在全局覆盖设置，将显示橙色信息图标。将鼠标悬停其上时，会显示警告消息，例如被全局管家设置覆盖（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日志file中的以下行： " 23480:20100328:154718.045 Zabbix agent已启动。Zabbix 1.8.2（修订版11211）。" 该行以6个字符位置的PID开头，后接日期、时间和消息其余部分。 此行对应的日志时间格式应为"pppppp:yyyyMMdd:hhmmss"。 注意"p"和":"字符是占位符，可以是除"yMdhms"外的任意字符。
Populates host inventory field	您可以选择 一个主机 资产字段，监控项 的值将自动填充到该字段。此功能仅在 主机 启用了自动 inventory 填充时生效。 若信息类型设置为 '日志'，则该字段不可用。
Description	输入监控项描述。支持User macros。
Enabled	勾选此复选框以启用监控项，使其被处理。
Latest data	点击链接查看监控项的最新数据。 该链接仅在编辑已存在的监控项时可用。

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

监控项 值预处理

预处理选项卡允许为接收到的值定义transformation rules。

测试

可以测试一个监控项，如果配置正确，get真实的 返回值中的值。测试甚至可以在保存监控项之前进行。

测试可用于主机和模板监控项、监控项原型以及 低级发现规则。不支持对主动监控项进行测试。

监控项测试可用于以下被动监控项类型：

• Zabbix agent
• SNMP agent（v1、v2、v3）
• IPMI agent
• SSH检查
• Telnet检查
• JMX agent
• 简单检查（除 icmpping*、vmware.* 监控项 外）
• Zabbix 内部
• 计算型 监控项
• 外部检查
• 数据库监控器
• HTTP agent
• 脚本
• 浏览器

要测试一个监控项，点击监控项底部的测试按钮 配置表单。请注意，测试按钮将被禁用。 无法测试的监控项（如主动检查、排除的简单检查） 检查）。

监控项测试表单包含必填主机参数字段（主机 地址、端口，使用server/proxy（proxy名称）进行测试）以及监控项特定细节（例如 SNMPv2团体名或SNMPv3安全凭证）。这些字段是 上下文感知

• 这些值在可能的情况下会预先填充，例如对于需要监控项的情况 agent，通过从选定的agent接口获取信息 的主机
• 这些值需要为模板 监控项 手动填写
• 纯文本宏值会被解析
• 字段值为机密信息或Vault（部分或全部） 宏为空，需要手动输入。如果有任何监控项 参数包含一个秘密宏值时，将显示以下警告 显示消息：“监控项包含带有机密信息的用户自定义宏” 这些宏的值需要手动输入。
• 这些字段在 监控项 上下文中不需要时会禁用 类型（例如，主机地址字段和proxy字段被禁用） 对于计算型 监控项）

要测试监控项，请点击获取值。如果成功获取到值 成功时，它将填充值字段，替换当前值 （如有）填入前值字段，同时计算前值 time*字段，即两个值（点击）之间的时间差 并尝试检测EOL序列，若检测到则切换为CRLF 检索值中的"\n\r"。

从一个主机获取的数值及测试结果在发送至前端时会被截断至最大512KB。 如果结果被截断，则会显示警告图标。 鼠标悬停时显示警告描述。 请注意，超过512KB的数据仍会由Zabbix server完整处理。

如果配置不正确，将显示错误消息 描述可能的原因。

从主机成功获取的值也可用于测试 测试。

表单按钮

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

	添加一个监控项。此按钮仅适用于新建的监控项。
	更新一个监控项的属性。
	基于当前监控项的属性创建另一个监控项。
	立即执行对新的监控项值的检查。仅支持被动检查（参见more details）。 注意：在立即检查值时，configuration cache不会更新，因此该值不会反映监控项配置的最新更改。
	通过获取值来测试监控项配置是否正确。
	删除监控项的历史记录和趋势数据。
	删除该监控项。
	取消对监控项属性的编辑。

文本数据限制

文本数据限制取决于数据库后端。在将文本值存储到数据库之前，它们会通过 get 截断以匹配数据库值类型的限制：

自定义脚本限制

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

不支持的监控项

不支持的 监控项 会报告为具有 Not supported 状态，并且仍会按照其标准的 配置 进行重新检查。

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

与问题类似，不支持的 监控项 仅在接收到新数据时才会重新评估 —— 即使该 监控项 不再有任何历史数据可用。换句话说，监控项 和触发器仅在接收到新数据时才会改变其状态。然而，如果触发器表达式包含 date and time 和/或 nodata() 函数，则该触发器将每隔 30 秒重新计算一次（详细信息请参见 计算时间）。