[comment]: # attributes: notoc
[comment]: # ({dc16658f-6dcfe607})
# 1 按位置支持的宏
[comment]: # ({/dc16658f-6dcfe607})
[comment]: # ({6592756b-d36c0744})
#### 概述
[按位置支持的宏](#macros-supported-by-location)表包含在特定位置中受支持的所有宏（内置、表达式和用户可定义）的参考信息。
如果某个相关组中的所有宏都受支持，则只给出组名。单击每个宏名称或组名可查看这些宏的完整详细信息。
[宏详细信息](#macro-details)列表包含所有**内置**宏的详细列表，并按应用区域分组。请注意，要自定义宏值（例如，缩短或提取特定子字符串），可以使用[宏函数](/manual/config/macros/macro_functions)。
[comment]: # ({/6592756b-d36c0744})
[comment]: # ({db140a6c-636ee6ec})
#### 按位置支持的宏
|位置|<|支持的宏|注释|
|-|------------|---------------------------------|------------|
|**动作**|<|<|<|
| |*时间段条件、默认操作步骤持续时间、步骤持续时间*|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）|单个宏必须填满整个字段；不支持多个宏/与文本混合|
|**通知和命令**|<|<|<|
| |*基于触发器*|[动作](#action-macros)宏
[日期/时间](#date-and-time-macros)宏
[{ESC.HISTORY}](#eschistory)
[事件](#event-macros)宏、[原因/症状事件](#causesymptom-event-macros)宏
事件更新宏：[{EVENT.UPDATE.HISTORY}](#eventupdhistory)、[{EVENT.UPDATE.STATUS}](#eventupdstatus)
表达式宏：[{?EXPRESSION}](/manual/config/macros/expression_macros)
[{FUNCTION.VALUE}](#functionvalue)
主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DESCRIPTION}](#hostdescription)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[目标主机](#target-host-macros)宏（仅命令）
[主机清单](#host-inventory-macros)宏
[监控项](#item-macros)宏（[{ITEM.STATE}](#itemstate)、[{ITEM.STATE.ERROR}](#itemstateerror)除外）
[Proxy](#proxy-macros)宏
触发器宏：[{TRIGGER.DESCRIPTION}](#trigdescription)、[{TRIGGER.EVENTS.\*}](#trigeventsack)、[{TRIGGER.EXPRESSION}](#trigexpression)、[{TRIGGER.EXPRESSION.EXPLAIN}](#trigexplain)、[{TRIGGER.EXPRESSION.RECOVERY}](#trigexpressionrecovery)、[{TRIGGER.ID}](#trigid)、[{TRIGGER.HOSTGROUP.NAME}](#trighostgroupname)、[{TRIGGER.NAME}](#trigname)、[{TRIGGER.NAME.ORIG}](#trignameorig)、[{TRIGGER.NSEVERITY}](#trignseverity)、[{TRIGGER.SEVERITY}](#trigseverity)、[{TRIGGER.STATUS}](#trigstatus)、[{TRIGGER.TEMPLATE.NAME}](#trigtemplname)、[{TRIGGER.URL}](#trigurl)、[{TRIGGER.URL.NAME}](#trigurlname)、[{TRIGGER.VALUE}](#triggervalue)
[用户可定义](/manual/config/macros/user_macros)宏|另请参见：[在消息中使用宏](/manual/config/notifications/action/operation/macros) |
|^|*问题更新*|[动作](#action-macros)宏
[日期/时间](#date-and-time-macros)宏
[{ESC.HISTORY}](#eschistory)
[事件](#event-macros)宏、[原因/症状事件](#causesymptom-event-macros)宏、[恢复事件](#recovery-event-macros)宏
[事件更新](#event-update-macros)宏：全部（[{EVENT.UPDATE.NSEVERITY}](#eventupdnseverity)、[{EVENT.UPDATE.SEVERITY}](#eventupdseverity)除外）
表达式宏：[{?EXPRESSION}](/manual/config/macros/expression_macros)
[函数](#function-macros)宏
主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DESCRIPTION}](#hostdescription)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[目标主机](#target-host-macros)宏（仅命令）
[主机清单](#host-inventory-macros)宏
[监控项](#item-macros)宏（[{ITEM.STATE}](#itemstate)、[{ITEM.STATE.ERROR}](#itemstateerror)除外）
[Proxy](#proxy-macros)宏
触发器宏：[{TRIGGER.DESCRIPTION}](#trigdescription)、[{TRIGGER.EVENTS.\*}](#trigeventsack)、[{TRIGGER.EXPRESSION}](#trigexpression)、[{TRIGGER.EXPRESSION.EXPLAIN}](#trigexplain)、[{TRIGGER.EXPRESSION.RECOVERY}](#trigexpressionrecovery)、[{TRIGGER.ID}](#trigid)、[{TRIGGER.HOSTGROUP.NAME}](#trighostgroupname)、[{TRIGGER.NAME}](#trigname)、[{TRIGGER.NAME.ORIG}](#trignameorig)、[{TRIGGER.NSEVERITY}](#trignseverity)、[{TRIGGER.SEVERITY}](#trigseverity)、[{TRIGGER.STATUS}](#trigstatus)、[{TRIGGER.TEMPLATE.NAME}](#trigtemplname)、[{TRIGGER.URL}](#trigurl)、[{TRIGGER.URL.NAME}](#trigurlname)、[{TRIGGER.VALUE}](#triggervalue)
[{USER.FULLNAME}](#userfullname)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*问题恢复*|[恢复事件](#recovery-event-macros)宏
[{FUNCTION.RECOVERY.VALUE}](#functionrecvalue)
[{TRIGGER.EXPRESSION.RECOVERY.EXPLAIN}](#trigrecoveryexplain) | |
|^|*发现*|[动作](#action-macros)宏
[日期/时间](#date-and-time-macros)宏
[发现](#discovery-macros)宏
事件宏：[{EVENT.AGE}](#eventage)、[{EVENT.DATE}](#eventdate)、[{EVENT.ID}](#eventid)、[{EVENT.OBJECT}](#eventobject)、[{EVENT.SOURCE}](#eventsource)、[{EVENT.TIME}](#eventtime)、[{EVENT.TIMESTAMP}](#eventtimestamp)
[目标主机](#target-host-macros)宏（仅命令）
[Proxy](#proxy-macros)宏 | |
|^|*自动注册*|[动作](#action-macros)宏
[日期/时间](#date-and-time-macros)宏
事件宏：[{EVENT.AGE}](#eventage)、[{EVENT.DATE}](#eventdate)、[{EVENT.ID}](#eventid)、[{EVENT.OBJECT}](#eventobject)、[{EVENT.SOURCE}](#eventsource)、[{EVENT.TIME}](#eventtime)、[{EVENT.TIMESTAMP}](#eventtimestamp)
主机宏：[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.PORT}](#hostport)、[{HOST.METADATA}](#hostmetadata)
[目标主机](#target-host-macros)宏（仅命令）
[Proxy](#proxy-macros)宏| |
|^|*基于服务*|[动作](#action-macros)宏
[日期/时间](#date-and-time-macros)宏
[{ESC.HISTORY}](#eschistory)
事件宏：[全部](#event-macros)，但 [{EVENT.ACK.STATUS}](#eventackstatus)、[{EVENT.OPDATA}](#eventopdata) 除外
[服务](#service-macros)宏
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*服务恢复*|[事件](#event-macros)宏（[{EVENT.ACK.STATUS}](#eventackstatus)、[{EVENT.OPDATA}](#eventopdata)除外）、[恢复事件](#recovery-event-macros)宏| |
|^|*服务更新*|[动作](#action-macros)宏
[日期/时间](#date-and-time-macros)宏
[{ESC.HISTORY}](#eschistory)
[事件](#event-macros)宏（[{EVENT.ACK.STATUS}](#eventackstatus)、[{EVENT.OPDATA}](#eventopdata)除外）
事件更新宏：[{EVENT.UPDATE.DATE}](#eventupddate)、[{EVENT.UPDATE.NSEVERITY}](#eventupdnseverity)、[{EVENT.UPDATE.SEVERITY}](#eventupdseverity)、[{EVENT.UPDATE.STATUS}](#eventupdstatus)、[{EVENT.UPDATE.TIME}](#eventupdtime)、[{EVENT.UPDATE.TIMESTAMP}](#eventupdtimestamp)
[服务](#service-macros)宏
[用户可定义](/manual/config/macros/user_macros)宏| |
|**内部通知**|<|[动作](#action-macros)宏
[日期/时间](#date-and-time-macros)宏
[{ESC.HISTORY}](#eschistory)
[事件](#event-macros)宏（[{EVENT.NSEVERITY}](#eventnseverity)、[{EVENT.SEVERITY}](#eventseverity)除外）、[恢复事件](#recovery-event-macros)宏
主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DESCRIPTION}](#hostdescription)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[主机清单](#host-inventory-macros)宏
监控项宏：[{ITEM.DESCRIPTION}](#itemdescription)、[{ITEM.DESCRIPTION.ORIG}](#itemdescriptionorig)、[{ITEM.ID}](#itemid)、[{ITEM.KEY}](#itemkey)、[{ITEM.KEY.ORIG}](#itemkeyorig)、[{ITEM.NAME}](#itemname)、[{ITEM.NAME.ORIG}](#itemnameorig)、[{ITEM.VALUETYPE}](#itemvaluetype)
[Proxy](#proxy-macros)宏| |
| |*基于监控项*|监控项宏：[{ITEM.STATE}](#itemstate)、[{ITEM.STATE.ERROR}](#itemstateerror)| |
|^|*基于 LLD 规则*|[低级别发现通知](#low-level-discovery-notification-macros)宏| |
|^|*基于触发器*|触发器宏：[{TRIGGER.DESCRIPTION}](#trigdescription)、[{TRIGGER.EXPRESSION}](#trigexpression)、[{TRIGGER.EXPRESSION.RECOVERY}](#trigexpressionrecovery)、[{TRIGGER.HOSTGROUP.NAME}](#trighostgroupname)、[{TRIGGER.ID}](#trigid)、[{TRIGGER.NAME}](#trigname)、[{TRIGGER.NAME.ORIG}](#trignameorig)、[{TRIGGER.NSEVERITY}](#trignseverity)、[{TRIGGER.SEVERITY}](#trigseverity)、[{TRIGGER.STATE}](#trigstate)、[{TRIGGER.STATE.ERROR}](#trigstateerror)、[{TRIGGER.TEMPLATE.NAME}](#trigtemplname)、[{TRIGGER.URL}](#trigurl)、[{TRIGGER.URL.NAME}](#trigurlname)
[用户可定义](/manual/config/macros/user_macros)宏| |
|**告警脚本参数**|<|[告警](#alert-macros)宏
[用户可定义](/manual/config/macros/user_macros)宏（仅全局） | |
|**连接器**|<|<|<|
| |*URL、用户名、密码、Bearer 令牌、HTTP proxy、SSL 证书、SSL 密钥文件、SSL 密钥密码* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）| |
|^|*超时* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）|单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|**图形名称**|<|表达式宏：[{?EXPRESSION}](/manual/config/macros/expression_macros)|此位置中的该宏仅支持单个 **avg**、**last**、**max**、**min** 函数，且参数必须为秒（可使用时间[后缀](/manual/appendix/suffixes)）。
{HOST.HOST<1-9>} 宏可在该宏中用作主机（另请参见[索引宏](#indexed-macros)）。
使用示例：
{?avg(/{HOST.HOST}/item.key,1h)}
不支持的用法：
{?last(/host/item1)/last(/host/item2)}
{?last(/host/item1)*10}
{?count(/host/item1,5m)}|
|**主机、主机原型**|<|<|<|
| |*接口 IP/DNS*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)
[用户可定义](/manual/config/macros/user_macros)宏 ^**1**^|^**1**^ 对于 IP 地址，单个宏必须填满整个字段；不支持多个宏/与文本混合|
|^|*接口端口*|[用户可定义](/manual/config/macros/user_macros)宏|单个宏必须填满整个字段；不支持多个宏/与文本混合|
|^|*SNMP community*|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*SNMPv3 上下文名称、安全名称、认证口令、隐私口令*|^|^|
|^|*IPMI 用户名、密码*|^|^|
|**监控项、监控项原型、LLD 规则**|<|<|<|
| |*名称*|[用户可定义](/manual/config/macros/user_macros)宏|LLD 规则名称中不支持。|
|^|*描述*|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*键参数*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[用户可定义](/manual/config/macros/user_macros)宏|受支持的 {HOST.\*} 宏将解析为为该监控项选择的接口。用于无接口的监控项时，它们将按优先级顺序解析为主机的 Zabbix agent、SNMP、JMX 或 IPMI 接口；如果主机没有任何接口，则解析为“UNKNOWN”。|
|^|*更新间隔、自定义间隔、超时（适用于[支持的](/manual/web_interface/frontend_sections/administration/general#timeouts)监控项类型）、保存时长（历史记录/趋势）* 字段|[用户可定义](/manual/config/macros/user_macros)宏|单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|^|*删除丢失资源、禁用丢失资源* 字段|[用户可定义](/manual/config/macros/user_macros)宏|这些字段仅支持 LLD 规则。
单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|^|*预处理步骤参数*（包括自定义脚本），
*自定义错误处理参数*（*设置值为* 和 *设置错误为* 字段） |[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*过滤器正则表达式*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[用户可定义](/manual/config/macros/user_macros)宏|这些字段仅支持 LLD 规则。|
|^|*覆盖过滤器正则表达式*|[用户可定义](/manual/config/macros/user_macros)宏|这些字段仅支持 LLD 规则。|
|^|覆盖操作：*更新间隔*、*历史存储周期*、*趋势存储周期*（用于监控项原型）|[用户可定义](/manual/config/macros/user_macros)宏|这些字段仅支持 LLD 规则。
单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|**监控项类型**|<|<|<|
| |**Browser** 监控项
*参数名称和值*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[主机清单](#host-inventory-macros)宏
监控项宏：[{ITEM.ID}](#itemid)、[{ITEM.KEY}](#itemkey)、[{ITEM.KEY.ORIG}](#itemkeyorig)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**Script** 监控项
*参数名称和值*|^|^|
|^|**Calculated/aggregate** 监控项公式
（*表达式常量*、*函数参数*、*监控项键参数*、（仅聚合监控项）*过滤条件*（主机组名称和标签名称））|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**Database monitor** 监控项
*用户名、密码、SQL 查询* 字段|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**HTTP agent** 监控项
*URL、查询字段、请求体、标头（名称和值）、SSL 证书文件、SSL 密钥文件* 字段|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
监控项宏：[{ITEM.ID}](#itemid)、[{ITEM.KEY}](#itemkey)、[{ITEM.KEY.ORIG}](#itemkeyorig)
[用户可定义](/manual/config/macros/user_macros)宏|包含[保密宏](/manual/config/macros/secret_macros)的 URL 将无法工作，因为其中的宏会被解析为“******”|
|^|**HTTP agent** 监控项
*HTTP Proxy* 字段|监控项宏：[{ITEM.ID}](#itemid)、[{ITEM.KEY}](#itemkey)、[{ITEM.KEY.ORIG}](#itemkeyorig)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**HTTP agent** 监控项
*所需状态码、HTTP 认证用户名/密码、SSL 密钥密码* 字段|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**HTTP agent** 监控项
*允许的主机* 字段|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**JMX agent** 监控项
*端点* 字段|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.PORT}](#hostport)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**Trapper** 监控项
*允许的主机* 字段|^|^|
|^|**SNMP agent** 监控项
*SNMP OID* 字段|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**SSH and Telnet** 监控项
*脚本*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**SSH agent** 监控项
*用户名、公钥文件、私钥文件、密码* 字段|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|**Telnet agent** 监控项
*用户名、密码* 字段|[用户可定义](/manual/config/macros/user_macros)宏| |
|**地图**|<|<|<|
| |*URL、URL 名称*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DESCRIPTION}](#hostdescription)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[{HOSTGROUP.ID}](#hostgroupid)
[主机清单](#host-inventory-macros)宏
[地图](#map-macros)宏
[{TRIGGER.ID}](#trigid)| |
|^|*元素标签*|表达式宏：[{?EXPRESSION}](/manual/config/macros/expression_macros) ^**1**^
主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DESCRIPTION}](#hostdescription)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[{HOSTGROUP.ID}](#hostgroupid)
[主机清单](#host-inventory-macros)宏
[地图](#map-macros)宏
触发器宏：[{TRIGGER.EVENTS.*}](#trigeventsack)、[{TRIGGER.ID}](#trigid)、[{TRIGGER.PROBLEM.EVENTS.*}](#trigproblemeventsproblemack)、[{TRIGGERS.ACK}](#triggersack)、[{TRIGGERS.PROBLEM.ACK}](#triggersproblemack)、[{TRIGGERS.PROBLEM.UNACK}](#triggersproblemunack)、[{TRIGGERS.UNACK}](#triggersunack)|^**1**^ 此位置中的该宏仅支持单个 **avg**、**last**、**max**、**min** 函数，且参数必须为秒（可使用时间[后缀](/manual/appendix/suffixes)）。
{HOST.HOST<1-9>} 宏可在该宏中用作主机。
使用示例：
{?avg(/{HOST.HOST}/item.key,1h)}
不支持的用法：
{?last(/host/item1)/last(/host/item2)}
{?last(/host/item1)*10}
{?count(/host/item1,5m)}|
|^|*链接标签*|表达式宏：[{?EXPRESSION}](/manual/config/macros/expression_macros) ^**1**^ |^|
|^|*形状标签*|表达式宏：[{?EXPRESSION}](/manual/config/macros/expression_macros) ^**1**^ |^|
|^|*地图形状中的文本字段*|[{MAP.NAME}](#mapname)| |
|**网络发现**|<|<|<|
| |*更新间隔* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）|单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|^|*SNMP community、SNMP OID* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）| |
|^|*SNMPv3 上下文名称、安全名称、认证口令、隐私口令* 字段|^| |
|**Proxy**|<|<|<|
| |*活动 agent 的地址 > 端口*（如果该 proxy 属于某个组）
对于被动 proxy 模式：接口 *地址* 和 *端口* 字段
覆盖模式下的 *监控项类型超时* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）|单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|**Proxy 组**|<|<|<|
| |*故障转移周期、proxy 最小数量* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）|单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|**[脚本](/manual/web_interface/frontend_sections/alerts/scripts)**|<|<|<|
| |*命令、确认文本*
（类型：script，手动**主机操作**）|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid) ^**1**^、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[主机清单](#host-inventory-macros)宏 ^**2**^
[{MANUALINPUT}](#manualinput)
[用户名](#username-macros)宏
[用户可定义](/manual/config/macros/user_macros)宏|^**1**^ 仅确认文本
^**2**^ 支持 Zabbix 服务器和 Zabbix proxy
|
|^|*命令*
（类型：script，手动**事件操作**）|[日期/时间](#date-and-time-macros)宏
[事件](#event-macros)宏、[原因/症状事件](#causesymptom-event-macros)宏、[恢复事件](#recovery-event-macros)宏（如果已恢复）
事件更新宏：[{EVENT.UPDATE.HISTORY}](#eventupdhistory)、[{EVENT.UPDATE.STATUS}](#eventupdstatus)
[{FUNCTION.VALUE}](#functionvalue)
主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DESCRIPTION}](#hostdescription)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[主机清单](#host-inventory-macros)宏
[监控项](#item-macros)宏（[{ITEM.STATE}](#itemstate)、[{ITEM.STATE.ERROR}](#itemstateerror)除外）
[{MANUALINPUT}](#manualinput)
[Proxy](#proxy-macros)宏
触发器宏：[{TRIGGER.DESCRIPTION}](#trigdescription)、[{TRIGGER.EVENTS.\*}](#trigeventsack)、[{TRIGGER.EXPRESSION}](#trigexpression)、[{TRIGGER.EXPRESSION.EXPLAIN}](#trigexplain)、[{TRIGGER.EXPRESSION.RECOVERY}](#trigexpressionrecovery)、[{TRIGGER.EXPRESSION.RECOVERY.EXPLAIN}](#trigrecoveryexplain)、[{TRIGGER.HOSTGROUP.NAME}](#trighostgroupname)、[{TRIGGER.ID}](#trigid)、[{TRIGGER.NAME}](#trigname)、[{TRIGGER.NAME.ORIG}](#trignameorig)、[{TRIGGER.NSEVERITY}](#trignseverity)、[{TRIGGER.SEVERITY}](#trigseverity)、[{TRIGGER.STATUS}](#trigstatus)、[{TRIGGER.TEMPLATE.NAME}](#trigtemplname)、[{TRIGGER.URL}](#trigurl)、[{TRIGGER.URL.NAME}](#trigurlname)、[{TRIGGER.VALUE}](#triggervalue)
[用户名](#username-macros)宏
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*确认文本*
（类型：script，手动**事件操作**）|事件宏：[{EVENT.ID}](#eventid)、[{EVENT.NAME}](#eventname)、[{EVENT.NSEVERITY}](#eventnseverity)、[{EVENT.SEVERITY}](#eventseverity)、[{EVENT.STATUS}](#eventstatus)、[{EVENT.VALUE}](#eventvalue)
主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[主机清单](#host-inventory-macros)宏
[{MANUALINPUT}](#manualinput)
[用户名](#username-macros)宏
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*URL、确认文本*
（类型：URL，手动**主机/事件操作**）|^|^|
|**标签名称和值**|<|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[主机清单](#host-inventory-macros)宏
监控项宏：[{ITEM.LASTVALUE*}](#itemlastvalue)、[{ITEM.LOG.*}](#itemlogage)、[{ITEM.VALUE*}](#itemvalue)
触发器宏：[{TRIGGER.ID}](#trigid)（仅触发器标签值）
[用户可定义](/manual/config/macros/user_macros)宏|标签名称和值宏仅在事件生成过程中解析。|
|**触发器**|<|<|<|
| |*名称*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
监控项宏：[{ITEM.LASTVALUE*}](#itemlastvalue)、[{ITEM.LOG.*}](#itemlogage)、[{ITEM.VALUE*}](#itemvalue)
位置宏/引用：`$1...$9`
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*事件名称*|日期/时间宏：[{TIME}](#time)、[{TIMESTAMP}](#timestamp)
表达式宏：[{?EXPRESSION}](/manual/config/macros/expression_macros)
[函数](#function-macros)宏
主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
监控项宏：[{ITEM.LASTVALUE*}](#itemlastvalue)、[{ITEM.LOG.*}](#itemlogage)、[{ITEM.VALUE*}](#itemvalue)
触发器宏：[{TRIGGER.EXPRESSION.EXPLAIN}](#trigexplain) | |
|^|*运行数据*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
监控项宏：[{ITEM.LASTVALUE*}](#itemlastvalue)、[{ITEM.LOG.*}](#itemlogage)、[{ITEM.VALUE*}](#itemvalue)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*表达式*|[{TRIGGER.VALUE}](#triggervalue)
[用户可定义](/manual/config/macros/user_macros)宏 ^**1**^ |^**1**^ 仅在常量和函数参数中支持；不支持保密宏 |
|^|*用于匹配的标签、菜单项名称、菜单项 URL* 字段|[用户可定义](/manual/config/macros/user_macros)宏|包含[保密宏](/manual/config/macros/secret_macros)的 URL 将无法工作，因为其中的宏会被解析为“******”。|
|^|*描述*|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
监控项宏：[{ITEM.LASTVALUE*}](#itemlastvalue)、[{ITEM.LOG.*}](#itemlogage)、[{ITEM.VALUE*}](#itemvalue)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*URL*|[{EVENT.ID}](#eventid)
主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
监控项宏：[{ITEM.LASTVALUE*}](#itemlastvalue)、[{ITEM.LOG.*}](#itemlogage)、[{ITEM.VALUE*}](#itemvalue)
[{TRIGGER.ID}](#trigid)| |
|**用户参数命令**|<|位置宏/引用：`$1...$9`| |
|**Web 场景**|<|<|<|
| |*名称、Agent、HTTP proxy* 字段|[用户可定义](/manual/config/macros/user_macros)宏| |
| |*更新间隔* 字段|[用户可定义](/manual/config/macros/user_macros)宏|单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|^|*变量、标头、SSL 证书、SSL 密钥文件* 字段|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|*用户、密码、SSL 密钥密码* 字段|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|Web 场景步骤
*名称、变量（仅值）* 字段|[用户可定义](/manual/config/macros/user_macros)宏| |
|^|Web 场景步骤
*超时、所需状态码* 字段|[用户可定义](/manual/config/macros/user_macros)宏|单个宏必须填满整个字段；不支持多个宏/与文本混合。 |
|^|Web 场景步骤
*URL、标头（名称和值）、所需字符串* 字段|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[用户可定义](/manual/config/macros/user_macros)宏| |
|^|Web 场景步骤
*Post* 字段|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)| |
|**webhook 媒介类型**|<|<|<|
| |*参数值*|[告警](#alert-macros)宏
在基于触发器的问题通知中支持的所有宏（见上文） |单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|^|*JavaScript* 脚本、*JavaScript* 脚本参数名称|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）| |
|^|*菜单项名称、菜单项 URL*|[{EVENT.TAGS.\}](#eventtagstagname) | |
|**小组件**|<|<|<|
| |**Gauge** 小组件
*描述* 字段|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DESCRIPTION}](#hostdescription)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[主机清单](#host-inventory-macros)宏
[监控项](#item-macros)宏（[{ITEM.STATE.ERROR}](#itemstateerror)除外）
[用户可定义](/manual/config/macros/user_macros)宏（仅全局）| |
|^|**Honeycomb** 小组件
*主/次标签* 字段|^| |
|^|**监控项值** 小组件
*描述* 字段|^| |
|^|**Top hosts** 小组件
*文本数据* 列|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DESCRIPTION}](#hostdescription)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[主机清单](#host-inventory-macros)宏
[用户可定义](/manual/config/macros/user_macros)宏（仅全局）| |
|^|**URL**（动态）小组件
*URL* 字段|主机宏：[{HOST.CONN}](#hostconn)、[{HOST.DNS}](#hostdns)、[{HOST.HOST}](#hosthost)、[{HOST.ID}](#hostid)、[{HOST.IP}](#hostip)、[{HOST.NAME}](#hostname)、[{HOST.PORT}](#hostport)
[用户可定义](/manual/config/macros/user_macros)宏| |
|**其他位置**|<|<|<|
| |*工作时间* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）|单个宏必须填满整个字段；不支持多个宏/与文本混合。|
|^|*监控项类型超时* 字段（全局设置）|^|^|
|^|用户媒介
*活动时间* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）| |
|^|电子邮件媒介类型
*用户名、密码* 字段|[用户可定义](/manual/config/macros/user_macros)宏（仅全局）|建议使用[保密宏](/manual/config/macros/secret_macros)。|
|^|计划报告
*主题、消息* 字段|日期/时间宏：[{TIME}](#time)、[{TIMESTAMP}](#timestamp)| |
[comment]: # ({/db140a6c-636ee6ec})
[comment]: # ({f95b4b8e-df86bb0c})
#### 宏详细信息
此列表包含按应用领域分组的每个内置宏的详细信息：
- [动作宏](#action-macros)
- [告警宏](#alert-macros)
- [日期/时间宏](#date-and-time-macros)
- [发现宏](#discovery-macros)
- [事件宏](#event-macros)
- [事件更新宏](#event-update-macros)
- [原因/症状事件宏](#causesymptom-event-macros)
- [恢复事件宏](#recovery-event-macros)
- [升级宏](#escalation-macros)
- [函数宏](#function-macros)
- [主机宏](#host-macros)
- [目标主机宏](#target-host-macros)
- [主机组宏](#host-group-macros)
- [主机清单宏](#host-inventory-macros)
- [监控项宏](#item-macros)
- [低级别发现通知宏](#low-level-discovery-notification-macros)
- [拓扑图宏](#map-macros)
- [Proxy 宏](#proxy-macros)
- [脚本宏](#script-macros)
- [服务宏](#service-macros)
- [触发器宏](#trigger-macros)
- [用户名宏](#username-macros)
[comment]: # ({/f95b4b8e-df86bb0c})
[comment]: # ({1bea1e7f-8edfd122})
#### 动作宏
[comment]: # ({/1bea1e7f-8edfd122})
[comment]: # ({c7f4e3fb-f96af406})
##### {ACTION.ID} {#actionid}
已触发动作的数字 ID。
[comment]: # ({/c7f4e3fb-f96af406})
[comment]: # ({325e03ec-5236e14a})
##### {ACTION.NAME} {#actionname}
已触发动作的名称。
[comment]: # ({/325e03ec-5236e14a})
[comment]: # ({bd13dec9-01a61d5a})
#### 告警宏
[comment]: # ({/bd13dec9-01a61d5a})
[comment]: # ({a550c82d-9910b553})
##### {ALERT.MESSAGE} {#alertmessage}
操作配置中的*默认消息*值。
[comment]: # ({/a550c82d-9910b553})
[comment]: # ({c8a33a31-75bf9000})
##### {ALERT.SENDTO} {#alertsendto}
用户介质配置中的 *Send to* 值。
[comment]: # ({/c8a33a31-75bf9000})
[comment]: # ({cb553fe1-2651cfdc})
##### {ALERT.SUBJECT} {#alertsubject}
操作配置中的*默认主题*值。
[comment]: # ({/cb553fe1-2651cfdc})
[comment]: # ({2dd8d70b-b91f64d1})
#### 日期和时间宏
[comment]: # ({/2dd8d70b-b91f64d1})
[comment]: # ({3e7448fc-3170d74d})
##### {DATE} {#date}
当前日期，格式为 `yyyy.mm.dd`。
[comment]: # ({/3e7448fc-3170d74d})
[comment]: # ({cfa68387-bcedde37})
##### {TIME} {#time}
当前时间，格式为 `hh:mm:ss`。
[comment]: # ({/cfa68387-bcedde37})
[comment]: # ({1e832dac-9040b87a})
##### {TIMESTAMP} {#timestamp}
当前时间的 UNIX 时间戳格式。
[comment]: # ({/1e832dac-9040b87a})
[comment]: # ({990e7afd-e3ba0b53})
#### 发现宏
[comment]: # ({/990e7afd-e3ba0b53})
[comment]: # ({7751c520-0922f9ef})
##### {DISCOVERY.DEVICE.IPADDRESS} {#discdeviceip}
已发现设备的 IP 地址。
始终可用，不依赖于是否已添加主机。
[comment]: # ({/7751c520-0922f9ef})
[comment]: # ({650511b3-7ab1770f})
##### {DISCOVERY.DEVICE.DNS} {#discdevicedns}
已发现设备的 DNS 名称。
始终可用，不依赖于是否已添加主机。
[comment]: # ({/650511b3-7ab1770f})
[comment]: # ({6e39f9f3-212d03df})
##### {DISCOVERY.DEVICE.STATUS} {#discdevicestatus}
已发现设备的状态（UP/DOWN）。
[comment]: # ({/6e39f9f3-212d03df})
[comment]: # ({dc468d0a-0037e565})
##### {DISCOVERY.DEVICE.UPTIME} {#discdeviceuptime}
特定设备自上次发现状态变更以来的时间。
例如：1h 29m 01s。
对于状态为 DOWN 的设备，这是其宕机持续时间。
[comment]: # ({/dc468d0a-0037e565})
[comment]: # ({6335f628-3f9fa14c})
##### {DISCOVERY.RULE.NAME} {#discrulename}
发现设备/服务存在或不存在的发现规则名称。
[comment]: # ({/6335f628-3f9fa14c})
[comment]: # ({6a1f8f69-12217014})
##### {DISCOVERY.SERVICE.NAME} {#discservicename}
已发现服务的名称。
例如：HTTP。
[comment]: # ({/6a1f8f69-12217014})
[comment]: # ({c1fb3f34-4094db7d})
##### {DISCOVERY.SERVICE.PORT} {#discserviceport}
已发现服务的端口。
例如：80。
[comment]: # ({/c1fb3f34-4094db7d})
[comment]: # ({d5127dd8-ab150dfa})
##### {DISCOVERY.SERVICE.STATUS} {#discservicestatus}
已发现服务的状态（UP/DOWN）。
[comment]: # ({/d5127dd8-ab150dfa})
[comment]: # ({27071403-ce161db4})
##### {DISCOVERY.SERVICE.UPTIME} {#discserviceuptime}
特定服务自上次发现状态变更以来的时间。
例如：1h 29m 01s。
对于状态为 DOWN 的服务，这是其停机时长。
[comment]: # ({/27071403-ce161db4})
[comment]: # ({64d2d96a-18a70453})
#### 升级宏
[comment]: # ({/64d2d96a-18a70453})
[comment]: # ({89895a14-ff2051f3})
##### {ESC.HISTORY} {#eschistory}
先前已发送通知的日志，包括其升级步骤和状态（*已发送*、*进行中* 或 *失败*）。
[comment]: # ({/89895a14-ff2051f3})
[comment]: # ({bd50b2f5-90f8e709})
#### 事件宏
[comment]: # ({/bd50b2f5-90f8e709})
[comment]: # ({9496d82e-056d4207})
##### {EVENT.ACK.STATUS} {#eventackstatus}
事件的确认状态（是/否）。
[comment]: # ({/9496d82e-056d4207})
[comment]: # ({f8ee9ec4-63988113})
##### {EVENT.AGE} {#eventage}
触发操作的事件的持续时间，精确到秒。
在升级消息中很有用。
例如：9m 13s。
[comment]: # ({/f8ee9ec4-63988113})
[comment]: # ({14c90c4d-d38b5144})
##### {EVENT.DATE} {#eventdate}
触发动作的事件日期，格式为 `yyyy.mm.dd`。
例如：2025.04.14。
[comment]: # ({/14c90c4d-d38b5144})
[comment]: # ({80421dd9-d7ed9130})
##### {EVENT.DURATION} {#eventduration}
事件的持续时间（问题事件与恢复事件之间的时间差），精确到秒。
适用于问题恢复消息。
[comment]: # ({/80421dd9-d7ed9130})
[comment]: # ({aacabfbe-c21f001a})
##### {EVENT.ID} {#eventid}
触发动作的事件的数字 ID。
[comment]: # ({/aacabfbe-c21f001a})
[comment]: # ({8b1498fe-93a8cc59})
##### {EVENT.NAME} {#eventname}
触发操作的事件名称。
[comment]: # ({/8b1498fe-93a8cc59})
[comment]: # ({850ede9f-763deb60})
##### {EVENT.NSEVERITY} {#eventnseverity}
事件严重性的数值。
可能的值：*0* - 未分类，*1* - 信息，*2* - 警告，*3* - 一般严重，*4* - 高严重，*5* - 灾难。
[comment]: # ({/850ede9f-763deb60})
[comment]: # ({25df65fd-0f5314c2})
##### {EVENT.OBJECT} {#eventobject}
事件对象的数值。
可能的值：*0* - 触发器，*1* - 已发现主机，*2* - 已发现服务，*3* - 自动注册，*4* - 监控项，*5* - 低级别发现规则。
[comment]: # ({/25df65fd-0f5314c2})
[comment]: # ({e9d283b7-6e8de381})
##### {EVENT.OPDATA} {#eventopdata}
问题对应的底层触发器的运行数据。
[comment]: # ({/e9d283b7-6e8de381})
[comment]: # ({8fc6f8a7-7aec2a3d})
##### {EVENT.SEVERITY} {#eventseverity}
事件严重性的名称。
[comment]: # ({/8fc6f8a7-7aec2a3d})
[comment]: # ({15b050da-411983e3})
##### {EVENT.SOURCE} {#eventsource}
事件来源的数值。
可能的值：*0* - 触发器，*1* - 发现，*2* - 自动注册，*3* - 内部，*4* - 服务。
[comment]: # ({/15b050da-411983e3})
[comment]: # ({5552defe-5baf5c8a})
##### {EVENT.STATUS} {#eventstatus}
触发动作的事件的文字状态。
[comment]: # ({/5552defe-5baf5c8a})
[comment]: # ({edfdf730-29ee31bc})
##### {EVENT.TAGS} {#eventtags}
事件标签的逗号分隔列表。
如果不存在标签，则展开为空字符串。
[comment]: # ({/edfdf730-29ee31bc})
[comment]: # ({40441411-e6118103})
##### {EVENT.TAGSJSON} {#eventtagsjson}
包含事件标签[对象](/manual/api/reference/event/object#event-tag)的 JSON 数组。
如果不存在标签，则展开为空数组。
[comment]: # ({/40441411-e6118103})
[comment]: # ({efa0df6d-d38b4b6b})
##### {EVENT.TAGS.\} {#eventtagstagname}
由标签名称引用的事件标签值。
包含非字母数字字符的标签名称（包括非英语多字节 UTF 字符）必须用双引号括起来。带引号的标签名称中的引号和反斜杠必须使用反斜杠进行转义。
[comment]: # ({/efa0df6d-d38b4b6b})
[comment]: # ({b08cc548-d61741a1})
##### {EVENT.TIME} {#eventtime}
触发动作的事件时间，格式为 `hh:mm:ss`。
例如：12:57:53。
[comment]: # ({/b08cc548-d61741a1})
[comment]: # ({5c2fe4ad-76017759})
##### {EVENT.TIMESTAMP} {#eventtimestamp}
触发动作的事件的 UNIX 时间戳。
[comment]: # ({/5c2fe4ad-76017759})
[comment]: # ({ddb198fc-87d8263c})
##### {EVENT.VALUE} {#eventvalue}
触发动作的事件的数值。
可能的值：*1* - 故障，*0* - 恢复中。
[comment]: # ({/ddb198fc-87d8263c})
[comment]: # ({bee59a79-78f9c443})
#### 原因/症状事件宏
[comment]: # ({/bee59a79-78f9c443})
[comment]: # ({ac6de778-e09d939c})
##### {EVENT.CAUSE.ACK.STATUS} {#eventcauseackstatus}
原因事件的确认状态（是/否）。
在症状事件的上下文中使用。
[comment]: # ({/ac6de778-e09d939c})
[comment]: # ({8de4c200-13df2a34})
##### {EVENT.CAUSE.AGE} {#eventcauseage}
原因事件的持续时间，精确到秒。
在升级消息中很有用。
用于症状事件的上下文中。
[comment]: # ({/8de4c200-13df2a34})
[comment]: # ({6b6ee8de-3308f52c})
##### {EVENT.CAUSE.DATE} {#eventcausedate}
原因事件的日期，格式为 `yyyy.mm.dd`。
用于症状事件的上下文中。
[comment]: # ({/6b6ee8de-3308f52c})
[comment]: # ({65255da0-3cd3a91f})
##### {EVENT.CAUSE.DURATION} {#eventcauseduration}
原因事件的持续时间（问题事件与恢复事件之间的时间差），精确到秒。
在问题恢复消息中很有用。
用于症状事件的上下文中。
[comment]: # ({/65255da0-3cd3a91f})
[comment]: # ({c49359f0-e728cba9})
##### {EVENT.CAUSE.ID} {#eventcauseid}
原因事件的数字 ID。
在症状事件的上下文中使用。
[comment]: # ({/c49359f0-e728cba9})
[comment]: # ({dd72ba1b-8b5e521a})
##### {EVENT.CAUSE.NAME} {#eventcausename}
原因事件的名称。
在症状事件的上下文中使用。
[comment]: # ({/dd72ba1b-8b5e521a})
[comment]: # ({ae4cf02f-a6201c0e})
##### {EVENT.CAUSE.NSEVERITY} {#eventcausenseverity}
原因事件严重性的数值。
可能的值：*0* - 未分类，*1* - 信息，*2* - 警告，*3* - 一般严重，*4* - 高，*5* - 灾难。
用于症状事件的上下文中。
[comment]: # ({/ae4cf02f-a6201c0e})
[comment]: # ({0a338942-94771f51})
##### {EVENT.CAUSE.OBJECT} {#eventcauseobject}
原因事件对象的数值。
可能的值：*0* - 触发器，*1* - 已发现主机，*2* - 已发现服务，*3* - 自动注册，*4* - 监控项，*5* - 低级别发现规则。
用于症状事件的上下文中。
[comment]: # ({/0a338942-94771f51})
[comment]: # ({d93e21c0-925ef576})
##### {EVENT.CAUSE.OPDATA} {#eventcauseopdata}
原因问题的底层触发器的运行数据。
用于症状事件的上下文中。
[comment]: # ({/d93e21c0-925ef576})
[comment]: # ({df2a8330-2cb85dcc})
##### {EVENT.CAUSE.SEVERITY} {#eventcauseseverity}
原因事件严重性的名称。
可能的值：*未分类*、*信息*、*警告*、*一般严重*、*高严重*、*灾难*。
用于症状事件的上下文中。
[comment]: # ({/df2a8330-2cb85dcc})
[comment]: # ({5efcf5cd-98004b76})
##### {EVENT.CAUSE.SOURCE} {#eventcausesource}
原因事件来源的数值。
可能的值：*0* - 触发器，*1* - 发现，*2* - 自动注册，*3* - 内部。
用于症状事件的上下文中。
[comment]: # ({/5efcf5cd-98004b76})
[comment]: # ({7c8139b8-144ad029})
##### {EVENT.CAUSE.STATUS} {#eventcausestatus}
原因事件的文字值。
用于症状事件的上下文中。
[comment]: # ({/7c8139b8-144ad029})
[comment]: # ({16543dc1-c8f99d02})
##### {EVENT.CAUSE.TAGS} {#eventcausetags}
原因事件标签的逗号分隔列表。
如果不存在标签，则展开为空字符串。
用于症状事件的上下文中。
[comment]: # ({/16543dc1-c8f99d02})
[comment]: # ({bba4ac95-ae1ef98c})
##### {EVENT.CAUSE.TAGSJSON} {#eventcausetagsjson}
一个 JSON 数组，包含原因事件标签[对象](/manual/api/reference/event/object#event-tag)。
如果不存在标签，则展开为空数组。
用于症状事件的上下文中。
[comment]: # ({/bba4ac95-ae1ef98c})
[comment]: # ({b7c4971e-d48cc75b})
##### {EVENT.CAUSE.TAGS.\} {#eventcausetagstagname}
由标签名称引用的原因事件标签值。
包含非字母数字字符的标签名称（包括非英语多字节 UTF 字符）必须用双引号括起来。带引号的标签名称中的引号和反斜杠必须使用反斜杠进行转义。
用于症状事件的上下文中。
[comment]: # ({/b7c4971e-d48cc75b})
[comment]: # ({cae5e2ea-a1f5ef87})
##### {EVENT.CAUSE.TIME} {#eventcausetime}
原因事件的时间，格式为 `hh:mm:ss`。
用于症状事件的上下文中。
[comment]: # ({/cae5e2ea-a1f5ef87})
[comment]: # ({1c83c1a5-43a55d3a})
##### {EVENT.CAUSE.TIMESTAMP} {#eventcausetimestamp}
原因事件的 UNIX 时间戳。
在症状事件的上下文中使用。
[comment]: # ({/1c83c1a5-43a55d3a})
[comment]: # ({84a1dac2-bf9564d5})
##### {EVENT.CAUSE.UPDATE.HISTORY} {#eventcauseupdhistory}
原因问题更新日志（确认等）。
用于症状事件的上下文中。
[comment]: # ({/84a1dac2-bf9564d5})
[comment]: # ({6dcd21b2-6d085123})
##### {EVENT.CAUSE.VALUE} {#eventcausevalue}
原因事件的数值。
可能的值：*1* - 问题，*0* - 恢复中。
在症状事件的上下文中使用。
[comment]: # ({/6dcd21b2-6d085123})
[comment]: # ({f4cbf63f-a0e4b970})
##### {EVENT.SYMPTOMS} {#eventsymptoms}
症状事件列表。包括以下详细信息：主机名称、事件名称、严重性、持续时间、服务标签和值。
此宏用于原因事件的上下文中，并返回有关症状事件的信息。
[comment]: # ({/f4cbf63f-a0e4b970})
[comment]: # ({a4d6d2d0-7ed81d84})
#### 恢复事件宏
[comment]: # ({/a4d6d2d0-7ed81d84})
[comment]: # ({a703e843-4e9d0e62})
##### {EVENT.RECOVERY.DATE} {#eventrecdate}
恢复事件的日期，格式为 `yyyy.mm.dd`。
[comment]: # ({/a703e843-4e9d0e62})
[comment]: # ({099d4a8d-3ce954ba})
##### {EVENT.RECOVERY.ID} {#eventrecid}
恢复事件的数字 ID。
[comment]: # ({/099d4a8d-3ce954ba})
[comment]: # ({122c21bc-e32175af})
##### {EVENT.RECOVERY.NAME} {#eventrecname}
恢复事件的名称。
[comment]: # ({/122c21bc-e32175af})
[comment]: # ({240a7de8-7f89e0ad})
##### {EVENT.RECOVERY.STATUS} {#eventrecstatus}
恢复事件的文字值。
[comment]: # ({/240a7de8-7f89e0ad})
[comment]: # ({4930b138-02a93adf})
##### {EVENT.RECOVERY.TAGS} {#eventrectags}
恢复事件标签的逗号分隔列表。如果不存在标签，则扩展为空字符串。
[comment]: # ({/4930b138-02a93adf})
[comment]: # ({921d453a-130a70c5})
##### {EVENT.RECOVERY.TAGSJSON} {#eventrectagsjson}
包含恢复事件标签[对象](/manual/api/reference/event/object#event-tag)的 JSON 数组。如果不存在标签，则展开为空数组。
[comment]: # ({/921d453a-130a70c5})
[comment]: # ({183b03eb-651f9a3a})
##### {EVENT.RECOVERY.TIME} {#eventrectime}
恢复事件的时间，格式为 `hh:mm:ss`。
[comment]: # ({/183b03eb-651f9a3a})
[comment]: # ({221a43f9-14e5fe05})
##### {EVENT.RECOVERY.TIMESTAMP} {#eventrectimestamp}
恢复事件的 UNIX 时间戳。
[comment]: # ({/221a43f9-14e5fe05})
[comment]: # ({06653adc-0bcdbcf8})
##### {EVENT.RECOVERY.VALUE} {#eventrecvalue}
恢复事件的数值。
[comment]: # ({/06653adc-0bcdbcf8})
[comment]: # ({44bb63cf-56cc4ae9})
#### 事件更新宏
[comment]: # ({/44bb63cf-56cc4ae9})
[comment]: # ({cc164169-a910616d})
##### {EVENT.UPDATE.ACTION} {#eventupdaction}
在[问题更新](/manual/acknowledgment#updating-problems)期间执行的操作的人类可读名称。
解析为以下值：*acknowledged*、*unacknowledged*、*commented*、*changed severity from (original severity) to (updated severity)* 和 *closed*（取决于一次更新中执行了多少个操作）。
[comment]: # ({/cc164169-a910616d})
[comment]: # ({a963a5e6-76163c60})
##### {EVENT.UPDATE.ACTIONJSON} {#eventupdactionjson}
一个 JSON 数组，包含在[问题更新](/manual/acknowledgment#updating-problems)期间执行的操作详情。
可能的 JSON 属性值：
- true（用于 `acknowledge`、`unacknowledge`、`close`、`unsuppress`、`cause` 和 `symptom` 属性）；
- \（用于 `message` 属性）；
- 时间戳（用于 `suppress_until` 和 `timestamp` 属性），或 0（当无限期抑制时，用于 `suppress_until` 属性）；
- 0、1、2、3、4、5（用于严重性 `old` 和 `new` 属性）。
例如：`{"acknowledge":true,"message":"Monthly maintenance.","severity":{"old":2,"new":1},"suppress_until":1730851199,"timestamp":1730822048}`。
[comment]: # ({/a963a5e6-76163c60})
[comment]: # ({23372b40-99808eda})
##### {EVENT.UPDATE.DATE} {#eventupddate}
事件[更新](/manual/config/notifications/action/update_operations)（确认等）的日期，格式为 `yyyy.mm.dd`。
[comment]: # ({/23372b40-99808eda})
[comment]: # ({3b855a51-8bbf7bae})
##### {EVENT.UPDATE.HISTORY} {#eventupdhistory}
问题更新（确认等）的日志。
[comment]: # ({/3b855a51-8bbf7bae})
[comment]: # ({6f989e9e-0cf8c0ce})
##### {EVENT.UPDATE.MESSAGE} {#eventupdmessage}
问题更新消息。
[comment]: # ({/6f989e9e-0cf8c0ce})
[comment]: # ({637b4e2c-6b9d9359})
##### {EVENT.UPDATE.NSEVERITY} {#eventupdnseverity}
问题更新操作期间设置的新事件严重性的数值。
[comment]: # ({/637b4e2c-6b9d9359})
[comment]: # ({ef102699-1666d654})
##### {EVENT.UPDATE.SEVERITY} {#eventupdseverity}
在问题更新操作期间设置的新事件严重性的名称。
[comment]: # ({/ef102699-1666d654})
[comment]: # ({2f1d8084-bf978953})
##### {EVENT.UPDATE.STATUS} {#eventupdstatus}
问题更新状态的数值。
可能的值：*0* - 因问题/恢复事件而调用 webhook，*1* - 更新操作。
[comment]: # ({/2f1d8084-bf978953})
[comment]: # ({862b262b-b179ed77})
##### {EVENT.UPDATE.TIME} {#eventupdtime}
事件[更新](/manual/config/notifications/action/update_operations)（确认等）的时间，格式为 `hh:mm:ss`。
[comment]: # ({/862b262b-b179ed77})
[comment]: # ({996e412a-d65bbadb})
##### {EVENT.UPDATE.TIMESTAMP} {#eventupdtimestamp}
事件[更新](/manual/config/notifications/action/update_operations)（确认等）的 UNIX 时间戳。
[comment]: # ({/996e412a-d65bbadb})
[comment]: # ({80346ab8-bb063180})
#### 函数宏
[comment]: # ({/80346ab8-bb063180})
[comment]: # ({25fc7edf-eb4e54b5})
##### {FUNCTION.VALUE} {#functionvalue}
事件发生时，触发器表达式中第 N 个基于监控项的函数的值。
仅统计将 `/host/key` 作为第一个参数的函数。
此宏可与数字索引一起使用，例如 {FUNCTION.VALUE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等函数。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/25fc7edf-eb4e54b5})
[comment]: # ({57df23b3-0b34437d})
##### {FUNCTION.RECOVERY.VALUE} {#functionrecvalue}
事件发生时恢复表达式中第 N 个基于监控项的函数的值。*
仅统计将 `/host/key` 作为第一个参数的函数。
此宏可与数字索引一起使用，例如 {FUNCTION.RECOVERY.VALUE[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等函数。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/57df23b3-0b34437d})
[comment]: # ({1a145999-14904012})
#### 主机宏
[comment]: # ({/1a145999-14904012})
[comment]: # ({ab679b79-7eea138d})
##### {HOST.CONN} {#hostconn}
主机 IP 地址或 DNS 名称，具体取决于主机设置。
在全局脚本中、接口 IP/DNS 字段中以及 Web 场景中，该宏将解析为主 agent 接口。如果未定义 agent 接口，则将使用主 SNMP 接口。如果也未定义 SNMP 接口，则将使用主 JMX 接口。如果也未定义 JMX 接口，则将使用主 IPMI 接口。如果主机没有任何接口，则该宏将解析为“UNKNOWN”。
此宏可与数字索引一起使用，如 {HOST.CONN[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/ab679b79-7eea138d})
[comment]: # ({f0a3403d-dc874a22})
##### {HOST.DESCRIPTION} {#hostdescription}
主机描述。
此宏可与数字索引一起使用，如 {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/f0a3403d-dc874a22})
[comment]: # ({96110e19-cab2e2c6})
##### {HOST.DNS} {#hostdns}
主机 DNS 名称。
在全局脚本中、接口 IP/DNS 字段中以及 Web 场景中，该宏将解析为主 agent 接口。如果未定义 agent 接口，则将使用主 SNMP 接口。如果也未定义 SNMP 接口，则将使用主 JMX 接口。如果也未定义 JMX 接口，则将使用主 IPMI 接口。如果主机没有任何接口，则该宏将解析为“UNKNOWN”。
该宏可与数字索引一起使用，例如 {HOST.DNS[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/96110e19-cab2e2c6})
[comment]: # ({24a4e02b-c4123090})
##### {HOST.HOST} {#hosthost}
技术主机名称。
如果此宏在[历史函数](/manual/config/triggers/expression/history)的第一个参数中用作占位符，则不支持对此宏使用[宏函数](/manual/config/macros/macro_functions)，例如 `last(/{HOST.HOST}/{ITEM.KEY})`。
此宏可与数字索引一起使用，如 {HOST.HOST[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/24a4e02b-c4123090})
[comment]: # ({f86246b6-337bfb7e})
##### {HOST.ID} {#hostid}
主机 ID。
此宏可与数字索引一起使用，如 {HOST.ID[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/f86246b6-337bfb7e})
[comment]: # ({45615bc8-a0cba641})
##### {HOST.IP} {#hostip}
主机 IP 地址。
在全局脚本中、接口 IP/DNS 字段以及 Web 场景中，该宏将解析为主 agent 接口。如果未定义 agent 接口，则将使用主 SNMP 接口。如果也未定义 SNMP 接口，则将使用主 JMX 接口。如果也未定义 JMX 接口，则将使用主 IPMI 接口。如果主机没有任何接口，则该宏将解析为“UNKNOWN”。
该宏可与数字索引一起使用，如 {HOST.IP[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/45615bc8-a0cba641})
[comment]: # ({e3c8fbd9-ded922ee})
##### {HOST.METADATA} {#hostmetadata}
主机元数据。
仅用于活动 agent 自动注册。
[comment]: # ({/e3c8fbd9-ded922ee})
[comment]: # ({5e84d79d-8edda063})
##### {HOST.NAME} {#hostname}
可见的主机名称。
此宏可使用数字索引，例如 {HOST.NAME[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/5e84d79d-8edda063})
[comment]: # ({08feaadf-39d82847})
##### {HOST.PORT} {#hostport}
主机的（agent）端口。
在全局脚本、接口 IP/DNS 字段和 web 场景中，该宏将解析为主 agent 接口。如果未定义 agent 接口，则将使用主 SNMP 接口。如果也未定义 SNMP 接口，则将使用主 JMX 接口。如果也未定义 JMX 接口，则将使用主 IPMI 接口。如果主机没有任何接口，则该宏将解析为“UNKNOWN”。
该宏可与数字索引一起使用，如 {HOST.PORT[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/08feaadf-39d82847})
[comment]: # ({520d5e6e-43916c5f})
#### 目标主机宏
[comment]: # ({/520d5e6e-43916c5f})
[comment]: # ({d37784e8-f243904b})
##### {HOST.TARGET.CONN} {#hosttargetconn}
目标主机的 IP 地址或 DNS 名称。
[comment]: # ({/d37784e8-f243904b})
[comment]: # ({d6b754be-fdceab66})
##### {HOST.TARGET.DNS} {#hosttargetdns}
目标主机的 DNS 名称。
[comment]: # ({/d6b754be-fdceab66})
[comment]: # ({a22676fb-cca62410})
##### {HOST.TARGET.HOST} {#hosttargethost}
目标主机的技术名称。
[comment]: # ({/a22676fb-cca62410})
[comment]: # ({aa6ef4e0-0f2b55a4})
##### {HOST.TARGET.IP} {#hosttargetip}
目标主机的 IP 地址。
[comment]: # ({/aa6ef4e0-0f2b55a4})
[comment]: # ({319264e0-2246f354})
##### {HOST.TARGET.NAME} {#hosttargetname}
目标主机的可见名称。
[comment]: # ({/319264e0-2246f354})
[comment]: # ({50ff79bd-1f6638b7})
### 主机组宏
[comment]: # ({/50ff79bd-1f6638b7})
[comment]: # ({f1d7541d-f0f04c5e})
##### {HOSTGROUP.ID} {#hostgroupid}
主机组 ID。
[comment]: # ({/f1d7541d-f0f04c5e})
[comment]: # ({e4732753-ba19ffd4})
#### 主机资产记录宏
[comment]: # ({/e4732753-ba19ffd4})
[comment]: # ({4f8420da-e2fe0993})
##### {INVENTORY.ALIAS} {#inventoryalias}
主机清单中的 *Alias* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.ALIAS[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/4f8420da-e2fe0993})
[comment]: # ({f8010f40-dcfb5624})
##### {INVENTORY.ASSET.TAG} {#inventoryassettag}
主机清单中的 *资产标签* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.ASSET.TAG[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/f8010f40-dcfb5624})
[comment]: # ({3824909d-99fad19f})
##### {INVENTORY.CHASSIS} {#inventorychassis}
主机资产记录中的 *机箱* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.CHASSIS[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/3824909d-99fad19f})
[comment]: # ({09b8ebfd-62c0cd6a})
##### {INVENTORY.CONTACT} {#inventorycontact}
主机清单中的 *Contact* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.CONTACT[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/09b8ebfd-62c0cd6a})
[comment]: # ({98743825-38b8d20c})
##### {INVENTORY.CONTRACT.NUMBER} {#inventorycontractnumber}
主机清单中的*合同编号*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.CONTRACT.NUMBER[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/98743825-38b8d20c})
[comment]: # ({dcbb90e4-c4b13b3c})
##### {INVENTORY.DEPLOYMENT.STATUS} {#inventorydeplstatus}
主机清单中的*部署状态*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.DEPLOYMENT.STATUS[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/dcbb90e4-c4b13b3c})
[comment]: # ({e75b9c0f-99f3a899})
##### {INVENTORY.HARDWARE} {#inventoryhardware}
主机清单中的 *Hardware* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HARDWARE[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/e75b9c0f-99f3a899})
[comment]: # ({bec90b13-8aabe0c5})
##### {INVENTORY.HARDWARE.FULL} {#inventoryhardwarefull}
主机清单中的 *硬件（完整详细信息）* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HARDWARE.FULL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/bec90b13-8aabe0c5})
[comment]: # ({2114361b-bcbc90b4})
##### {INVENTORY.HOST.NETMASK} {#inventoryhostnetmask}
主机清单中的*主机子网掩码*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HOST.NETMASK[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/2114361b-bcbc90b4})
[comment]: # ({6acfd19c-5bf9fbf8})
##### {INVENTORY.HOST.NETWORKS} {#inventoryhostnetworks}
主机清单中的*主机网络*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HOST.NETWORKS[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/6acfd19c-5bf9fbf8})
[comment]: # ({be276f4c-57070b03})
##### {INVENTORY.HOST.ROUTER} {#inventoryhostrouter}
主机清单中的 *主机路由器* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HOST.ROUTER[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/be276f4c-57070b03})
[comment]: # ({a7e5d326-61c0bd64})
##### {INVENTORY.HW.ARCH} {#inventoryhwarch}
主机资产清单中的*硬件架构*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HW.ARCH[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/a7e5d326-61c0bd64})
[comment]: # ({79fbab81-bb07ff52})
##### {INVENTORY.HW.DATE.DECOMM} {#inventoryhwdatedecomm}
主机清单中的*硬件退役日期*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HW.DATE.DECOMM[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/79fbab81-bb07ff52})
[comment]: # ({eb730497-f38d161e})
##### {INVENTORY.HW.DATE.EXPIRY} {#inventoryhwdateexpiry}
主机资产清单中的*硬件维护到期日期*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HW.DATE.EXPIRY[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/eb730497-f38d161e})
[comment]: # ({eebd6564-df3e64f5})
##### {INVENTORY.HW.DATE.INSTALL} {#inventoryhwdateinstall}
主机资产清单中的*硬件安装日期*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HW.DATE.INSTALL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/eebd6564-df3e64f5})
[comment]: # ({a1e603fc-cae97400})
##### {INVENTORY.HW.DATE.PURCHASE} {#inventoryhwdatepurchase}
主机资产清单中的*硬件购买日期*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.HW.DATE.PURCHASE[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/a1e603fc-cae97400})
[comment]: # ({e2d51817-53f1c959})
##### {INVENTORY.INSTALLER.NAME} {#inventoryinstallername}
主机清单中的 *安装程序名称* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.INSTALLER.NAME[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/e2d51817-53f1c959})
[comment]: # ({ad5ee131-c9abb151})
##### {INVENTORY.LOCATION} {#inventorylocation}
主机资产记录中的 *位置* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.LOCATION[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/ad5ee131-c9abb151})
[comment]: # ({c08ada80-a43379c6})
##### {INVENTORY.LOCATION.LAT} {#inventoryloclat}
主机资产记录中的 *位置纬度* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.LOCATION.LAT[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/c08ada80-a43379c6})
[comment]: # ({f4d6c8bd-0cfb66ea})
##### {INVENTORY.LOCATION.LON} {#inventoryloclon}
主机清单中的 *位置经度* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.LOCATION.LON[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/f4d6c8bd-0cfb66ea})
[comment]: # ({5c9dcedf-fdd1f352})
##### {INVENTORY.MACADDRESS.A} {#inventorymacaddressa}
主机清单中的 *MAC address A* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.MACADDRESS.A[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/5c9dcedf-fdd1f352})
[comment]: # ({400dba31-c1d257f1})
##### {INVENTORY.MACADDRESS.B} {#inventorymacaddressb}
主机资产清单中的 *MAC address B* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.MACADDRESS.B[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/400dba31-c1d257f1})
[comment]: # ({7b058e88-1ee56603})
##### {INVENTORY.MODEL} {#inventorymodel}
主机资产清单中的 *Model* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.MODEL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/7b058e88-1ee56603})
[comment]: # ({a2b47475-19586911})
##### {INVENTORY.NAME} {#inventoryname}
主机清单中的 *Name* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.NAME[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [indexed macros](supported_by_location#indexed-macros)。
[comment]: # ({/a2b47475-19586911})
[comment]: # ({7d299a48-5390450c})
##### {INVENTORY.NOTES} {#inventorynotes}
主机清单中的 *备注* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.NOTES[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/7d299a48-5390450c})
[comment]: # ({730bc2e8-1de05e9c})
##### {INVENTORY.OOB.IP} {#inventoryoobip}
主机资产清单中的 *OOB IP 地址* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.OOB.IP[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/730bc2e8-1de05e9c})
[comment]: # ({ffe384e4-a8b1d085})
##### {INVENTORY.OOB.NETMASK} {#inventoryoobnetmask}
主机资产清单中的 *OOB 子网掩码* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.OOB.NETMASK[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/ffe384e4-a8b1d085})
[comment]: # ({c5787d26-b9d61610})
##### {INVENTORY.OOB.ROUTER} {#inventoryoobrouter}
主机清单中的 *OOB 路由器* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.OOB.ROUTER[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/c5787d26-b9d61610})
[comment]: # ({53115bfb-284c4a3b})
##### {INVENTORY.OS} {#inventoryos}
主机清单中的 *OS* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.OS[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/53115bfb-284c4a3b})
[comment]: # ({e5c649f0-de1a9816})
##### {INVENTORY.OS.FULL} {#inventoryosfull}
主机清单中的 *OS（完整详细信息）* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.OS.FULL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/e5c649f0-de1a9816})
[comment]: # ({cf2f0dba-95d5c0f1})
##### {INVENTORY.OS.SHORT} {#inventoryosshort}
主机清单中的 *OS（短）* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.OS.SHORT[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/cf2f0dba-95d5c0f1})
[comment]: # ({f2fb5ba1-eff0b2f3})
##### {INVENTORY.POC.PRIMARY.CELL} {#inventorypocprimarycell}
主机清单中的 *主要联系人手机* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.PRIMARY.CELL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/f2fb5ba1-eff0b2f3})
[comment]: # ({9fbd371c-bf13fd41})
##### {INVENTORY.POC.PRIMARY.EMAIL} {#inventorypocprimaryemail}
主机资产清单中的 *主要联系人电子邮件* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.PRIMARY.EMAIL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/9fbd371c-bf13fd41})
[comment]: # ({8ccf1b22-82d2640e})
##### {INVENTORY.POC.PRIMARY.NAME} {#inventorypocprimaryname}
主机资产清单中的*主要联系人姓名*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.PRIMARY.NAME[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/8ccf1b22-82d2640e})
[comment]: # ({64038225-4fa59942})
##### {INVENTORY.POC.PRIMARY.NOTES} {#inventorypocprimarynotes}
主机资产清单中的*主要联系人备注*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.PRIMARY.NOTES[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/64038225-4fa59942})
[comment]: # ({6c4e4830-48f0e3ba})
##### {INVENTORY.POC.PRIMARY.PHONE.A} {#inventorypocprimaryphonea}
主机清单中的 *主要 POC 电话 A* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.PRIMARY.PHONE.A[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/6c4e4830-48f0e3ba})
[comment]: # ({60fde353-61e4e5ea})
##### {INVENTORY.POC.PRIMARY.PHONE.B} {#inventorypocprimaryphoneb}
主机清单中的 *主要联系人电话 B* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.PRIMARY.PHONE.B[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/60fde353-61e4e5ea})
[comment]: # ({6853b3f2-d5a86bfd})
##### {INVENTORY.POC.PRIMARY.SCREEN} {#inventorypocprimaryscreen}
主机清单中的 *主要 POC 屏幕名称* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.PRIMARY.SCREEN[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/6853b3f2-d5a86bfd})
[comment]: # ({345b7746-ba1c64e4})
##### {INVENTORY.POC.SECONDARY.CELL} {#inventorypocsecondarycell}
主机资产记录中的*次要 POC 手机*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.SECONDARY.CELL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/345b7746-ba1c64e4})
[comment]: # ({2922785c-4240bfd2})
##### {INVENTORY.POC.SECONDARY.EMAIL} {#inventorypocsecondaryemail}
主机清单中的*次要 POC 电子邮件*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.SECONDARY.EMAIL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/2922785c-4240bfd2})
[comment]: # ({0bd15e5c-7851ce2a})
##### {INVENTORY.POC.SECONDARY.NAME} {#inventorypocsecondaryname}
主机资产清单中的*次要 POC 名称*字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.SECONDARY.NAME[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/0bd15e5c-7851ce2a})
[comment]: # ({c00112ba-1b6871c9})
##### {INVENTORY.POC.SECONDARY.NOTES} {#inventorypocsecondarynotes}
主机清单中的 *Secondary POC notes* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.SECONDARY.NOTES[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/c00112ba-1b6871c9})
[comment]: # ({0d5ffd1d-0bb74597})
##### {INVENTORY.POC.SECONDARY.PHONE.A} {#inventorypocsecondaryphonea}
主机资产清单中的 *Secondary POC phone A* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.SECONDARY.PHONE.A[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/0d5ffd1d-0bb74597})
[comment]: # ({47dfd2fd-a9ccd7e3})
##### {INVENTORY.POC.SECONDARY.PHONE.B} {#inventorypocsecondaryphoneb}
主机资产清单中的 *Secondary POC phone B* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.SECONDARY.PHONE.B[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/47dfd2fd-a9ccd7e3})
[comment]: # ({4d850eb6-e59f0136})
##### {INVENTORY.POC.SECONDARY.SCREEN} {#inventorypocsecondaryscreen}
主机清单中的 *Secondary POC screen name* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.POC.SECONDARY.SCREEN[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [indexed macros](supported_by_location#indexed-macros)。
[comment]: # ({/4d850eb6-e59f0136})
[comment]: # ({3dba15d9-137a9eea})
##### {INVENTORY.SERIALNO.A} {#inventoryserialnoa}
主机资产清单中的 *序列号 A* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SERIALNO.A[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/3dba15d9-137a9eea})
[comment]: # ({3a3848d6-92cc5c3c})
##### {INVENTORY.SERIALNO.B} {#inventoryserialnob}
主机清单中的 *序列号 B* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SERIALNO.B[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/3a3848d6-92cc5c3c})
[comment]: # ({133da172-68c1bf28})
##### {INVENTORY.SITE.ADDRESS.A} {#inventorysiteaddressa}
主机资产记录中的 *Site address A* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.ADDRESS.A[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/133da172-68c1bf28})
[comment]: # ({b395ad0d-1151353f})
##### {INVENTORY.SITE.ADDRESS.B} {#inventorysiteaddressb}
主机资产记录中的 *站点地址 B* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.ADDRESS.B[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/b395ad0d-1151353f})
[comment]: # ({cabc061c-72ff1463})
##### {INVENTORY.SITE.ADDRESS.C} {#inventorysiteaddressc}
主机资产记录中的 *站点地址 C* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.ADDRESS.C[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/cabc061c-72ff1463})
[comment]: # ({c415ed96-4a115d68})
##### {INVENTORY.SITE.CITY} {#inventorysitecity}
主机清单中的 *站点城市* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.CITY[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/c415ed96-4a115d68})
[comment]: # ({17dac342-9c6d7525})
##### {INVENTORY.SITE.COUNTRY} {#inventorysitecountry}
主机资产记录中的 *站点国家* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.COUNTRY[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/17dac342-9c6d7525})
[comment]: # ({d01ce6b0-f8724a83})
##### {INVENTORY.SITE.NOTES} {#inventorysitenotes}
主机资产记录中的 *站点备注* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.NOTES[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/d01ce6b0-f8724a83})
[comment]: # ({cce69886-15a71b6d})
##### {INVENTORY.SITE.RACK} {#inventorysiterack}
主机清单中的 *站点机架位置* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.RACK[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/cce69886-15a71b6d})
[comment]: # ({cc7e8b99-b4196846})
##### {INVENTORY.SITE.STATE} {#inventorysitestate}
主机清单中的 *站点州/省* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.STATE[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/cc7e8b99-b4196846})
[comment]: # ({68f47860-456ce9dd})
##### {INVENTORY.SITE.ZIP} {#inventorysitezip}
主机清单中的 *站点 ZIP/邮政编码* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SITE.ZIP[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/68f47860-456ce9dd})
[comment]: # ({00a2f65e-26e69478})
##### {INVENTORY.SOFTWARE} {#inventorysoftware}
主机清单中的 *Software* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SOFTWARE[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/00a2f65e-26e69478})
[comment]: # ({99f7bc20-c810b277})
##### {INVENTORY.SOFTWARE.APP.A} {#inventorysoftwareappa}
主机清单中的 *软件应用程序 A* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SOFTWARE.APP.A[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/99f7bc20-c810b277})
[comment]: # ({dc120b12-0030b724})
##### {INVENTORY.SOFTWARE.APP.B} {#inventorysoftwareappb}
主机清单中的 *软件应用程序 B* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SOFTWARE.APP.B[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/dc120b12-0030b724})
[comment]: # ({556dcaf5-d316291a})
##### {INVENTORY.SOFTWARE.APP.C} {#inventorysoftwareappc}
主机清单中的 *软件应用程序 C* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SOFTWARE.APP.C[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/556dcaf5-d316291a})
[comment]: # ({a03b1f7e-99ca3eaa})
##### {INVENTORY.SOFTWARE.APP.D} {#inventorysoftwareappd}
主机资产清单中的 *软件应用程序 D* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SOFTWARE.APP.D[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/a03b1f7e-99ca3eaa})
[comment]: # ({874019e4-61521a2b})
##### {INVENTORY.SOFTWARE.APP.E} {#inventorysoftwareappe}
主机清单中的 *Software application E* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SOFTWARE.APP.E[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/874019e4-61521a2b})
[comment]: # ({19b93bf4-cd1c4d13})
##### {INVENTORY.SOFTWARE.FULL} {#inventorysoftwarefull}
主机清单中的 *软件（完整详情）* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.SOFTWARE.FULL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/19b93bf4-cd1c4d13})
[comment]: # ({bebe9e88-63291045})
##### {INVENTORY.TAG} {#inventorytag}
主机清单中的 *Tag* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.TAG[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/bebe9e88-63291045})
[comment]: # ({b3bfec5a-71f89806})
##### {INVENTORY.TYPE} {#inventorytype}
主机资产清单中的 *Type* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.TYPE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/b3bfec5a-71f89806})
[comment]: # ({89b3ca1f-02e06ab5})
##### {INVENTORY.TYPE.FULL} {#inventorytypefull}
主机资产记录中的 *类型（完整详情）* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.TYPE.FULL[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/89b3ca1f-02e06ab5})
[comment]: # ({93bf8e35-1aed868c})
##### {INVENTORY.URL.A} {#inventoryurla}
主机资产清单中的 *URL A* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.URL.A[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/93bf8e35-1aed868c})
[comment]: # ({1c7b319e-24f40fd3})
##### {INVENTORY.URL.B} {#inventoryurlb}
主机资产清单中的 *URL B* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.URL.B[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/1c7b319e-24f40fd3})
[comment]: # ({8e1051cd-31cabdf1})
##### {INVENTORY.URL.C} {#inventoryurlc}
主机资产清单中的 *URL C* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.URL.C[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/8e1051cd-31cabdf1})
[comment]: # ({218836fc-e6a037b2})
##### {INVENTORY.VENDOR} {#inventoryvendor}
主机清单中的 *Vendor* 字段。
此宏可与数字索引一起使用，例如 {INVENTORY.VENDOR[<1-9>](supported_by_location#indexed-macros)}，以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/218836fc-e6a037b2})
[comment]: # ({b5eb7961-78a9af13})
#### 监控项宏
[comment]: # ({/b5eb7961-78a9af13})
[comment]: # ({c6ced574-fd2a7480})
##### {ITEM.DESCRIPTION} {#itemdescription}
导致通知的触发器表达式中第 N 个监控项的描述。
此宏可与数字索引一起使用，即 {ITEM.DESCRIPTION[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/c6ced574-fd2a7480})
[comment]: # ({11a4b457-cc7c2a50})
##### {ITEM.DESCRIPTION.ORIG} {#itemdescriptionorig}
导致通知的触发器表达式中第 N 个监控项的原始描述（宏未解析）。
此宏可与数字索引一起使用，如 {ITEM.DESCRIPTION.ORIG[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等主机。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/11a4b457-cc7c2a50})
[comment]: # ({6491b1d1-002b62b7})
##### {ITEM.ID} {#itemid}
导致通知的触发器表达式中第 N 个监控项的数字 ID。
此宏可与数字索引一起使用，即 {ITEM.ID[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/6491b1d1-002b62b7})
[comment]: # ({c5042dc9-7ec1edaa})
##### {ITEM.KEY} {#itemkey}
导致通知的触发器表达式中第 N 个监控项的键。
如果此宏用作[历史函数](/manual/config/triggers/expression/history)第一个参数中的占位符，则不支持对此宏使用[宏函数](/manual/config/macros/macro_functions)，例如：`last(/{HOST.HOST}/{ITEM.KEY})`。
此宏可与数字索引一起使用，如 {ITEM.KEY[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/c5042dc9-7ec1edaa})
[comment]: # ({9b1a4da8-1416b6ad})
##### {ITEM.KEY.ORIG} {#itemkeyorig}
导致通知的触发器表达式中第 N 个监控项的原始键值（宏未解析）。
此宏可与数字索引一起使用，形式为 {ITEM.KEY.ORIG[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等主机。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/9b1a4da8-1416b6ad})
[comment]: # ({e80158fb-b0eef386})
##### {ITEM.LASTVALUE} {#itemlastvalue}
导致通知发送的触发器表达式中第 N 个监控项的最新值。
如果最新历史值是在 *Max history display period* 时间之前采集的（在 [Administration → General](/manual/web_interface/frontend_sections/administration/general#gui) 菜单部分中设置），则该宏在前端中将解析为 \*UNKNOWN\*。
当在问题名称中使用时，查看问题事件时，该宏不会解析为监控项的最新值；相反，它会保留问题发生时的监控项值。
当在通知中使用时，在某些情况下，该宏可能不会解析为触发器触发时刻的最新监控项值。例如，如果某个监控项快速接收到两个值“A”和“B”，并且触发器因“A”而触发，则由于轻微的处理延迟，通知中显示的最新值可能是“B”——在触发器触发与通知创建之间的这段时间内，最新监控项值发生了变化。为避免这种情况，可以使用 {ITEM.VALUE} 宏，它会解析为触发器触发时刻的值，从而确保通知中使用的是正确的值。
它是 `last(/{HOST.HOST}/{ITEM.KEY})` 的别名。
对于 text/log 监控项，解析后的值在以下位置会被前端截断为 20 个字符：
- 运行数据；
- 触发器描述；
- 触发器 URL；
- 触发器 URL 标签；
- 监控项值小部件的描述。
如需解析为完整值，可使用 [macro functions](/manual/config/macros/macro_functions)，因为服务器不会截断任何值。例如：`{{ITEM.LASTVALUE}.regsub("(.*)", \1)}`。
该宏可与数字索引一起使用，例如 {ITEM.LASTVALUE[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见 [indexed macros](supported_by_location#indexed-macros)。
[comment]: # ({/e80158fb-b0eef386})
[comment]: # ({ca974df2-5e454666})
##### {ITEM.LASTVALUE.AGE} {#itemlastvalueage}
最新监控项值采集与宏求值之间经过的时间。
以人类可读的格式显示（例如 1m 45s）。
此宏可与数字索引一起使用，例如 {ITEM.LASTVALUE.AGE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/ca974df2-5e454666})
[comment]: # ({59e54b06-edbe0858})
##### {ITEM.LASTVALUE.DATE} {#itemlastvaluedate}
最新监控项值被采集时的日期。
以 `YYYYMMDD` 格式显示。
在触发器名称（位于“监测 -> 问题”列表中）、事件名称以及标签名称和值中，使用服务器时区。在所有其他情况下，使用用户时区。
此宏可与数字索引一起使用，例如 {ITEM.LASTVALUE.DATE[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/59e54b06-edbe0858})
[comment]: # ({b6c2950c-bdb8c2a3})
##### {ITEM.LASTVALUE.TIME} {#itemlastvaluetime}
最新监控项值被采集时的时间。
以 `HHMMSS` 格式显示。
在触发器名称（位于 Monitoring -> Problems 列表中）、事件名称以及标签名称和值中，使用服务器时区。在所有其他情况下，使用用户时区。
此宏可与数字索引一起使用，例如 {ITEM.LASTVALUE.TIME[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/b6c2950c-bdb8c2a3})
[comment]: # ({15c83298-3873d8d4})
##### {ITEM.LASTVALUE.TIMESTAMP} {#itemlastvaluetimestamp}
最新监控项值被采集时的 UNIX 时间戳。
此宏可与数字索引一起使用，例如 {ITEM.LASTVALUE.TIMESTAMP[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/15c83298-3873d8d4})
[comment]: # ({3e987c67-b2a2ed2c})
##### {ITEM.LOG.AGE} {#itemlogage}
日志事件的时长。
精确到秒。
此宏可与数字索引一起使用，例如 {ITEM.LOG.AGE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见 [带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/3e987c67-b2a2ed2c})
[comment]: # ({070be746-adaa4d62})
##### {ITEM.LOG.DATE} {#itemlogdate}
日志条目写入日志时的日期。
此宏可与数字索引一起使用，例如 {ITEM.LOG.DATE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/070be746-adaa4d62})
[comment]: # ({f2aeede0-da46123c})
##### {ITEM.LOG.EVENTID} {#itemlogeventid}
事件日志中事件的 ID。
仅适用于 Windows 事件日志监控。
此宏可与数字索引一起使用，例如 {ITEM.LOG.EVENTID[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/f2aeede0-da46123c})
[comment]: # ({5834f9eb-6581be99})
##### {ITEM.LOG.NSEVERITY} {#itemlognseverity}
事件日志中事件的数字严重性。
仅适用于 Windows 事件日志监控。
此宏可与数字索引一起使用，例如 {ITEM.LOG.NSEVERITY[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/5834f9eb-6581be99})
[comment]: # ({948b8e5e-b556ff96})
##### {ITEM.LOG.SEVERITY} {#itemlogseverity}
事件日志中事件的文字严重性。
仅适用于 Windows 事件日志监控。
此宏可与数字索引一起使用，例如 {ITEM.LOG.SEVERITY[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/948b8e5e-b556ff96})
[comment]: # ({309eb2b3-6780ae91})
##### {ITEM.LOG.SOURCE} {#itemlogsource}
事件日志中事件的来源。
仅适用于 Windows 事件日志监控。
此宏可与数字索引一起使用，例如 {ITEM.LOG.SOURCE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/309eb2b3-6780ae91})
[comment]: # ({88eea7ca-213f2a49})
##### {ITEM.LOG.TIME} {#itemlogtime}
日志条目写入日志的时间。
此宏可与数字索引一起使用，例如 {ITEM.LOG.TIME[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/88eea7ca-213f2a49})
[comment]: # ({3b9574e0-be62ddb7})
##### {ITEM.LOG.TIMESTAMP} {#itemlogtimestamp}
日志条目写入日志时的 UNIX 时间戳。
此宏可与数字索引一起使用，例如 {ITEM.LOG.TIMESTAMP[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/3b9574e0-be62ddb7})
[comment]: # ({d9c24c30-8e7c90a1})
##### {ITEM.NAME} {#itemname}
已解析所有宏后的监控项名称。
此宏可与数字索引一起使用，例如 {ITEM.NAME[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/d9c24c30-8e7c90a1})
[comment]: # ({f3e26130-10ab39e0})
##### {ITEM.NAME.ORIG} {#itemnameorig}
监控项的原始名称（宏未解析）。
此宏可与数字索引一起使用，例如 {ITEM.NAME.ORIG[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/f3e26130-10ab39e0})
[comment]: # ({1390a319-1ae67b2a})
##### {ITEM.STATE} {#itemstate}
导致通知的触发器表达式中第 N 个监控项的最新状态。
可能的值：*不支持*、*正常*。
此宏可与数字索引一起使用，例如 {ITEM.STATE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/1390a319-1ae67b2a})
[comment]: # ({b380e0a3-e6f613bf})
##### {ITEM.STATE.ERROR} {#itemstateerror}
监控项变为不支持时，说明其原因的详细错误消息。
如果监控项进入不支持状态后又立即恢复为支持状态，则错误字段可能为空。
[comment]: # ({/b380e0a3-e6f613bf})
[comment]: # ({10a105c2-c96d8adc})
##### {ITEM.VALUE} {#itemvalue}
解析结果为以下两者之一：
- 如果在触发器状态变更的上下文中使用，例如显示事件或发送通知时，则解析为触发器表达式中第 N 个监控项的历史值（事件发生时的值）；
- 如果在没有触发器状态变更上下文的情况下使用，例如在弹出选择窗口中显示触发器列表时，则解析为触发器表达式中第 N 个监控项的最新值。在这种情况下，其作用与 {ITEM.LASTVALUE} 相同。
在第一种情况下，如果历史值已被删除或从未存储过，则会解析为 \*UNKNOWN\*。
在第二种情况下，且仅在前端中，如果最新历史值是在 *Max history display period* 之前采集的，则会解析为 \*UNKNOWN\*（在 [Administration→General](/manual/web_interface/frontend_sections/administration/general#gui) 菜单部分中设置）。
对于 text/log 监控项，前端会在以下位置将解析后的值截断为 20 个字符：
- 运行数据；
- 触发器描述；
- 触发器 URL；
- 触发器 URL 标签；
- 监控项值小组件的描述。
如需解析为完整值，可使用 [宏函数](/manual/config/macros/macro_functions)，因为服务器不会截断任何值。例如：`{{ITEM.VALUE}.regsub("(.*)", \1)}`。
此宏可与数字索引一起使用，例如 {ITEM.VALUE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。另请参见 [索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/10a105c2-c96d8adc})
[comment]: # ({2771daa0-0de09cd4})
##### {ITEM.VALUE.AGE} {#itemvalueage}
监控项值采集与宏求值之间经过的时间。
以人类可读的格式显示（例如 1m 45s）。
此宏可与数字索引一起使用，例如 {ITEM.VALUE.AGE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/2771daa0-0de09cd4})
[comment]: # ({bd8b4d8c-66ca256e})
##### {ITEM.VALUE.DATE} {#itemvaluedate}
监控项值被采集时的日期。
以 `YYYYMMDD` 格式显示。
在触发器名称（位于“监测 -> 故障”列表中）、事件名称以及标签名称和值中，使用服务器时区。在所有其他情况下，使用用户时区。
此宏可与数字索引一起使用，例如 {ITEM.VALUE.DATE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/bd8b4d8c-66ca256e})
[comment]: # ({5d532f5f-70b8ece6})
##### {ITEM.VALUE.TIME} {#itemvaluetime}
收集监控项值时的时间。
以 `HHMMSS` 格式显示。
在触发器名称（位于“监控”->“故障”列表中）、事件名称以及标签名称和值中，使用服务器时区。在所有其他情况下，使用用户时区。
此宏可与数字索引一起使用，例如 {ITEM.VALUE.TIME[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/5d532f5f-70b8ece6})
[comment]: # ({23f5f384-67f021be})
##### {ITEM.VALUE.TIMESTAMP} {#itemvaluetimestamp}
监控项值被采集时的 UNIX 时间戳。
此宏可与数字索引一起使用，例如 {ITEM.VALUE.TIMESTAMP[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/23f5f384-67f021be})
[comment]: # ({32f76dc0-1c238a4e})
##### {ITEM.VALUETYPE} {#itemvaluetype}
导致通知的触发器表达式中第 N 个监控项的值类型。
可能的值：*0* - 数值浮点型，*1* - 字符，*2* - 日志，*3* - 数值无符号型，*4* - 文本。
此宏可与数字索引一起使用，例如 {ITEM.VALUETYPE[<1-9>](supported_by_location#indexed-macros)}，用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/32f76dc0-1c238a4e})
[comment]: # ({1b8b61dd-ca1e2958})
#### 低级发现通知宏
[comment]: # ({/1b8b61dd-ca1e2958})
[comment]: # ({8f30ac9c-18daf859})
##### {LLDRULE.DESCRIPTION} {#lldruledescription}
导致通知的低级别发现规则的描述。
[comment]: # ({/8f30ac9c-18daf859})
[comment]: # ({d21bcb7a-eb20da58})
##### {LLDRULE.DESCRIPTION.ORIG} {#lldruledescriptionorig}
导致通知的低级别发现规则的原始描述（其中的宏未解析）。
[comment]: # ({/d21bcb7a-eb20da58})
[comment]: # ({2a546f6f-0b805ee5})
##### {LLDRULE.ID} {#lldruleid}
导致通知的低级别发现规则的数字 ID。
[comment]: # ({/2a546f6f-0b805ee5})
[comment]: # ({8600dda2-7d14b1ec})
##### {LLDRULE.KEY} {#lldrulekey}
导致通知的低级别发现规则的键值。
[comment]: # ({/8600dda2-7d14b1ec})
[comment]: # ({de311558-6d7f57df})
##### {LLDRULE.KEY.ORIG} {#lldrulekeyorig}
导致通知的低级别发现规则的原始键值（宏未解析）。
[comment]: # ({/de311558-6d7f57df})
[comment]: # ({ca23deb9-9c4e2439})
##### {LLDRULE.NAME} {#lldrulename}
导致通知的低级别发现规则的名称。
[comment]: # ({/ca23deb9-9c4e2439})
[comment]: # ({432bf8a8-25113c9f})
##### {LLDRULE.NAME.ORIG} {#lldrulenameorig}
导致通知的低级别发现规则的原始名称（宏未解析）。
[comment]: # ({/432bf8a8-25113c9f})
[comment]: # ({fe41fd7a-bbe71021})
##### {LLDRULE.STATE} {#lldrulestate}
低级发现规则的最新状态。
可能的值：*不支持*、*正常*。
此宏可与数字索引一起使用，例如 {LLDRULE.STATE[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[索引宏](supported_by_location#indexed-macros)。
[comment]: # ({/fe41fd7a-bbe71021})
[comment]: # ({9b25103b-40c7fb67})
##### {LLDRULE.STATE.ERROR} {#lldrulestateerror}
包含低级发现规则变为不支持原因详细信息的错误消息。
如果低级发现规则进入不支持状态后又立即恢复为受支持状态，则错误字段可能为空。
[comment]: # ({/9b25103b-40c7fb67})
[comment]: # ({d6ab0bfb-4ec8e17e})
#### 地图宏
[comment]: # ({/d6ab0bfb-4ec8e17e})
[comment]: # ({f347b12d-b04b977e})
##### {MAP.ID} {#mapid}
网络拓扑图 ID。
[comment]: # ({/f347b12d-b04b977e})
[comment]: # ({790b44ae-b7fca0a1})
##### {MAP.NAME} {#mapname}
网络地图名称。
[comment]: # ({/790b44ae-b7fca0a1})
[comment]: # ({caa2905d-c26fcd33})
#### Proxy 宏
[comment]: # ({/caa2905d-c26fcd33})
[comment]: # ({259c2d9e-f5198060})
##### {PROXY.DESCRIPTION} {#proxydescription}
proxy 描述。
解析结果可以是以下之一：
- 触发器表达式中第 N 个监控项所属的 proxy（在基于触发器的通知中）。此处可使用[带索引](/manual/appendix/macros/supported_by_location#indexed-macros)宏；
- 执行发现的 proxy（在发现通知中）。此处使用 {PROXY.DESCRIPTION}，不带索引；
- active agent 注册到的 proxy（在自动注册通知中）。此处使用 {PROXY.DESCRIPTION}，不带索引。
此宏可与数字索引一起使用，例如 {PROXY.DESCRIPTION[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/259c2d9e-f5198060})
[comment]: # ({74e31e94-aaf3f439})
##### {PROXY.NAME} {#proxyname}
proxy 名称。
可解析为以下之一：
- 触发器表达式中第 N 个监控项的 proxy（在基于触发器的通知中）。此处可使用[带索引](/manual/appendix/macros/supported_by_location#indexed-macros)宏；
- 执行发现的 proxy（在发现通知中）。此处使用 {PROXY.NAME}，不带索引；
- 活动 agent 注册到的 proxy（在自动注册通知中）。此处使用 {PROXY.NAME}，不带索引。
此宏可与数字索引一起使用，例如 {PROXY.NAME[<1-9>](supported_by_location#indexed-macros)}，以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见[带索引的宏](supported_by_location#indexed-macros)。
[comment]: # ({/74e31e94-aaf3f439})
[comment]: # ({1d5f1d2c-41f85b91})
#### 脚本宏
[comment]: # ({/1d5f1d2c-41f85b91})
[comment]: # ({4ea3591a-c2b72f3c})
##### {MANUALINPUT} {#manualinput}
用户在执行脚本时指定的手动输入值。
[comment]: # ({/4ea3591a-c2b72f3c})
[comment]: # ({b5f51cb0-822f5155})
#### 服务宏
[comment]: # ({/b5f51cb0-822f5155})
[comment]: # ({90d543d7-6f77469a})
##### {SERVICE.DESCRIPTION} {#servicedescription}
已解析宏的服务描述。
[comment]: # ({/90d543d7-6f77469a})
[comment]: # ({923179fe-651e505d})
##### {SERVICE.ID} {#serviceid}
触发操作的服务的数字 ID。
[comment]: # ({/923179fe-651e505d})
[comment]: # ({80bdb5de-5e2d5b60})
##### {SERVICE.NAME} {#servicename}
解析宏后的服务名称。
[comment]: # ({/80bdb5de-5e2d5b60})
[comment]: # ({4ba1f973-a3d2a319})
##### {SERVICE.ROOTCAUSE} {#servicerootcause}
导致服务失败的触发器问题事件列表，按严重性和主机名称排序。
包括以下详细信息：主机名称、事件名称、严重性、持续时间、服务标签和值。
[comment]: # ({/4ba1f973-a3d2a319})
[comment]: # ({d7aca14b-364bb68d})
##### {SERVICE.TAGS} {#servicetags}
服务事件标签的逗号分隔列表。
服务事件标签可在服务配置的标签部分中定义。如果不存在标签，则展开为空字符串。
[comment]: # ({/d7aca14b-364bb68d})
[comment]: # ({f11c2066-cca07c99})
##### {SERVICE.TAGSJSON} {#servicetagsjson}
包含服务事件标签对象的 JSON 数组。
服务事件标签可在服务配置的标签部分中定义。如果不存在标签，则展开为空数组。
[comment]: # ({/f11c2066-cca07c99})
[comment]: # ({4a35bcdb-abc70892})
##### {SERVICE.TAGS.\} {#servicetagstagname}
由标签名称引用的服务事件标签值。
服务事件标签可在服务配置的标签部分中定义。
包含非字母数字字符的标签名称（包括非英语多字节 UTF 字符）必须用双引号括起来。带引号的标签名称中的引号和反斜杠必须使用反斜杠进行转义。
[comment]: # ({/4a35bcdb-abc70892})
[comment]: # ({83520c91-67d8c155})
#### 触发器宏
[comment]: # ({/83520c91-67d8c155})
[comment]: # ({e842a029-37ecf66b})
##### {TRIGGER.DESCRIPTION} {#trigdescription}
触发器描述。
如果在通知文本中使用 `{TRIGGER.DESCRIPTION}`，则会展开触发器描述中支持的所有宏。
[comment]: # ({/e842a029-37ecf66b})
[comment]: # ({95c25397-b426d48d})
##### {TRIGGER.EVENTS.ACK} {#trigeventsack}
在拓扑图中，表示拓扑图元素的已确认事件数量；在通知中，表示生成当前事件的触发器的已确认事件数量。
[comment]: # ({/95c25397-b426d48d})
[comment]: # ({75884c9c-245ec1dc})
##### {TRIGGER.EVENTS.PROBLEM.ACK} {#trigeventsproblemack}
所有触发器中已确认的问题事件数量，不考虑其状态。
[comment]: # ({/75884c9c-245ec1dc})
[comment]: # ({188379f7-120862b1})
##### {TRIGGER.EVENTS.PROBLEM.UNACK} {#trigeventsproblemunack}
所有触发器中未确认的问题事件数量，不考虑其状态。
[comment]: # ({/188379f7-120862b1})
[comment]: # ({64676a94-a19efa06})
##### {TRIGGER.EVENTS.UNACK} {#trigeventsunack}
地图中某个地图元素的未确认事件数量，或通知中生成当前事件的触发器的未确认事件数量。
[comment]: # ({/64676a94-a19efa06})
[comment]: # ({51b081b4-24fd6d20})
##### {TRIGGER.EXPRESSION} {#trigexpression}
触发器表达式。
[comment]: # ({/51b081b4-24fd6d20})
[comment]: # ({08c23e90-307f6ea3})
##### {TRIGGER.EXPRESSION.EXPLAIN} {#trigexplain}
部分求值后的触发器表达式。
基于监控项的函数会在事件生成时进行求值，并以结果替换，而所有其他函数则按表达式中的原样显示。可用于调试触发器表达式。
[comment]: # ({/08c23e90-307f6ea3})
[comment]: # ({c3eac97a-e13a9db8})
##### {TRIGGER.EXPRESSION.RECOVERY} {#trigexpressionrecovery}
如果 [触发器配置](/manual/config/triggers/trigger) 中的 *OK event generation* 设置为“Recovery expression”，则返回触发器恢复表达式；否则返回空字符串。
[comment]: # ({/c3eac97a-e13a9db8})
[comment]: # ({8c3a0afa-d5b07f3a})
##### {TRIGGER.EXPRESSION.RECOVERY.EXPLAIN} {#trigrecoveryexplain}
部分求值的触发器恢复表达式。
基于监控项的函数会在事件生成时进行求值，并替换为求值结果，而所有其他函数则按表达式中的原样显示。可用于调试触发器恢复表达式。
[comment]: # ({/8c3a0afa-d5b07f3a})
[comment]: # ({f4267aa7-f562335b})
##### {TRIGGER.HOSTGROUP.NAME} {#trighostgroupname}
定义该触发器的主机组列表，按 SQL 查询排序，并以逗号加空格分隔。
[comment]: # ({/f4267aa7-f562335b})
[comment]: # ({808ec5e7-489c177c})
##### {TRIGGER.ID} {#trigid}
触发此操作的数字触发器 ID。
[comment]: # ({/808ec5e7-489c177c})
[comment]: # ({d928255d-a95809c9})
##### {TRIGGER.NAME} {#trigname}
已解析宏的触发器名称。
请注意，可在动作中使用 `{EVENT.NAME}` 来显示已解析宏的已触发事件/问题名称。
[comment]: # ({/d928255d-a95809c9})
[comment]: # ({fb2eada0-84346f78})
##### {TRIGGER.NAME.ORIG} {#trignameorig}
原始触发器名称（宏未解析）。
[comment]: # ({/fb2eada0-84346f78})
[comment]: # ({df187e43-1c40a5d8})
##### {TRIGGER.NSEVERITY} {#trignseverity}
触发器严重性的数值。
可能的值：*0* - 未分类，*1* - 信息，*2* - 警告，*3* - 一般严重，*4* - 高，*5* - 灾难。
[comment]: # ({/df187e43-1c40a5d8})
[comment]: # ({47a60772-000fbad4})
##### {TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK} {#trigproblemeventsproblemack}
处于问题状态的触发器中，已确认的问题事件数量。
[comment]: # ({/47a60772-000fbad4})
[comment]: # ({5df88100-3315f9e3})
##### {TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK} {#trigproblemeventsproblemunack}
处于问题状态的触发器中未确认的问题事件数量。
[comment]: # ({/5df88100-3315f9e3})
[comment]: # ({e8de5363-2b01eb08})
##### {TRIGGER.SEVERITY} {#trigseverity}
触发器严重性名称。
可在 *Administration > General > Trigger displaying options* 中定义。
[comment]: # ({/e8de5363-2b01eb08})
[comment]: # ({13bd28f7-31b5cc4e})
##### {TRIGGER.STATE} {#trigstate}
触发器表达式的最新状态。
可能的值：*Unknown*、*Normal*。
[comment]: # ({/13bd28f7-31b5cc4e})
[comment]: # ({85b48e7f-871b7dbd})
##### {TRIGGER.STATE.ERROR} {#trigstateerror}
触发器变为不支持时，说明其原因的详细错误消息。
如果触发器进入不支持状态后又立即恢复为支持状态，则错误字段可能为空。
[comment]: # ({/85b48e7f-871b7dbd})
[comment]: # ({26e1992c-5efd9947})
##### {TRIGGER.STATUS} {#trigstatus}
执行操作步骤时的触发器值。
可能的值：*Problem*、*OK*。
[comment]: # ({/26e1992c-5efd9947})
[comment]: # ({8a6a47db-357fabe7})
##### {TRIGGER.TEMPLATE.NAME} {#trigtemplname}
按 SQL 查询排序、以逗号加空格分隔的模板列表，其中定义了该触发器；如果该触发器是在主机中定义的，则为 \*UNKNOWN\*。
[comment]: # ({/8a6a47db-357fabe7})
[comment]: # ({be0fc30a-4b07c132})
##### {TRIGGER.URL} {#trigurl}
触发器 URL。
[comment]: # ({/be0fc30a-4b07c132})
[comment]: # ({d83ab68d-ceb490ed})
##### {TRIGGER.URL.NAME} {#trigurlname}
触发器 URL 的标签。
[comment]: # ({/d83ab68d-ceb490ed})
[comment]: # ({f45bc579-be6cca1f})
##### {TRIGGER.VALUE} {#trigvalue}
当前的触发器数值。
可能的值：*0* - 触发器处于正常状态，*1* - 触发器处于问题状态。
[comment]: # ({/f45bc579-be6cca1f})
[comment]: # ({af933b66-1cee3a3f})
##### {TRIGGERS.ACK} {#triggersack}
地图元素的已确认触发器数量，忽略触发器状态。
如果某个触发器的所有问题事件都已确认，则该触发器被视为已确认。
[comment]: # ({/af933b66-1cee3a3f})
[comment]: # ({4dccc40f-a9c0072a})
##### {TRIGGERS.PROBLEM.ACK} {#triggersproblemack}
地图元素中已确认的问题触发器数量。
如果某个触发器的所有问题事件都已确认，则该触发器被视为已确认。
[comment]: # ({/4dccc40f-a9c0072a})
[comment]: # ({4043ae9b-4d417937})
##### {TRIGGERS.PROBLEM.UNACK} {#triggersproblemunack}
地图元素中未确认问题触发器的数量。
如果某个触发器至少有一个问题事件未被确认，则该触发器被视为未确认。
[comment]: # ({/4043ae9b-4d417937})
[comment]: # ({bdf558c7-80d88827})
##### {TRIGGERS.UNACK} {#triggersunack}
地图元素中未确认触发器的数量，忽略触发器状态。
如果某个触发器至少有一个问题事件未被确认，则该触发器被视为未确认。
[comment]: # ({/bdf558c7-80d88827})
[comment]: # ({fbb21fdb-3a02d22b})
#### 用户名宏
[comment]: # ({/fbb21fdb-3a02d22b})
[comment]: # ({15b2e62f-b8ae10fe})
##### {USER.FULLNAME} {#userfullname}
添加了事件确认或启动了脚本的用户的姓名、姓氏和用户名。
[comment]: # ({/15b2e62f-b8ae10fe})
[comment]: # ({27aef286-e4275f44})
##### {USER.NAME} {#username}
启动脚本的用户名称。
[comment]: # ({/27aef286-e4275f44})
[comment]: # ({45c2feb5-72ed76f3})
##### {USER.SURNAME} {#usersurname}
启动该脚本的用户的姓氏。
[comment]: # ({/45c2feb5-72ed76f3})
[comment]: # ({6e0279e7-77a14de3})
##### {USER.USERNAME}
启动该脚本的用户的用户名。
[comment]: # ({/6e0279e7-77a14de3})
[comment]: # ({36a85b5c-3a90dc8f})
#### 索引宏
索引宏语法 **{MACRO<1-9>}** 只能引用触发器 *Expression* 字段中的第 N 个监控项、函数或主机：
- **{HOST.IP1}, {HOST.IP2}, {HOST.IP3}** 解析为触发器表达式中第一个、第二个和第三个主机的 IP 地址（如果存在）。
- **{ITEM.VALUE1}, {ITEM.VALUE2}, {ITEM.VALUE3}** 解析为事件发生时触发器表达式中第一个、第二个和第三个监控项的值（如果存在）。
- **{FUNCTION.VALUE1}, {FUNCTION.VALUE2}, {FUNCTION.VALUE3}** 解析为事件发生时第一个、第二个和第三个基于监控项的函数的值（如果存在）。
在触发器上下文中，索引宏始终引用触发器配置中的 *Expression* 字段，而不是 *Recovery expression*。例如，在恢复事件中，**{ITEM.VALUE2}** 将解析为恢复时问题表达式中第二个监控项的值。
**{HOST.HOST<1-9>}** 宏也支持在**图形名称**中的 `{?func(/host/key,param)}` 表达式宏内使用。
例如，图形名称中的 `{?func(/{HOST.HOST2}/key,param)}` 将解析为图形中第二个监控项所属的主机。
::: notewarning
除这里提到的情况外，索引宏在任何其他上下文中都不会解析。
对于其他上下文，请使用不带索引的宏（**{HOST.HOST}, {HOST.IP}** 等）。
:::
[comment]: # ({/36a85b5c-3a90dc8f})