1 支持的宏

概述

该表格包含Zabbix支持的全部宏的完整列表开箱即用

要查看某个位置支持的所有宏（例如，在"地图URL"中，您可以将位置名称粘贴到搜索框内浏览器窗口底部（可通过按CTRL+F访问）并执行搜索 next。

宏	支持范围	描述
{ACTION.ID}	→ 基于触发器的通知和命令 → 问题 update 通知和命令 → 基于服务的通知和命令 → 服务 update 通知和命令 → 发现通知和命令 → 自动注册通知和命令 → 内部通知	触发动作的数字ID。
{ACTION.NAME}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 发现通知和命令 → 自动注册通知和命令 → 内部通知	触发操作的名称
{ALERT.MESSAGE}	→ 告警脚本参数	来自动作配置的'默认消息'值自3.0.0版本起支持。
{ALERT.SENDTO}	→ 告警脚本参数	来自用户媒介配置的'发送至'值。自3.0.0版本起支持。
{ALERT.SUBJECT}	→ 告警脚本参数	来自动作配置的'默认主题'值自3.0.0版本起支持。
{DATE}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 发现通知和命令 → 自动注册通知和命令 → 内部通知 → 手动事件操作scripts	当前日期，格式为yyyy.mm.dd.
{DISCOVERY.DEVICE.IPADDRESS}	→ 发现通知与命令	被发现设备的IP地址始终可用，不依赖于是否添加主机。
{DISCOVERY.DEVICE.DNS}	→ 发现通知与命令	被发现设备的DNS名称. 始终可用，不依赖于是否添加主机。
{DISCOVERY.DEVICE.STATUS}	→ 发现通知与命令	被发现设备状态: 可为UP或DOWN.
{DISCOVERY.DEVICE.UPTIME}	→ 发现通知与命令	自特定设备发现状态上次变更以来的时间，精确到秒。例如：1小时29分01秒。对于状态为DOWN的设备，此值表示其停机时长。
{DISCOVERY.RULE.NAME}	→ 发现通知与命令	发现设备或服务存在/不存在的发现规则名称.
{DISCOVERY.SERVICE.NAME}	→ 发现通知与命令	被发现服务的名称例如: HTTP.
{DISCOVERY.SERVICE.PORT}	→ 发现通知与命令	被发现服务的端口例如: 80.
{DISCOVERY.SERVICE.STATUS}	→ 发现通知与命令	已发现服务状态: 可为UP或DOWN.
{DISCOVERY.SERVICE.UPTIME}	→ 发现通知与命令	特定服务自上次发现状态变更以来的时间，精确到秒。例如：1小时29分01秒。对于状态为DOWN的服务，此即其停机时长。
{ESC.HISTORY}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 内部通知	升级历史。先前发送消息的日志。显示先前发送的通知、发送时所处的升级步骤及其状态（已发送、进行中或失败）。
{EVENT.ACK.STATUS}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 手动事件操作scripts	事件的确认状态(是/否).
{EVENT.AGE}	→ 基于触发器的通知与命令 → 问题update通知与命令 → 基于服务的通知与命令 → 服务update通知与命令 → 服务恢复通知与命令 → 自动发现通知与命令 → 自动注册通知与命令 → 内部通知 → 手动事件操作scripts	触发动作的事件存在时长，精确到秒级适用于升级消息场景
{EVENT.DATE}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 发现通知和命令 → 自动注册通知和命令 → 内部通知 → 手动事件操作scripts	触发操作的事件日期
{EVENT.DURATION}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 内部通知 → 手动事件操作scripts	事件持续时间（问题事件与恢复事件之间的时间差），精确到秒。在问题恢复消息中非常有用。自5.0.0版本起支持。
{EVENT.ID}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 发现通知和命令 → 自动注册通知和命令 → 内部通知 → 触发器URL → 手动事件操作scripts	触发操作的事件数字ID.
{EVENT.NAME}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 内部通知 → 手动事件操作scripts	触发操作的问题事件名称自4.0.0版本起支持。
{EVENT.NSEVERITY}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 手动事件操作scripts	事件严重程度的数值. 可能的值: 0 - 未分类, 1 - 信息, 2 - 警告, 3 - 一般, 4 - 高, 5 - 灾难. 自4.0.0版本起支持.
{EVENT.OBJECT}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 发现通知和命令 → 自动注册通知和命令 → 内部通知 → 手动事件操作scripts	事件object的数值. 可能的值: 0 - 触发器, 1 - 发现的主机, 2 - 发现的服务, 3 - 自动注册, 4 - 监控项, 5 - 低级发现规则. 自4.4.0版本起支持.
{EVENT.OPDATA}	→ 基于触发器的通知和命令 → 问题 update 通知和命令 → 手动事件操作 scripts	问题底层触发器的操作数据自4.4.0版本起支持。
{EVENT.RECOVERY.DATE}	→ 问题 recovery notifications 和命令 → 问题 update 通知和命令（如果发生恢复） → 服务恢复通知和命令 → 手动事件操作 scripts（如果发生恢复）	恢复事件的日期.
{EVENT.RECOVERY.ID}	→ 问题 recovery notifications 和命令 → 问题 update 通知和命令（如果发生恢复） → 服务恢复通知和命令 → 手动事件操作 scripts（如果发生恢复）	恢复事件的数字ID。
{EVENT.RECOVERY.NAME}	→ 问题 recovery notifications 与命令 → 问题 update 通知与命令（若恢复发生） → 服务恢复通知与命令 → 手动事件操作 scripts（若恢复发生）	恢复事件的名称自4.4.1版本起支持。
{EVENT.RECOVERY.STATUS}	→ 问题 recovery notifications 和命令 → 问题 update 通知和命令（如果发生恢复） → 服务恢复通知和命令 → 手动事件操作 scripts（如果发生恢复）	恢复事件的文本值。
{EVENT.RECOVERY.TAGS}	→ 问题 recovery notifications 与命令 → 问题 update 通知与命令（若恢复发生） → 服务恢复通知与命令 → 手动事件操作 scripts（若恢复发生）	以逗号分隔的恢复事件标签列表。若无标签存在，则扩展为空 string。自3.2.0版本起支持。
{EVENT.RECOVERY.TAGSJSON}	→ 问题 recovery notifications 与命令 → 问题 update 通知与命令（若恢复发生） → 服务恢复通知与命令 → 手动事件操作 scripts（若恢复发生）	包含事件标签事件标签的 JSON array。若无标签则扩展为空 array。自 5.0.0 版本起支持。
{EVENT.RECOVERY.TIME}	→ 问题 recovery notifications 与命令 → 问题 update 通知与命令（若恢复发生） → 服务恢复通知与命令 → 手动事件操作 scripts（若恢复发生）	恢复事件的时间。
{EVENT.RECOVERY.VALUE}	→ 问题 recovery notifications 和命令 → 问题 update 通知和命令（如果已发生恢复） → 服务恢复通知和命令 → 手动事件操作 scripts（如果已发生恢复）	恢复事件的数值。
{EVENT.SEVERITY}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 手动事件操作scripts	事件严重级别名称自4.0.0版本起支持。
{EVENT.SOURCE}	→ 基于触发器的通知与命令 → 问题update通知与命令 → 基于服务的通知与命令 → 服务update通知与命令 → 服务恢复通知与命令 → 发现通知与命令 → 自动注册通知与命令 → 内部通知 → 手动事件操作scripts	事件源的数值表示. 可能取值: 0 - 触发器, 1 - 发现, 2 - 自动注册, 3 - 内部, 4 - 服务. 自4.4.0版本起支持.
{EVENT.STATUS}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 内部通知 → 手动事件操作scripts	触发操作的事件的文本描述值.
{EVENT.TAGS}	→ 基于触发器的通知与命令 → 问题update通知与命令 → 基于服务的通知与命令 → 服务update通知与命令 → 服务恢复通知与命令 → 手动事件操作scripts	以逗号分隔的事件标签列表。若标签不存在则扩展为空string。自3.2.0版本起支持。
{EVENT.TAGSJSON}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 手动事件操作scripts	包含事件标签事件标签的JSONarray. 若无标签存在则扩展为空array. 自5.0.0版本起支持.
{EVENT.TAGS.<tag name>}	→ 基于触发器的通知和命令 → 问题 update 通知和命令 → 基于服务的通知和命令 → 服务 update 通知和命令 → 服务恢复通知和命令 → Webhook媒介类型URL名称和URL → 手动事件操作 scripts	通过标签名引用的事件标签值包含非字母数字字符（包括非英语多字节UTF字符）的标签名应使用双引号包裹。引号内的引号和反斜杠必须使用反斜杠进行转义。自4.4.2版本起支持。
{EVENT.TIME}	→ 基于触发器的通知与命令 → 问题update通知与命令 → 基于服务的通知与命令 → 服务update通知与命令 → 服务恢复通知与命令 → 自动发现通知与命令 → 自动注册通知与命令 → 内部通知 → 手动事件操作scripts	触发动作的事件发生时间.
{EVENT.UPDATE.ACTION}	→ 问题 update 通知与命令	在 problem update 期间执行的人类可读动作名称。解析为以下值：已确认、已评论、严重性从(原严重级别)变更为(更新后严重级别) 以及已关闭（取决于单次 update 中执行了多少个动作）。自4.0.0版本起支持。
{EVENT.UPDATE.DATE}	→ 问题 update 通知和命令 → 服务 update 通知和命令	事件 update 日期（确认等）。已弃用名称：{ACK.DATE}
{EVENT.UPDATE.HISTORY}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 手动事件操作scripts	问题更新日志（确认等操作）已弃用名称：{EVENT.ACK.HISTORY}
{EVENT.UPDATE.MESSAGE}	→ 问题 update 通知与命令	问题 update 消息. 已弃用名称: {ACK.MESSAGE}
{EVENT.UPDATE.NSEVERITY}	→ 服务 update 通知与命令	问题 update 操作期间设置的新事件严重性数值。
{EVENT.UPDATE.SEVERITY}	→ 服务 update 通知与命令	问题 update 操作期间设置的新事件严重性级别名称.
{EVENT.UPDATE.STATUS}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 手动事件操作scripts	问题update状态的数值. 可能取值: 0 - 因问题/恢复事件调用Webhook, 1 - 更新操作. 自4.4.0版本起支持.
{EVENT.UPDATE.TIME}	→ 问题 update 通知与命令 → 服务 update 通知与命令	事件 update 时间（确认等操作）已弃用名称：{ACK.TIME}
{EVENT.VALUE}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 基于服务的通知和命令 → 服务update通知和命令 → 服务恢复通知和命令 → 内部通知 → 手动事件操作scripts	触发操作的事件数值（1表示问题，0表示恢复）。
{FUNCTION.VALUE}	→ 基于触发器的通知和命令 → 问题 update 通知和命令 → 手动事件操作 scripts → 事件名称	事件发生时触发器表达式中第N个基于监控项的函数结果仅计算以/主机/key作为第一个参数的函数。该宏可使用数字索引（例如{FUNCTION.VALUE<1-9>}）指向触发器表达式中的第一个、第二个、第三个等函数。参见索引宏。注意在Zabbix 6.0.35之前，{FUNCTION.VALUE}不受支持；请改用{FUNCTION.VALUE1}。
{FUNCTION.RECOVERY.VALUE}	→ 问题 recovery notifications 与命令 → 问题 update 通知与命令 → 手动事件操作 scripts	事件发生时恢复表达式中第N个基于监控项的函数结果仅统计以/主机/key作为首个参数的函数。该宏可通过数字索引使用，例如{FUNCTION.RECOVERY.VALUE<1-9>}指向触发器表达式中的第一、第二、第三等函数。参见索引宏。注意在Zabbix 6.0.35之前版本中不支持{FUNCTION.RECOVERY.VALUE}，请改用{FUNCTION.RECOVERY.VALUE1}。
{HOST.CONN}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 内部通知 → 地图元素标签、地图URL名称和值 → 监控项键参数¹ → 主机接口IP/DNS → Trapper监控项的"允许主机"字段 → 数据库监控附加参数 → SSH和Telnet脚本 → JMX监控项端点字段 → Web监控⁴ → 低级发现规则过滤正则表达式 → 动态URL仪表板小部件的URL字段 → 触发器名称、事件名称、操作数据和描述 → 触发器URL → 宏支持 → 脚本类型监控项、监控项原型和发现规则参数名称及值 → HTTPagent类型监控项、监控项原型和发现规则字段： URL、query字段、请求体、头部、SSL证书file、SSL密钥file、允许主机 → 手动主机操作scripts（包括确认文本） → 手动事件操作scripts（包括确认文本） → 监控项值小部件的描述 → 列配置小部件中文本数据类型的列	主机IP地址或DNS名称，取决于主机设置² 可使用数字索引如{主机.CONN<1-9>}指向触发器表达式中的第一个、第二个、第三个等主机。参见索引宏。
{HOST.DESCRIPTION}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 内部通知 → 地图元素标签 → 手动事件操作scripts → 监控项值小部件的描述 → 列配置小部件中数据类型为文本的列	主机描述. 该宏可使用数字索引（例如{主机.DESCRIPTION<1-9>}）指向触发器表达式中的第一个、第二个、第三个等主机。参见索引宏。
{HOST.DNS}	→ 基于触发器的通知与命令 → 问题update通知与命令 → 内部通知 → 地图元素标签、地图URL名称及值 → 监控项键值参数¹ → 主机接口IP/DNS → Trapper监控项的"Allowed 主机"字段 → 数据库监控附加参数 → SSH与Telnet脚本 → JMX监控项端点字段 → 网络监控⁴ → 低级发现规则过滤正则表达式 → 动态URL仪表板小工具的URL字段 → 触发器名称、事件名称、操作数据及描述 → 触发器URL → 宏支持 → 脚本类型监控项、监控项原型及发现规则参数名称与值 → HTTPagent类型监控项、监控项原型及发现规则字段： URL、query字段、请求体、请求头、SSL证书file、SSL密钥file、Allowed 主机 → 手动主机操作scripts（含确认文本） → 手动事件操作scripts（含确认文本） → 监控项数值小工具描述 → 列配置小工具中文本数据类型的列	主机DNS名称² 该宏可使用数字索引（如{主机.DNS<1-9>}）指向触发器表达式中的第一、第二、第三个等主机。参见索引宏。
{HOST.HOST}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 自动注册通知和命令 → 内部通知 → 监控项键参数 → 地图元素标签、地图URL名称和值 → 主机接口IP/DNS → Trapper监控项的"允许主机"字段 → 数据库监控附加参数 → SSH和Telnet脚本 → JMX监控项端点字段 → Web监控⁴ → 低级发现规则过滤器正则表达式 → 动态URL仪表板小部件的URL字段 → 触发器名称、事件名称、操作数据和描述 → 触发器URL → 宏支持 → 脚本类型监控项、监控项原型和发现规则参数名称及值 → HTTPagent类型监控项、监控项原型和发现规则字段： URL、query字段、请求体、头部、SSL证书file、SSL密钥file、允许主机 → 手动主机操作scripts（包括确认文本） → 手动事件操作scripts（包括确认文本） → 监控项值小部件的描述 → 列配置小部件中文本数据类型的列	主机名. 此宏可与数字索引一起使用，例如{主机.主机<1-9>}指向触发器表达式中的第一个、第二个、第三个等主机。参见索引宏。 `{HOSTNAME<1-9>}`已弃用。
{HOST.ID}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 内部通知 → 地图元素标签、地图URL名称和值 → 动态URL仪表板小工具的URL字段 → 触发器URL → 宏支持 → 手动事件操作scripts → 监控项值小工具的描述 → 列配置小工具中文本数据类型的列	主机 ID. 可与数字索引一起使用，如{主机.ID<1-9>}，指向触发器表达式中的第一个、第二个、第三个等主机。参见索引宏。
{HOST.IP}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 自动注册通知和命令 → 内部通知 → 地图元素标签、地图URL名称和值 → 监控项键参数¹ → 主机接口IP/DNS → Trapper监控项的"允许主机"字段 → 数据库监控附加参数 → SSH和Telnet脚本 → JMX监控项端点字段 → Web监控⁴ → 低级发现规则过滤器正则表达式 → 动态URL仪表板小工具的URL字段 → 触发器名称、事件名称、操作数据和描述 → 触发器URL → 宏支持 → 脚本类型监控项、监控项原型和发现规则参数名称及值 → HTTPagent类型监控项、监控项原型和发现规则字段： URL、query字段、请求体、头部、SSL证书file、SSL密钥file、允许主机 → 手动主机操作scripts（包括确认文本） → 手动事件操作scripts（包括确认文本） → 监控项值小工具的描述 → 列配置小工具中文本数据类型的列	主机IP地址² 该宏可使用数字索引（例如{主机.IP<1-9>}）指向触发器表达式中的第一、第二、第三个等主机。参见索引宏 `{IPADDRESS<1-9>}`已弃用
{HOST.METADATA}	→ 自动注册通知与命令	主机元数据. 仅用于主动式 agent 自动注册。
{HOST.NAME}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 内部通知 → 地图元素标签、地图URL名称和值 → 监控项键参数 → 主机接口IP/DNS → Trapper监控项的"允许主机"字段 → 数据库监控附加参数 → SSH和Telnet脚本 → Web监控⁴ → 低级发现规则过滤正则表达式 → 动态URL仪表板小工具的URL字段 → 触发器名称、事件名称、操作数据和描述 → 触发器URL → 宏支持 → 脚本类型监控项、监控项原型和发现规则参数名称及值 → HTTPagent类型监控项、监控项原型和发现规则字段： URL、query字段、请求体、头部、SSL证书file、SSL密钥file、允许主机 → 手动主机操作scripts（包括确认文本） → 手动事件操作scripts（包括确认文本） → 监控项值小工具的描述 → 列配置小工具中文本数据类型的列	可见主机名该宏可使用数字索引，例如{主机.NAME<1-9>}指向触发器表达式中的第一个、第二个、第三个等主机。参见索引宏。
{HOST.PORT}	→ 基于触发器的通知与命令 → 问题update通知与命令 → 自动注册通知与命令 → 内部通知 → 触发器名称、事件名称、操作数据及描述 → 触发器URL → JMX监控项端点字段 → 宏支持 → 手动事件操作scripts → 监控项数值小部件描述 → 列配置小部件中文本数据类型的列	主机 (agent) 端口². 该宏可使用数字索引（例如{主机.PORT<1-9>}）指向触发器表达式中的第一、第二、第三个等主机。参阅索引宏。
{HOST.TARGET.CONN}	→ 基于触发器的命令 → 问题update命令 → 发现命令 → 自动注册命令	目标主机的IP地址或DNS名称，取决于主机设置。自5.4.0版本起支持。
{HOST.TARGET.DNS}	→ 基于触发器的命令 → 问题update命令 → 发现命令 → 自动注册命令	目标主机的DNS名称自5.4.0版本起支持。
{HOST.TARGET.HOST}	→ 基于触发器的命令 → 问题update命令 → 发现命令 → 自动注册命令	目标主机的技术名称自5.4.0版本起支持。
{HOST.TARGET.IP}	→ 基于触发器的命令 → 问题update命令 → 发现命令 → 自动注册命令	目标主机的IP地址自5.4.0版本起支持
{HOST.TARGET.NAME}	→ 基于触发器的命令 → 问题update命令 → 发现命令 → 自动注册命令	目标主机的可见名称自5.4.0版本起支持
{HOSTGROUP.ID}	→ 映射元素标签、地图URL名称及数值	主机组 ID.
{INVENTORY.ALIAS}	→ 基于触发器的通知和命令 → 问题update通知和命令 → 内部通知 → 宏支持 → 地图元素标签、地图URL名称和值 → 手动事件操作scripts → 监控项值小部件的描述 → 列配置小部件中数据类型为文本的列	主机资产清单中的alias字段该宏可使用数字索引，例如{INVENTORY.alias<1-9>}，用于指向触发器表达式中的第一、第二、第三个等主机。参见索引宏。
{INVENTORY.ASSET.TAG}	→ 基于触发器的通知和命令 → 问题更新

脚注

¹ 在监控项键参数中支持的{HOST.*}宏将解析为为监控项选择的接口。当在监控项中使用且没有接口时，它们将按此优先级顺序解析为主机的Zabbix agent、SNMP、JMX或IPMI接口，如果主机没有任何接口，则解析为'未知'。

² 在全局脚本、接口IP/DNS字段和Web场景中，宏将解析为主agent接口。如果未定义agent接口，则将使用主SNMP接口。如果也未定义SNMP接口，则将使用主JMX接口。如果JMX接口也未定义，则将使用主IPMI接口。如果主机没有任何接口，宏将解析为'未知'。

³ 在地图标签中，此宏仅支持以秒为参数的avg、last、max和min函数。

⁴ {HOST.*}宏支持在Web场景的Variables、Headers、SSL证书file和SSL密钥file字段以及场景步骤的URL、Post、Headers和Required string字段中使用。自Zabbix 5.2.2起，{HOST.*}宏不再支持在Web场景Name和Web场景步骤Name字段中使用。

⁵ 在图表名称中，此宏仅支持以秒为参数的avg、last、max和min函数。{主机.主机<1-9>}宏可用作宏内的主机。例如：

 last(/Cisco switch/ifAlias[{#SNMPINDEX}])
        last(/{HOST.HOST}/ifAlias[{#SNMPINDEX}])

⁶ 自5.2.5版本起支持。

索引宏

索引宏语法{MACRO<1-9>}仅在触发器表达式上下文中生效。该语法可用于按表达式中的出现顺序引用主机或函数。例如{HOST.IP1}、{HOST.IP2}、{HOST.IP3}将分别解析为触发器表达式中第一、第二、第三个主机的IP地址（前提是触发器表达式中包含这些主机）。而{FUNCTION.VALUE1}、{FUNCTION.VALUE2}、{FUNCTION.VALUE3}将解析为事件发生时触发器表达式中第一、第二、第三个监控项类函数的值（前提是触发器表达式中包含这些函数）。

此外，在图表名称的{?func(/host/key,param)}表达式宏中也支持{主机.主机<1-9>}宏语法。例如图表名称中的{?func(/{HOST.HOST2}/key,param)}将指向图表中第二个监控项的主机。

索引宏仅在上述两种场景下有效，其他所有上下文环境均不支持解析。其他场景请使用无索引宏（如{HOST.HOST}、{HOST.IP}等）。

Documentation

1 支持的宏

概述

脚注

索引宏