[comment]: # translation:outdated
[comment]: # ({6dcfe607-6a6ff645})
# 1 支持的宏
[comment]: # ({/6dcfe607-6a6ff645})
[comment]: # ({6aab59cf-d36c0744})
#### 概述
该表格包含Zabbix支持的全部宏的完整列表
开箱即用
::: notetip
要查看某个位置支持的所有宏（例如，
在"地图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](/manual/web_interface/frontend_sections/administration/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](/manual/web_interface/frontend_sections/administration/scripts) | *事件的确认状态(是/否)*. |
| {EVENT.AGE} | → 基于触发器的通知与命令
→ 问题update通知与命令
→ 基于服务的通知与命令
→ 服务update通知与命令
→ 服务恢复通知与命令
→ 自动发现通知与命令
→ 自动注册通知与命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *触发动作的事件存在时长*，精确到秒级
适用于升级消息场景 |
{EVENT.DATE} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 发现通知和命令
→ 自动注册通知和命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *触发操作的事件日期* |
| {EVENT.DURATION} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *事件持续时间（问题事件与恢复事件之间的时间差）*，精确到秒。
在问题恢复消息中非常有用。
自5.0.0版本起支持。
| {EVENT.ID} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 发现通知和命令
→ 自动注册通知和命令
→ 内部通知
→ 触发器URL
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *触发操作的事件数字ID.* |
| {EVENT.NAME} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *触发操作的问题事件名称*
自4.0.0版本起支持。
| {EVENT.NSEVERITY} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *事件严重程度的数值.* 可能的值: 0 - 未分类, 1 - 信息, 2 - 警告, 3 - 一般, 4 - 高, 5 - 灾难.
自4.0.0版本起支持. |
| {EVENT.OBJECT} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 发现通知和命令
→ 自动注册通知和命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *事件object的数值.* 可能的值: 0 - 触发器, 1 - 发现的主机, 2 - 发现的服务, 3 - 自动注册, 4 - 监控项, 5 - 低级发现规则.
自4.4.0版本起支持. |
| {EVENT.OPDATA} | → 基于触发器的通知和命令
→ 问题 update 通知和命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts) | *问题底层触发器的操作数据*
自4.4.0版本起支持。 |
| {EVENT.RECOVERY.DATE} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 和命令
→ 问题 update 通知和命令（如果发生恢复）
→ 服务恢复通知和命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)（如果发生恢复） | *恢复事件的日期.* |
| {EVENT.RECOVERY.ID} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 和命令
→ 问题 update 通知和命令（如果发生恢复）
→ 服务恢复通知和命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)（如果发生恢复） | *恢复事件的数字ID。* |
| {EVENT.RECOVERY.NAME} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 与命令
→ 问题 update 通知与命令（若恢复发生）
→ 服务恢复通知与命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)（若恢复发生） | *恢复事件的名称*
自4.4.1版本起支持。 |
| {EVENT.RECOVERY.STATUS} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 和命令
→ 问题 update 通知和命令（如果发生恢复）
→ 服务恢复通知和命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)（如果发生恢复） | *恢复事件的文本值。* |
| {EVENT.RECOVERY.TAGS} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 与命令
→ 问题 update 通知与命令（若恢复发生）
→ 服务恢复通知与命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)（若恢复发生） | *以逗号分隔的恢复事件标签列表。* 若无标签存在，则扩展为空 string。
自3.2.0版本起支持。 |
| {EVENT.RECOVERY.TAGSJSON} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 与命令
→ 问题 update 通知与命令（若恢复发生）
→ 服务恢复通知与命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)（若恢复发生） | *包含事件标签 [事件标签](/manual/api/reference/event/object#事件标签) 的 JSON array。* 若无标签则扩展为空 array。
自 5.0.0 版本起支持。 |
| {EVENT.RECOVERY.TIME} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 与命令
→ 问题 update 通知与命令（若恢复发生）
→ 服务恢复通知与命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)（若恢复发生） | *恢复事件的时间。* |
| {EVENT.RECOVERY.VALUE} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 和命令
→ 问题 update 通知和命令（如果已发生恢复）
→ 服务恢复通知和命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)（如果已发生恢复） | *恢复事件的数值。* |
| {EVENT.SEVERITY} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *事件严重级别名称*
自4.0.0版本起支持。
| {EVENT.SOURCE} | → 基于触发器的通知与命令
→ 问题update通知与命令
→ 基于服务的通知与命令
→ 服务update通知与命令
→ 服务恢复通知与命令
→ 发现通知与命令
→ 自动注册通知与命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *事件源的数值表示.* 可能取值: 0 - 触发器, 1 - 发现, 2 - 自动注册, 3 - 内部, 4 - 服务.
自4.4.0版本起支持. |
| {EVENT.STATUS} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *触发操作的事件的文本描述值.* |
| {EVENT.TAGS} | → 基于触发器的通知与命令
→ 问题update通知与命令
→ 基于服务的通知与命令
→ 服务update通知与命令
→ 服务恢复通知与命令
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *以逗号分隔的事件标签列表*。若标签不存在则扩展为空string。
自3.2.0版本起支持。 |
| {EVENT.TAGSJSON} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *包含事件标签[事件标签](/manual/api/reference/event/object#事件标签)的JSONarray.* 若无标签存在则扩展为空array.
自5.0.0版本起支持. |
| {EVENT.TAGS.} | → 基于触发器的通知和命令
→ 问题 update 通知和命令
→ 基于服务的通知和命令
→ 服务 update 通知和命令
→ 服务恢复通知和命令
→ Webhook媒介类型URL名称和URL
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts) | *通过标签名引用的事件标签值*
包含非字母数字字符（包括非英语多字节UTF字符）的标签名应使用双引号包裹。引号内的引号和反斜杠必须使用反斜杠进行转义。
自4.4.2版本起支持。 |
| {EVENT.TIME} | → 基于触发器的通知与命令
→ 问题update通知与命令
→ 基于服务的通知与命令
→ 服务update通知与命令
→ 服务恢复通知与命令
→ 自动发现通知与命令
→ 自动注册通知与命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *触发动作的事件发生时间.* |
| {EVENT.UPDATE.ACTION} | → 问题 update 通知与命令 | 在 [problem update](/manual/acknowledges#updating_problems) 期间执行的*人类可读动作名称*。
解析为以下值：*已确认*、*已评论*、*严重性从(原严重级别)变更为(更新后严重级别)* 以及 *已关闭*（取决于单次 update 中执行了多少个动作）。
自4.0.0版本起支持。 |
| {EVENT.UPDATE.DATE} | → 问题 update 通知和命令
→ 服务 update 通知和命令 | *事件 [update](/manual/config/notifications/action/update_operations) 日期（确认等）。*
已弃用名称：{ACK.DATE} |
| {EVENT.UPDATE.HISTORY} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/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](/manual/web_interface/frontend_sections/administration/scripts) | *问题update状态的数值.* 可能取值: 0 - 因问题/恢复事件调用Webhook, 1 - 更新操作.
自4.4.0版本起支持.
| {EVENT.UPDATE.TIME} | → 问题 update 通知与命令
→ 服务 update 通知与命令 | *事件 [update](/manual/config/notifications/action/update_operations) 时间（确认等操作）*
已弃用名称：{ACK.TIME} |
| {EVENT.VALUE} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 基于服务的通知和命令
→ 服务update通知和命令
→ 服务恢复通知和命令
→ 内部通知
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts) | *触发操作的事件数值（1表示问题，0表示恢复）。* |
| {FUNCTION.VALUE} | → 基于触发器的通知和命令
→ 问题 update 通知和命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts)
→ 事件名称 | *事件发生时触发器表达式中第N个基于监控项的函数结果*
仅计算以*/主机/key*作为第一个参数的函数。
该宏可使用数字索引（例如{FUNCTION.VALUE[<1-9>](supported_by_location#indexed_macros)}）指向触发器表达式中的第一个、第二个、第三个等函数。参见[索引宏](supported_by_location#索引宏)。
**注意** 在Zabbix 6.0.35之前，{FUNCTION.VALUE}不受支持；请改用{FUNCTION.VALUE1}。 |
| {FUNCTION.RECOVERY.VALUE} | → 问题 [recovery notifications](/manual/config/notifications/action/recovery_operations) 与命令
→ 问题 update 通知与命令
→ 手动事件操作 [scripts](/manual/web_interface/frontend_sections/administration/scripts) | *事件发生时恢复表达式中第N个基于监控项的函数结果*
仅统计以*/主机/key*作为首个参数的函数。
该宏可通过数字索引使用，例如{FUNCTION.RECOVERY.VALUE[<1-9>](supported_by_location#indexed_macros)}指向触发器表达式中的第一、第二、第三等函数。参见[索引宏](supported_by_location#索引宏)。
**注意**在Zabbix 6.0.35之前版本中不支持{FUNCTION.RECOVERY.VALUE}，请改用{FUNCTION.RECOVERY.VALUE1}。 |
| {HOST.CONN} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 内部通知
→ 地图元素标签、地图URL名称和值
→ 监控项键参数^[1](supported_by_location#脚注)^
→ 主机接口IP/DNS
→ Trapper监控项的"允许主机"字段
→ 数据库监控附加参数
→ SSH和Telnet脚本
→ JMX监控项端点字段
→ Web监控^[4](supported_by_location#脚注)^
→ 低级发现规则过滤正则表达式
→ 动态URL仪表板小部件的URL字段
→ 触发器名称、事件名称、操作数据和描述
→ 触发器URL
→ [宏支持](/manual/config/tagging#宏支持)
→ 脚本类型监控项、监控项原型和发现规则参数名称及值
→ HTTPagent类型监控项、监控项原型和发现规则字段：
URL、query字段、请求体、头部、SSL证书file、SSL密钥file、允许主机
→ 手动主机操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（包括确认文本）
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（包括确认文本）
→ 监控项值小部件的描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小部件中*文本*数据类型的列 | *主机IP地址或DNS名称，取决于主机设置*^[2](supported_by_location#脚注)^
可使用数字索引如{主机.CONN[<1-9>](supported_by_location#indexed_macros)}指向触发器表达式中的第一个、第二个、第三个等主机。参见[索引宏](supported_by_location#索引宏)。
| {HOST.DESCRIPTION} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 内部通知
→ 地图元素标签
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)
→ 监控项值小部件的描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小部件中数据类型为*文本*的列 | *主机描述.*
该宏可使用数字索引（例如{主机.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)}）指向触发器表达式中的第一个、第二个、第三个等主机。参见[索引宏](supported_by_location#索引宏)。
| {HOST.DNS} | → 基于触发器的通知与命令
→ 问题update通知与命令
→ 内部通知
→ 地图元素标签、地图URL名称及值
→ 监控项键值参数^[1](supported_by_location#脚注)^
→ 主机接口IP/DNS
→ Trapper监控项的"Allowed 主机"字段
→ 数据库监控附加参数
→ SSH与Telnet脚本
→ JMX监控项端点字段
→ 网络监控^[4](supported_by_location#脚注)^
→ 低级发现规则过滤正则表达式
→ 动态URL仪表板小工具的URL字段
→ 触发器名称、事件名称、操作数据及描述
→ 触发器URL
→ [宏支持](/manual/config/tagging#宏支持)
→ 脚本类型监控项、监控项原型及发现规则参数名称与值
→ HTTPagent类型监控项、监控项原型及发现规则字段：
URL、query字段、请求体、请求头、SSL证书file、SSL密钥file、Allowed 主机
→ 手动主机操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（含确认文本）
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（含确认文本）
→ 监控项数值小工具描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小工具中*文本*数据类型的列 | *主机DNS名称*^[2](supported_by_location#脚注)^
该宏可使用数字索引（如{主机.DNS[<1-9>](supported_by_location#indexed_macros)}）指向触发器表达式中的第一、第二、第三个等主机。参见[索引宏](supported_by_location#索引宏)。
| {HOST.HOST} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 自动注册通知和命令
→ 内部通知
→ 监控项键参数
→ 地图元素标签、地图URL名称和值
→ 主机接口IP/DNS
→ Trapper监控项的"允许主机"字段
→ 数据库监控附加参数
→ SSH和Telnet脚本
→ JMX监控项端点字段
→ Web监控^[4](supported_by_location#脚注)^
→ 低级发现规则过滤器正则表达式
→ 动态URL仪表板小部件的URL字段
→ 触发器名称、事件名称、操作数据和描述
→ 触发器URL
→ [宏支持](/manual/config/tagging#宏支持)
→ 脚本类型监控项、监控项原型和发现规则参数名称及值
→ HTTPagent类型监控项、监控项原型和发现规则字段：
URL、query字段、请求体、头部、SSL证书file、SSL密钥file、允许主机
→ 手动主机操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（包括确认文本）
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（包括确认文本）
→ 监控项值小部件的描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小部件中*文本*数据类型的列 | *主机名.*
此宏可与数字索引一起使用，例如{主机.主机[<1-9>](supported_by_location#indexed_macros)}指向触发器表达式中的第一个、第二个、第三个等主机。参见[索引宏](supported_by_location#索引宏)。
`{HOSTNAME<1-9>}`已弃用。
| {HOST.ID} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 内部通知
→ 地图元素标签、地图URL名称和值
→ 动态URL仪表板小工具的URL字段
→ 触发器URL
→ [宏支持](/manual/config/tagging#宏支持)
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)
→ 监控项值小工具的描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小工具中*文本*数据类型的列 | *主机 ID.*
可与数字索引一起使用，如{主机.ID[<1-9>](supported_by_location#indexed_macros)}，指向触发器表达式中的第一个、第二个、第三个等主机。参见[索引宏](supported_by_location#索引宏)。 |
| {HOST.IP} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 自动注册通知和命令
→ 内部通知
→ 地图元素标签、地图URL名称和值
→ 监控项键参数^[1](supported_by_location#脚注)^
→ 主机接口IP/DNS
→ Trapper监控项的"允许主机"字段
→ 数据库监控附加参数
→ SSH和Telnet脚本
→ JMX监控项端点字段
→ Web监控^[4](supported_by_location#脚注)^
→ 低级发现规则过滤器正则表达式
→ 动态URL仪表板小工具的URL字段
→ 触发器名称、事件名称、操作数据和描述
→ 触发器URL
→ [宏支持](/manual/config/tagging#宏支持)
→ 脚本类型监控项、监控项原型和发现规则参数名称及值
→ HTTPagent类型监控项、监控项原型和发现规则字段：
URL、query字段、请求体、头部、SSL证书file、SSL密钥file、允许主机
→ 手动主机操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（包括确认文本）
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（包括确认文本）
→ 监控项值小工具的描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小工具中*文本*数据类型的列 | *主机IP地址*^[2](supported_by_location#脚注)^
该宏可使用数字索引（例如{主机.IP[<1-9>](supported_by_location#indexed_macros)}）指向触发器表达式中的第一、第二、第三个等主机。参见[索引宏](supported_by_location#索引宏)
`{IPADDRESS<1-9>}`已弃用
| {HOST.METADATA} | → 自动注册通知与命令 | *主机 元数据.*
仅用于主动式 agent 自动注册。 |
| {HOST.NAME} | → 基于触发器的通知和命令
→ 问题update通知和命令
→ 内部通知
→ 地图元素标签、地图URL名称和值
→ 监控项键参数
→ 主机接口IP/DNS
→ Trapper监控项的"允许主机"字段
→ 数据库监控附加参数
→ SSH和Telnet脚本
→ Web监控^[4](supported_by_location#脚注)^
→ 低级发现规则过滤正则表达式
→ 动态URL仪表板小工具的URL字段
→ 触发器名称、事件名称、操作数据和描述
→ 触发器URL
→ [宏支持](/manual/config/tagging#宏支持)
→ 脚本类型监控项、监控项原型和发现规则参数名称及值
→ HTTPagent类型监控项、监控项原型和发现规则字段：
URL、query字段、请求体、头部、SSL证书file、SSL密钥file、允许主机
→ 手动主机操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（包括确认文本）
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)（包括确认文本）
→ 监控项值小工具的描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小工具中*文本*数据类型的列 | *可见主机名*
该宏可使用数字索引，例如{主机.NAME[<1-9>](supported_by_location#indexed_macros)}指向触发器表达式中的第一个、第二个、第三个等主机。参见[索引宏](supported_by_location#索引宏)。
| {HOST.PORT} | → 基于触发器的通知与命令
→ 问题update通知与命令
→ 自动注册通知与命令
→ 内部通知
→ 触发器名称、事件名称、操作数据及描述
→ 触发器URL
→ JMX监控项端点字段
→ [宏支持](/manual/config/tagging#宏支持)
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)
→ 监控项数值小部件描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小部件中*文本*数据类型的列 | *主机 (agent) 端口*^[2](supported_by_location#脚注)^.
该宏可使用数字索引（例如{主机.PORT[<1-9>](supported_by_location#indexed_macros)}）指向触发器表达式中的第一、第二、第三个等主机。参阅[索引宏](supported_by_location#索引宏)。 |
| {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通知和命令
→ 内部通知
→ [宏支持](/manual/config/tagging#宏支持)
→ 地图元素标签、地图URL名称和值
→ 手动事件操作[scripts](/manual/web_interface/frontend_sections/administration/scripts)
→ 监控项值小部件的描述
→ [列配置](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts#列配置)小部件中数据类型为*文本*的列 | *主机资产清单中的alias字段*
该宏可使用数字索引，例如{INVENTORY.alias[<1-9>](supported_by_location#indexed_macros)}，用于指向触发器表达式中的第一、第二、第三个等主机。参见[索引宏](supported_by_location#索引宏)。
|{INVENTORY.ASSET.TAG}|→ 基于触发器的通知和命令
→ 问题更新
[comment]: # ({/6aab59cf-d36c0744})
[comment]: # ({fd063eff-f4bb15e3})
##### 脚注
^**1**^ 在监控项键参数中支持的`{HOST.*}`宏将解析为为监控项选择的接口。当在监控项中使用且没有接口时，它们将按此优先级顺序解析为主机的Zabbix agent、SNMP、JMX或IPMI接口，如果主机没有任何接口，则解析为'未知'。
^**2**^ 在全局脚本、接口IP/DNS字段和Web场景中，宏将解析为主agent接口。如果未定义agent接口，则将使用主SNMP接口。如果也未定义SNMP接口，则将使用主JMX接口。如果JMX接口也未定义，则将使用主IPMI接口。如果主机没有任何接口，宏将解析为'未知'。
^**3**^ 在地图标签中，此宏仅支持以秒为参数的**avg**、**last**、**max**和**min**函数。
^**4**^ `{HOST.*}`宏支持在Web场景的*Variables*、*Headers*、*SSL证书file*和*SSL密钥file*字段以及场景步骤的*URL*、*Post*、*Headers*和*Required string*字段中使用。自Zabbix 5.2.2起，`{HOST.*}`宏不再支持在Web场景*Name*和Web场景步骤*Name*字段中使用。
^**5**^ 在图表名称中，此宏仅支持以秒为参数的**avg**、**last**、**max**和**min**函数。{主机.主机<1-9>}宏可用作宏内的主机。例如：
last(/Cisco switch/ifAlias[{#SNMPINDEX}])
last(/{HOST.HOST}/ifAlias[{#SNMPINDEX}])
^**6**^ 自5.2.5版本起支持。
[comment]: # ({/fd063eff-f4bb15e3})
[comment]: # ({3a90dc8f-3a90dc8f})
#### 索引宏
索引宏语法{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)}`将指向图表中第二个监控项的主机。
::: notewarning
索引宏仅在上述两种场景下有效，其他所有上下文环境均不支持解析。其他场景请使用**无索引**宏（如{HOST.HOST}、{HOST.IP}等）。
:::
[comment]: # ({/3a90dc8f-3a90dc8f})