1 按位置支持的宏
概述
按位置支持的宏表包含在特定位置中受支持的所有宏(内置、表达式和用户可定义)的参考信息。
如果某个相关组中的所有宏都受支持,则只给出组名。单击每个宏名称或组名可查看这些宏的完整详细信息。
宏详细信息列表包含所有内置宏的详细列表,并按应用区域分组。请注意,要自定义宏值(例如,缩短或提取特定子字符串),可以使用宏函数。
按位置支持的宏
宏详细信息
此列表包含按应用领域分组的每个内置宏的详细信息:
动作宏
{ACTION.ID}
已触发动作的数字 ID。
{ACTION.NAME}
已触发动作的名称。
告警宏
{ALERT.MESSAGE}
操作配置中的默认消息值。
{ALERT.SENDTO}
用户介质配置中的 Send to 值。
{ALERT.SUBJECT}
操作配置中的默认主题值。
日期和时间宏
{DATE}
当前日期,格式为 yyyy.mm.dd。
{TIME}
当前时间,格式为 hh:mm:ss。
{TIMESTAMP}
当前时间的 UNIX 时间戳格式。
发现宏
{DISCOVERY.DEVICE.IPADDRESS}
已发现设备的 IP 地址。
始终可用,不依赖于是否已添加主机。
{DISCOVERY.DEVICE.DNS}
已发现设备的 DNS 名称。
始终可用,不依赖于是否已添加主机。
{DISCOVERY.DEVICE.STATUS}
已发现设备的状态(UP/DOWN)。
{DISCOVERY.DEVICE.UPTIME}
特定设备自上次发现状态变更以来的时间。
例如:1h 29m 01s。
对于状态为 DOWN 的设备,这是其宕机持续时间。
{DISCOVERY.RULE.NAME}
发现设备/服务存在或不存在的发现规则名称。
{DISCOVERY.SERVICE.NAME}
已发现服务的名称。
例如:HTTP。
{DISCOVERY.SERVICE.PORT}
已发现服务的端口。
例如:80。
{DISCOVERY.SERVICE.STATUS}
已发现服务的状态(UP/DOWN)。
{DISCOVERY.SERVICE.UPTIME}
特定服务自上次发现状态变更以来的时间。
例如:1h 29m 01s。
对于状态为 DOWN 的服务,这是其停机时长。
升级宏
{ESC.HISTORY}
先前已发送通知的日志,包括其升级步骤和状态(已发送、进行中 或 失败)。
事件宏
{EVENT.ACK.STATUS}
事件的确认状态(是/否)。
{EVENT.AGE}
触发操作的事件的持续时间,精确到秒。
在升级消息中很有用。
例如:9m 13s。
{EVENT.DATE}
触发动作的事件日期,格式为 yyyy.mm.dd。
例如:2025.04.14。
{EVENT.DURATION}
事件的持续时间(问题事件与恢复事件之间的时间差),精确到秒。
适用于问题恢复消息。
{EVENT.ID}
触发动作的事件的数字 ID。
{EVENT.NAME}
触发操作的事件名称。
{EVENT.NSEVERITY}
事件严重性的数值。
可能的值:0 - 未分类,1 - 信息,2 - 警告,3 - 一般严重,4 - 高严重,5 - 灾难。
{EVENT.OBJECT}
事件对象的数值。
可能的值:0 - 触发器,1 - 已发现主机,2 - 已发现服务,3 - 自动注册,4 - 监控项,5 - 低级别发现规则。
{EVENT.OPDATA}
问题对应的底层触发器的运行数据。
{EVENT.SEVERITY}
事件严重性的名称。
{EVENT.SOURCE}
事件来源的数值。
可能的值:0 - 触发器,1 - 发现,2 - 自动注册,3 - 内部,4 - 服务。
{EVENT.STATUS}
触发动作的事件的文字状态。
{EVENT.TAGS}
事件标签的逗号分隔列表。
如果不存在标签,则展开为空字符串。
{EVENT.TAGSJSON}
包含事件标签对象的 JSON 数组。
如果不存在标签,则展开为空数组。
{EVENT.TAGS.<tag name>}
由标签名称引用的事件标签值。
包含非字母数字字符的标签名称(包括非英语多字节 UTF 字符)必须用双引号括起来。带引号的标签名称中的引号和反斜杠必须使用反斜杠进行转义。
{EVENT.TIME}
触发动作的事件时间,格式为 hh:mm:ss。
例如:12:57:53。
{EVENT.TIMESTAMP}
触发动作的事件的 UNIX 时间戳。
{EVENT.VALUE}
触发动作的事件的数值。
可能的值:1 - 故障,0 - 恢复中。
原因/症状事件宏
{EVENT.CAUSE.ACK.STATUS}
原因事件的确认状态(是/否)。
在症状事件的上下文中使用。
{EVENT.CAUSE.AGE}
原因事件的持续时间,精确到秒。
在升级消息中很有用。
用于症状事件的上下文中。
{EVENT.CAUSE.DATE}
原因事件的日期,格式为 yyyy.mm.dd。
用于症状事件的上下文中。
{EVENT.CAUSE.DURATION}
原因事件的持续时间(问题事件与恢复事件之间的时间差),精确到秒。
在问题恢复消息中很有用。
用于症状事件的上下文中。
{EVENT.CAUSE.ID}
原因事件的数字 ID。
在症状事件的上下文中使用。
{EVENT.CAUSE.NAME}
原因事件的名称。
在症状事件的上下文中使用。
{EVENT.CAUSE.NSEVERITY}
原因事件严重性的数值。
可能的值:0 - 未分类,1 - 信息,2 - 警告,3 - 一般严重,4 - 高,5 - 灾难。
用于症状事件的上下文中。
{EVENT.CAUSE.OBJECT}
原因事件对象的数值。
可能的值:0 - 触发器,1 - 已发现主机,2 - 已发现服务,3 - 自动注册,4 - 监控项,5 - 低级别发现规则。
用于症状事件的上下文中。
{EVENT.CAUSE.OPDATA}
原因问题的底层触发器的运行数据。
用于症状事件的上下文中。
{EVENT.CAUSE.SEVERITY}
原因事件严重性的名称。
可能的值:未分类、信息、警告、一般严重、高严重、灾难。
用于症状事件的上下文中。
{EVENT.CAUSE.SOURCE}
原因事件来源的数值。
可能的值:0 - 触发器,1 - 发现,2 - 自动注册,3 - 内部。
用于症状事件的上下文中。
{EVENT.CAUSE.STATUS}
原因事件的文字值。
用于症状事件的上下文中。
{EVENT.CAUSE.TAGS}
原因事件标签的逗号分隔列表。
如果不存在标签,则展开为空字符串。
用于症状事件的上下文中。
{EVENT.CAUSE.TAGSJSON}
一个 JSON 数组,包含原因事件标签对象。
如果不存在标签,则展开为空数组。
用于症状事件的上下文中。
{EVENT.CAUSE.TAGS.<tag name>}
由标签名称引用的原因事件标签值。
包含非字母数字字符的标签名称(包括非英语多字节 UTF 字符)必须用双引号括起来。带引号的标签名称中的引号和反斜杠必须使用反斜杠进行转义。
用于症状事件的上下文中。
{EVENT.CAUSE.TIME}
原因事件的时间,格式为 hh:mm:ss。
用于症状事件的上下文中。
{EVENT.CAUSE.TIMESTAMP}
原因事件的 UNIX 时间戳。
在症状事件的上下文中使用。
{EVENT.CAUSE.UPDATE.HISTORY}
原因问题更新日志(确认等)。
用于症状事件的上下文中。
{EVENT.CAUSE.VALUE}
原因事件的数值。
可能的值:1 - 问题,0 - 恢复中。
在症状事件的上下文中使用。
{EVENT.SYMPTOMS}
症状事件列表。包括以下详细信息:主机名称、事件名称、严重性、持续时间、服务标签和值。
此宏用于原因事件的上下文中,并返回有关症状事件的信息。
恢复事件宏
{EVENT.RECOVERY.DATE}
恢复事件的日期,格式为 yyyy.mm.dd。
{EVENT.RECOVERY.ID}
恢复事件的数字 ID。
{EVENT.RECOVERY.NAME}
恢复事件的名称。
{EVENT.RECOVERY.STATUS}
恢复事件的文字值。
{EVENT.RECOVERY.TAGS}
恢复事件标签的逗号分隔列表。如果不存在标签,则扩展为空字符串。
{EVENT.RECOVERY.TAGSJSON}
包含恢复事件标签对象的 JSON 数组。如果不存在标签,则展开为空数组。
{EVENT.RECOVERY.TIME}
恢复事件的时间,格式为 hh:mm:ss。
{EVENT.RECOVERY.TIMESTAMP}
恢复事件的 UNIX 时间戳。
{EVENT.RECOVERY.VALUE}
恢复事件的数值。
事件更新宏
{EVENT.UPDATE.ACTION}
在问题更新期间执行的操作的人类可读名称。
解析为以下值:已确认、未确认、已评论、严重性已从(原始严重性)更改为(更新后的严重性) 和 已关闭(取决于一次更新中执行了多少个操作)。
{EVENT.UPDATE.ACTIONJSON}
一个 JSON 数组,包含在问题更新期间执行的操作详情。
可能的 JSON 属性值:
- true(用于 acknowledge、unacknowledge、close、unsuppress、cause 和 symptom 属性);
- <message string>(用于 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}。
{EVENT.UPDATE.DATE}
事件更新(确认等)的日期,格式为 yyyy.mm.dd。
{EVENT.UPDATE.HISTORY}
问题更新(确认等)的日志。
{EVENT.UPDATE.MESSAGE}
问题更新消息。
{EVENT.UPDATE.NSEVERITY}
问题更新操作期间设置的新事件严重性的数值。
{EVENT.UPDATE.SEVERITY}
在问题更新操作期间设置的新事件严重性的名称。
{EVENT.UPDATE.STATUS}
问题更新状态的数值。
可能的值:0 - 因问题/恢复事件而调用 webhook,1 - 更新操作。
{EVENT.UPDATE.TIME}
事件更新(确认等)的时间,格式为 hh:mm:ss。
{EVENT.UPDATE.TIMESTAMP}
事件更新(确认等)的 UNIX 时间戳。
函数宏
{FUNCTION.VALUE}
事件发生时,触发器表达式中第 N 个基于监控项的函数的值。
仅统计将 /host/key 作为第一个参数的函数。
此宏可与数字索引一起使用,例如 {FUNCTION.VALUE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等函数。请参见 索引宏。
{FUNCTION.RECOVERY.VALUE}
事件发生时恢复表达式中第 N 个基于监控项的函数的值。*
仅统计将 /host/key 作为第一个参数的函数。
此宏可与数字索引一起使用,例如 {FUNCTION.RECOVERY.VALUE<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等函数。请参见索引宏。
主机宏
{HOST.CONN}
主机 IP 地址或 DNS 名称,具体取决于主机设置。
在全局脚本中、接口 IP/DNS 字段中以及 Web 场景中,该宏将解析为主 agent 接口。如果未定义 agent 接口,则将使用主 SNMP 接口。如果也未定义 SNMP 接口,则将使用主 JMX 接口。如果也未定义 JMX 接口,则将使用主 IPMI 接口。如果主机没有任何接口,则该宏将解析为“UNKNOWN”。
此宏可与数字索引一起使用,如 {HOST.CONN<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{HOST.DESCRIPTION}
主机描述。
此宏可与数字索引一起使用,如 {HOST.DESCRIPTION<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见 索引宏。
{HOST.DNS}
主机 DNS 名称。
在全局脚本中、接口 IP/DNS 字段中以及 Web 场景中,该宏将解析为主 agent 接口。如果未定义 agent 接口,则将使用主 SNMP 接口。如果也未定义 SNMP 接口,则将使用主 JMX 接口。如果也未定义 JMX 接口,则将使用主 IPMI 接口。如果主机没有任何接口,则该宏将解析为“UNKNOWN”。
该宏可与数字索引一起使用,例如 {HOST.DNS<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{HOST.HOST}
技术主机名称。
如果此宏在历史函数的第一个参数中用作占位符,则不支持对此宏使用宏函数,例如 last(/{HOST.HOST}/{ITEM.KEY})。
此宏可与数字索引一起使用,如 {HOST.HOST<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{HOST.ID}
主机 ID。
此宏可与数字索引一起使用,如 {HOST.ID<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{HOST.IP}
主机 IP 地址。
在全局脚本中、接口 IP/DNS 字段以及 Web 场景中,该宏将解析为主 agent 接口。如果未定义 agent 接口,则将使用主 SNMP 接口。如果也未定义 SNMP 接口,则将使用主 JMX 接口。如果也未定义 JMX 接口,则将使用主 IPMI 接口。如果主机没有任何接口,则该宏将解析为“UNKNOWN”。
该宏可与数字索引一起使用,如 {HOST.IP<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{HOST.METADATA}
主机元数据。
仅用于活动 agent 自动注册。
{HOST.NAME}
可见的主机名称。
此宏可使用数字索引,例如 {HOST.NAME<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{HOST.PORT}
主机的(agent)端口。
在全局脚本、接口 IP/DNS 字段和 web 场景中,该宏将解析为主 agent 接口。如果未定义 agent 接口,则将使用主 SNMP 接口。如果也未定义 SNMP 接口,则将使用主 JMX 接口。如果也未定义 JMX 接口,则将使用主 IPMI 接口。如果主机没有任何接口,则该宏将解析为“UNKNOWN”。
该宏可与数字索引一起使用,如 {HOST.PORT<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
目标主机宏
{HOST.TARGET.CONN}
目标主机的 IP 地址或 DNS 名称。
{HOST.TARGET.DNS}
目标主机的 DNS 名称。
{HOST.TARGET.HOST}
目标主机的技术名称。
{HOST.TARGET.IP}
目标主机的 IP 地址。
{HOST.TARGET.NAME}
目标主机的可见名称。
主机组宏
{HOSTGROUP.ID}
主机组 ID。
主机资产记录宏
{INVENTORY.ALIAS}
主机清单中的 Alias 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.ALIAS<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.ASSET.TAG}
主机清单中的 资产标签 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.ASSET.TAG<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.CHASSIS}
主机资产记录中的 机箱 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.CHASSIS<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.CONTACT}
主机清单中的 Contact 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.CONTACT<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.CONTRACT.NUMBER}
主机清单中的合同编号字段。
此宏可与数字索引一起使用,例如 {INVENTORY.CONTRACT.NUMBER<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.DEPLOYMENT.STATUS}
主机清单中的部署状态字段。
此宏可与数字索引一起使用,例如 {INVENTORY.DEPLOYMENT.STATUS<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.HARDWARE}
主机清单中的 Hardware 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HARDWARE<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.HARDWARE.FULL}
主机清单中的 硬件(完整详细信息) 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HARDWARE.FULL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.HOST.NETMASK}
主机清单中的主机子网掩码字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HOST.NETMASK<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.HOST.NETWORKS}
主机清单中的主机网络字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HOST.NETWORKS<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.HOST.ROUTER}
主机清单中的 主机路由器 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HOST.ROUTER<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 带索引的宏。
{INVENTORY.HW.ARCH}
主机资产清单中的硬件架构字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HW.ARCH<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.HW.DATE.DECOMM}
主机清单中的硬件退役日期字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HW.DATE.DECOMM<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.HW.DATE.EXPIRY}
主机资产清单中的硬件维护到期日期字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HW.DATE.EXPIRY<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.HW.DATE.INSTALL}
主机资产清单中的硬件安装日期字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HW.DATE.INSTALL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.HW.DATE.PURCHASE}
主机资产清单中的硬件购买日期字段。
此宏可与数字索引一起使用,例如 {INVENTORY.HW.DATE.PURCHASE<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.INSTALLER.NAME}
主机清单中的 安装程序名称 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.INSTALLER.NAME<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.LOCATION}
主机资产记录中的 位置 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.LOCATION<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.LOCATION.LAT}
主机资产记录中的 位置纬度 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.LOCATION.LAT<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.LOCATION.LON}
主机清单中的 位置经度 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.LOCATION.LON<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.MACADDRESS.A}
主机清单中的 MAC address A 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.MACADDRESS.A<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见带索引的宏。
{INVENTORY.MACADDRESS.B}
主机资产清单中的 MAC address B 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.MACADDRESS.B<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见带索引的宏。
{INVENTORY.MODEL}
主机资产清单中的 Model 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.MODEL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.NAME}
主机清单中的 Name 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.NAME<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 indexed macros。
{INVENTORY.NOTES}
主机清单中的 备注 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.NOTES<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.OOB.IP}
主机资产清单中的 OOB IP 地址 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.OOB.IP<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.OOB.NETMASK}
主机资产清单中的 OOB 子网掩码 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.OOB.NETMASK<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.OOB.ROUTER}
主机清单中的 OOB 路由器 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.OOB.ROUTER<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.OS}
主机清单中的 OS 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.OS<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.OS.FULL}
主机清单中的 OS(完整详细信息) 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.OS.FULL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.OS.SHORT}
主机清单中的 OS(短) 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.OS.SHORT<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.PRIMARY.CELL}
主机清单中的 主要联系人手机 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.PRIMARY.CELL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.POC.PRIMARY.EMAIL}
主机资产清单中的 主要联系人电子邮件 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.PRIMARY.EMAIL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.PRIMARY.NAME}
主机资产清单中的主要联系人姓名字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.PRIMARY.NAME<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.PRIMARY.NOTES}
主机资产清单中的主要联系人备注字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.PRIMARY.NOTES<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.PRIMARY.PHONE.A}
主机清单中的 主要 POC 电话 A 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.PRIMARY.PHONE.A<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.POC.PRIMARY.PHONE.B}
主机清单中的 主要联系人电话 B 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.PRIMARY.PHONE.B<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.PRIMARY.SCREEN}
主机清单中的 主要 POC 屏幕名称 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.PRIMARY.SCREEN<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.POC.SECONDARY.CELL}
主机资产记录中的次要 POC 手机字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.SECONDARY.CELL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.SECONDARY.EMAIL}
主机清单中的次要 POC 电子邮件字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.SECONDARY.EMAIL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.SECONDARY.NAME}
主机资产清单中的次要 POC 名称字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.SECONDARY.NAME<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.SECONDARY.NOTES}
主机清单中的 Secondary POC notes 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.SECONDARY.NOTES<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.POC.SECONDARY.PHONE.A}
主机资产清单中的 Secondary POC phone A 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.SECONDARY.PHONE.A<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.POC.SECONDARY.PHONE.B}
主机资产清单中的 Secondary POC phone B 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.SECONDARY.PHONE.B<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.POC.SECONDARY.SCREEN}
主机清单中的 Secondary POC screen name 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.POC.SECONDARY.SCREEN<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 indexed macros。
{INVENTORY.SERIALNO.A}
主机资产清单中的 序列号 A 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SERIALNO.A<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.SERIALNO.B}
主机清单中的 序列号 B 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SERIALNO.B<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SITE.ADDRESS.A}
主机资产记录中的 Site address A 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.ADDRESS.A<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.SITE.ADDRESS.B}
主机资产记录中的 站点地址 B 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.ADDRESS.B<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SITE.ADDRESS.C}
主机资产记录中的 站点地址 C 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.ADDRESS.C<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.SITE.CITY}
主机清单中的 站点城市 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.CITY<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SITE.COUNTRY}
主机资产记录中的 站点国家 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.COUNTRY<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SITE.NOTES}
主机资产记录中的 站点备注 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.NOTES<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SITE.RACK}
主机清单中的 站点机架位置 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.RACK<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.SITE.STATE}
主机清单中的 站点州/省 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.STATE<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SITE.ZIP}
主机清单中的 站点 ZIP/邮政编码 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SITE.ZIP<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.SOFTWARE}
主机清单中的 Software 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SOFTWARE<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.SOFTWARE.APP.A}
主机清单中的 软件应用程序 A 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SOFTWARE.APP.A<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.SOFTWARE.APP.B}
主机清单中的 软件应用程序 B 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SOFTWARE.APP.B<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SOFTWARE.APP.C}
主机清单中的 软件应用程序 C 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SOFTWARE.APP.C<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SOFTWARE.APP.D}
主机资产清单中的 软件应用程序 D 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SOFTWARE.APP.D<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.SOFTWARE.APP.E}
主机清单中的 Software application E 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SOFTWARE.APP.E<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.SOFTWARE.FULL}
主机清单中的 软件(完整详情) 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.SOFTWARE.FULL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.TAG}
主机清单中的 Tag 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.TAG<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 带索引的宏。
{INVENTORY.TYPE}
主机资产清单中的 Type 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.TYPE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.TYPE.FULL}
主机资产记录中的 类型(完整详情) 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.TYPE.FULL<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
{INVENTORY.URL.A}
主机资产清单中的 URL A 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.URL.A<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 带索引的宏。
{INVENTORY.URL.B}
主机资产清单中的 URL B 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.URL.B<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见带索引的宏。
{INVENTORY.URL.C}
主机资产清单中的 URL C 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.URL.C<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见索引宏。
{INVENTORY.VENDOR}
主机清单中的 Vendor 字段。
此宏可与数字索引一起使用,例如 {INVENTORY.VENDOR<1-9>},以在触发器表达式中指向第一个、第二个、第三个等主机。请参见 索引宏。
监控项宏
{ITEM.DESCRIPTION}
导致通知的触发器表达式中第 N 个监控项的描述。
此宏可与数字索引一起使用,即 {ITEM.DESCRIPTION<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{ITEM.DESCRIPTION.ORIG}
导致通知的触发器表达式中第 N 个监控项的原始描述(宏未解析)。
此宏可与数字索引一起使用,如 {ITEM.DESCRIPTION.ORIG<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等主机。请参见 索引宏。
{ITEM.ID}
导致通知的触发器表达式中第 N 个监控项的数字 ID。
此宏可与数字索引一起使用,即 {ITEM.ID<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{ITEM.KEY}
导致通知的触发器表达式中第 N 个监控项的键。
如果此宏用作历史函数第一个参数中的占位符,则不支持对此宏使用宏函数,例如:last(/{HOST.HOST}/{ITEM.KEY})。
此宏可与数字索引一起使用,如 {ITEM.KEY<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{ITEM.KEY.ORIG}
导致通知的触发器表达式中第 N 个监控项的原始键值(宏未解析)。
此宏可与数字索引一起使用,形式为 {ITEM.KEY.ORIG<1-9>},以指向触发器表达式中的第一个、第二个、第三个等主机。请参见索引宏。
{ITEM.LASTVALUE}
导致通知发送的触发器表达式中第 N 个监控项的最新值。
如果最新历史值是在 Max history display period 时间之前采集的(在 Administration → General 菜单部分中设置),则该宏在前端中将解析为 *UNKNOWN*。
当在问题名称中使用时,查看问题事件时,该宏不会解析为监控项的最新值;相反,它会保留问题发生时的监控项值。
当在通知中使用时,在某些情况下,该宏可能不会解析为触发器触发时刻的最新监控项值。例如,如果某个监控项快速接收到两个值“A”和“B”,并且触发器因“A”而触发,则由于轻微的处理延迟,通知中显示的最新值可能是“B”——在触发器触发与通知创建之间的这段时间内,最新监控项值发生了变化。为避免这种情况,可以使用 {ITEM.VALUE} 宏,它会解析为触发器触发时刻的值,从而确保通知中使用的是正确的值。
它是 last(/{HOST.HOST}/{ITEM.KEY}) 的别名。
对于 text/log 监控项,解析后的值在以下位置会被前端截断为 20 个字符:
- 运行数据;
- 触发器描述;
- 触发器 URL;
- 触发器 URL 标签;
- 监控项值小部件的描述。
如需解析为完整值,可使用 macro functions,因为服务器不会截断任何值。例如:{{ITEM.LASTVALUE}.regsub("(.*)", \1)}。
该宏可与数字索引一起使用,例如 {ITEM.LASTVALUE<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见 indexed macros。
{ITEM.LASTVALUE.AGE}
最新监控项值采集与宏求值之间经过的时间。
以人类可读的格式显示(例如 1m 45s)。
此宏可与数字索引一起使用,例如 {ITEM.LASTVALUE.AGE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LASTVALUE.DATE}
最新监控项值被采集时的日期。
以 YYYYMMDD 格式显示。
在触发器名称(位于“监测 -> 问题”列表中)、事件名称以及标签名称和值中,使用服务器时区。在所有其他情况下,使用用户时区。
此宏可与数字索引一起使用,例如 {ITEM.LASTVALUE.DATE<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LASTVALUE.TIME}
最新监控项值被采集时的时间。
以 HHMMSS 格式显示。
在触发器名称(位于 Monitoring -> Problems 列表中)、事件名称以及标签名称和值中,使用服务器时区。在所有其他情况下,使用用户时区。
此宏可与数字索引一起使用,例如 {ITEM.LASTVALUE.TIME<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LASTVALUE.TIMESTAMP}
最新监控项值被采集时的 UNIX 时间戳。
此宏可与数字索引一起使用,例如 {ITEM.LASTVALUE.TIMESTAMP<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见 索引宏。
{ITEM.LOG.AGE}
日志事件的时长。
精确到秒。
此宏可与数字索引一起使用,例如 {ITEM.LOG.AGE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见 带索引的宏。
{ITEM.LOG.DATE}
日志条目写入日志时的日期。
此宏可与数字索引一起使用,例如 {ITEM.LOG.DATE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LOG.EVENTID}
事件日志中事件的 ID。
仅适用于 Windows 事件日志监控。
此宏可与数字索引一起使用,例如 {ITEM.LOG.EVENTID<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LOG.NSEVERITY}
事件日志中事件的数字严重性。
仅适用于 Windows 事件日志监控。
此宏可与数字索引一起使用,例如 {ITEM.LOG.NSEVERITY<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LOG.SEVERITY}
事件日志中事件的文字严重性。
仅适用于 Windows 事件日志监控。
此宏可与数字索引一起使用,例如 {ITEM.LOG.SEVERITY<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LOG.SOURCE}
事件日志中事件的来源。
仅适用于 Windows 事件日志监控。
此宏可与数字索引一起使用,例如 {ITEM.LOG.SOURCE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LOG.TIME}
日志条目写入日志的时间。
此宏可与数字索引一起使用,例如 {ITEM.LOG.TIME<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.LOG.TIMESTAMP}
日志条目写入日志时的 UNIX 时间戳。
此宏可与数字索引一起使用,例如 {ITEM.LOG.TIMESTAMP<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.NAME}
已解析所有宏后的监控项名称。
此宏可与数字索引一起使用,例如 {ITEM.NAME<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.NAME.ORIG}
监控项的原始名称(宏未解析)。
此宏可与数字索引一起使用,例如 {ITEM.NAME.ORIG<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.STATE}
导致通知的触发器表达式中第 N 个监控项的最新状态。
可能的值:不支持、正常。
此宏可与数字索引一起使用,例如 {ITEM.STATE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见 索引宏。
{ITEM.STATE.ERROR}
监控项变为不支持时,说明其原因的详细错误消息。
如果监控项进入不支持状态后又立即恢复为支持状态,则错误字段可能为空。
{ITEM.VALUE}
解析结果为以下两者之一:
- 如果在触发器状态变更的上下文中使用,例如显示事件或发送通知时,则解析为触发器表达式中第 N 个监控项的历史值(事件发生时的值);
- 如果在没有触发器状态变更上下文的情况下使用,例如在弹出选择窗口中显示触发器列表时,则解析为触发器表达式中第 N 个监控项的最新值。在这种情况下,其作用与 {ITEM.LASTVALUE} 相同。
在第一种情况下,如果历史值已被删除或从未存储过,则会解析为 *UNKNOWN*。
在第二种情况下,且仅在前端中,如果最新历史值是在 Max history display period 之前采集的,则会解析为 *UNKNOWN*(在 Administration→General 菜单部分中设置)。
对于 text/log 监控项,前端会在以下位置将解析后的值截断为 20 个字符:
- 运行数据;
- 触发器描述;
- 触发器 URL;
- 触发器 URL 标签;
- 监控项值小组件的描述。
如需解析为完整值,可使用 宏函数,因为服务器不会截断任何值。例如:{{ITEM.VALUE}.regsub("(.*)", \1)}。
此宏可与数字索引一起使用,例如 {ITEM.VALUE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。另请参见 索引宏。
{ITEM.VALUE.AGE}
监控项值采集与宏求值之间经过的时间。
以人类可读的格式显示(例如 1m 45s)。
此宏可与数字索引一起使用,例如 {ITEM.VALUE.AGE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.VALUE.DATE}
监控项值被采集时的日期。
以 YYYYMMDD 格式显示。
在触发器名称(位于“监测 -> 故障”列表中)、事件名称以及标签名称和值中,使用服务器时区。在所有其他情况下,使用用户时区。
此宏可与数字索引一起使用,例如 {ITEM.VALUE.DATE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.VALUE.TIME}
收集监控项值时的时间。
以 HHMMSS 格式显示。
在触发器名称(位于“监控”->“故障”列表中)、事件名称以及标签名称和值中,使用服务器时区。在所有其他情况下,使用用户时区。
此宏可与数字索引一起使用,例如 {ITEM.VALUE.TIME<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.VALUE.TIMESTAMP}
监控项值被采集时的 UNIX 时间戳。
此宏可与数字索引一起使用,例如 {ITEM.VALUE.TIMESTAMP<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{ITEM.VALUETYPE}
导致通知的触发器表达式中第 N 个监控项的值类型。
可能的值:0 - 数值浮点型,1 - 字符,2 - 日志,3 - 数值无符号型,4 - 文本。
此宏可与数字索引一起使用,例如 {ITEM.VALUETYPE<1-9>},用于指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
低级发现通知宏
{LLDRULE.DESCRIPTION}
导致通知的低级别发现规则的描述。
{LLDRULE.DESCRIPTION.ORIG}
导致通知的低级别发现规则的原始描述(其中的宏未解析)。
{LLDRULE.ID}
导致通知的低级别发现规则的数字 ID。
{LLDRULE.KEY}
导致通知的低级别发现规则的键值。
{LLDRULE.KEY.ORIG}
导致通知的低级别发现规则的原始键值(宏未解析)。
{LLDRULE.NAME}
导致通知的低级别发现规则的名称。
{LLDRULE.NAME.ORIG}
导致通知的低级别发现规则的原始名称(宏未解析)。
{LLDRULE.STATE}
低级发现规则的最新状态。
可能的值:不支持、正常。
此宏可与数字索引一起使用,例如 {LLDRULE.STATE<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见索引宏。
{LLDRULE.STATE.ERROR}
包含低级发现规则变为不支持原因详细信息的错误消息。
如果低级发现规则进入不支持状态后又立即恢复为受支持状态,则错误字段可能为空。
地图宏
{MAP.ID}
网络拓扑图 ID。
{MAP.NAME}
网络地图名称。
Proxy 宏
{PROXY.DESCRIPTION}
proxy 描述。
解析结果可以是以下之一:
- 触发器表达式中第 N 个监控项所属的 proxy(在基于触发器的通知中)。此处可使用带索引宏;
- 执行发现的 proxy(在发现通知中)。此处使用 {PROXY.DESCRIPTION},不带索引;
- active agent 注册到的 proxy(在自动注册通知中)。此处使用 {PROXY.DESCRIPTION},不带索引。
此宏可与数字索引一起使用,例如 {PROXY.DESCRIPTION<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见带索引的宏。
{PROXY.NAME}
proxy 名称。
可解析为以下之一:
- 触发器表达式中第 N 个监控项的 proxy(在基于触发器的通知中)。此处可使用带索引宏;
- 执行发现的 proxy(在发现通知中)。此处使用 {PROXY.NAME},不带索引;
- 活动 agent 注册到的 proxy(在自动注册通知中)。此处使用 {PROXY.NAME},不带索引。
此宏可与数字索引一起使用,例如 {PROXY.NAME<1-9>},以指向触发器表达式中的第一个、第二个、第三个等监控项。请参见带索引的宏。
脚本宏
{MANUALINPUT}
用户在执行脚本时指定的手动输入值。
服务宏
{SERVICE.DESCRIPTION}
已解析宏的服务描述。
{SERVICE.ID}
触发操作的服务的数字 ID。
{SERVICE.NAME}
解析宏后的服务名称。
{SERVICE.ROOTCAUSE}
导致服务失败的触发器问题事件列表,按严重性和主机名称排序。
包括以下详细信息:主机名称、事件名称、严重性、持续时间、服务标签和值。
{SERVICE.TAGS}
服务事件标签的逗号分隔列表。
服务事件标签可在服务配置的标签部分中定义。如果不存在标签,则展开为空字符串。
{SERVICE.TAGSJSON}
包含服务事件标签对象的 JSON 数组。
服务事件标签可在服务配置的标签部分中定义。如果不存在标签,则展开为空数组。
{SERVICE.TAGS.<tag name>}
由标签名称引用的服务事件标签值。
服务事件标签可在服务配置的标签部分中定义。
包含非字母数字字符的标签名称(包括非英语多字节 UTF 字符)必须用双引号括起来。带引号的标签名称中的引号和反斜杠必须使用反斜杠进行转义。
触发器宏
{TRIGGER.DESCRIPTION}
触发器描述。
如果在通知文本中使用 {TRIGGER.DESCRIPTION},则会展开触发器描述中支持的所有宏。
{TRIGGER.EVENTS.ACK}
在拓扑图中,表示拓扑图元素的已确认事件数量;在通知中,表示生成当前事件的触发器的已确认事件数量。
{TRIGGER.EVENTS.PROBLEM.ACK}
所有触发器中已确认的问题事件数量,不考虑其状态。
{TRIGGER.EVENTS.PROBLEM.UNACK}
所有触发器中未确认的问题事件数量,不考虑其状态。
{TRIGGER.EVENTS.UNACK}
地图中某个地图元素的未确认事件数量,或通知中生成当前事件的触发器的未确认事件数量。
{TRIGGER.EXPRESSION}
触发器表达式。
{TRIGGER.EXPRESSION.EXPLAIN}
部分求值后的触发器表达式。
基于监控项的函数会在事件生成时进行求值,并以结果替换,而所有其他函数则按表达式中的原样显示。可用于调试触发器表达式。
{TRIGGER.EXPRESSION.RECOVERY}
如果 触发器配置 中的 OK event generation 设置为“Recovery expression”,则返回触发器恢复表达式;否则返回空字符串。
{TRIGGER.EXPRESSION.RECOVERY.EXPLAIN}
部分求值的触发器恢复表达式。
基于监控项的函数会在事件生成时进行求值,并替换为求值结果,而所有其他函数则按表达式中的原样显示。可用于调试触发器恢复表达式。
{TRIGGER.HOSTGROUP.NAME}
定义该触发器的主机组列表,按 SQL 查询排序,并以逗号加空格分隔。
{TRIGGER.ID}
触发此操作的数字触发器 ID。
{TRIGGER.NAME}
已解析宏的触发器名称。
请注意,可在动作中使用 {EVENT.NAME} 来显示已解析宏的已触发事件/问题名称。
{TRIGGER.NAME.ORIG}
原始触发器名称(宏未解析)。
{TRIGGER.NSEVERITY}
触发器严重性的数值。
可能的值:0 - 未分类,1 - 信息,2 - 警告,3 - 一般严重,4 - 高,5 - 灾难。
{TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK}
处于问题状态的触发器中,已确认的问题事件数量。
{TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK}
处于问题状态的触发器中未确认的问题事件数量。
{TRIGGER.SEVERITY}
触发器严重性名称。
可在 Administration > General > Trigger displaying options 中定义。
{TRIGGER.STATE}
触发器表达式的最新状态。
可能的值:Unknown、Normal。
{TRIGGER.STATE.ERROR}
触发器变为不支持时,说明其原因的详细错误消息。
如果触发器进入不支持状态后又立即恢复为支持状态,则错误字段可能为空。
{TRIGGER.STATUS}
执行操作步骤时的触发器值。
可能的值:Problem、OK。
{TRIGGER.TEMPLATE.NAME}
按 SQL 查询排序、以逗号加空格分隔的模板列表,其中定义了该触发器;如果该触发器是在主机中定义的,则为 *UNKNOWN*。
{TRIGGER.URL}
触发器 URL。
{TRIGGER.URL.NAME}
触发器 URL 的标签。
{TRIGGER.VALUE}
当前的触发器数值。
可能的值:0 - 触发器处于正常状态,1 - 触发器处于问题状态。
{TRIGGERS.ACK}
地图元素的已确认触发器数量,忽略触发器状态。
如果某个触发器的所有问题事件都已确认,则该触发器被视为已确认。
{TRIGGERS.PROBLEM.ACK}
地图元素中已确认的问题触发器数量。
如果某个触发器的所有问题事件都已确认,则该触发器被视为已确认。
{TRIGGERS.PROBLEM.UNACK}
地图元素中未确认问题触发器的数量。
如果某个触发器至少有一个问题事件未被确认,则该触发器被视为未确认。
{TRIGGERS.UNACK}
地图元素中未确认触发器的数量,忽略触发器状态。
如果某个触发器至少有一个问题事件未被确认,则该触发器被视为未确认。
用户名宏
{USER.FULLNAME}
添加了事件确认或启动了脚本的用户的姓名、姓氏和用户名。
{USER.NAME}
启动脚本的用户名称。
{USER.SURNAME}
启动该脚本的用户的姓氏。
启动该脚本的用户的用户名。
索引宏
索引宏语法 {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)} 将解析为图形中第二个监控项所属的主机。
除这里提到的情况外,索引宏在任何其他上下文中都不会解析。 对于其他上下文,请使用不带索引的宏({HOST.HOST}, {HOST.IP} 等)。