Table of Contents

2 按位置支持的用户宏

2 按位置支持的用户宏

概述

本节包含支持user-definable宏的位置列表。

对于动作、网络发现、Proxies以及本页“其他位置”部分下所列的所有位置，仅支持全局级别的用户宏。在上述提到的位置中，主机级别和模板级别的宏将不会被解析。

若要自定义宏值（例如缩短或提取特定子字符串），您可以使用macro functions。

动作

在 actions 中，用户宏可以用于以下字段：

位置		多个宏/与文本混合^脚注
基于触发器的通知和命令		是
基于触发器的内部通知		是
问题 update 通知		是
基于服务的通知和命令		是
服务 update 通知		是
时间段条件		否
操作
	默认操作步骤持续时间	否
	步骤持续时间	否

主机/主机原型

在host和创建-一个主机-原型配置中，用户宏可用于以下字段：

位置		多个宏/与文本混合^脚注
接口 IP/DNS		仅限DNS
接口端口		否
SNMP v1, v2
	SNMP团体名	是
SNMP v3
	上下文名称	是
	安全名称	是
	认证口令	是
	隐私口令	是
IPMI
	用户名	是
	密码	是
标签^脚注
	标签名称	是
	标签值	是

监控项/监控项原型

在item或item prototype 配置中，用户宏可以用于以下字段：

位置		多个宏/与文本混合^脚注
监控项名称		是
监控项键值参数		是
更新间隔		否
自定义间隔		否
超时（适用于超时监控项类型）		否
存储至（历史和趋势）		否
描述		是
计算/聚合监控项
	公式（表达式常量和函数参数；监控项键值参数；（仅聚合监控项）过滤条件（主机组名称和标签名称））	是
数据库监控
	用户名	是
	密码	是
	SQL query	是
HTTP agent
	URL^脚注	是
	query字段	是
	请求体	是
	请求头（名称和值）	是
	必需的状态码	是
	HTTP proxy	是
	HTTP认证用户名	是
	HTTP认证密码	是
	SSL证书文件	是
	SSL密钥文件	是
	SSL密钥密码	是
	允许的主机	是
JMX agent
	JMX端点	是
脚本监控项
	参数名称和值	是
浏览器监控项
	参数名称和值	是
SNMP agent
	SNMP OID	是
SSH agent
	用户名	是
	公钥文件	是
	私钥文件	是
	密码	是
	脚本	是
TELNET agent
	用户名	是
	密码	是
	脚本	是
Zabbix trapper
	允许的主机	是
标签^脚注
	标签名称	是
	标签值	是
预处理步骤
	参数（包括自定义脚本）	是
	自定义错误处理参数（“设置值为”和“设置错误为”字段）	是

低级发现

在配置低级发现中，
用户宏可以用于以下字段：

位置		多个宏/与文本混合^脚注
监控项键值参数		是
更新间隔		否
自定义间隔		否
超时（适用于超时监控项类型）		否
删除丢失资源		否
禁用丢失资源		否
描述		是
SNMP agent
	SNMP OID	是
SSH agent
	用户名	是
	公钥文件	是
	私钥文件	是
	密码	是
	脚本	是
TELNET agent
	用户名	是
	密码	是
	脚本	是
Zabbix trapper
	允许的主机	是
数据库监控
	用户名	是
	密码	是
	SQL query	是
JMX agent
	JMX 端点	是
HTTP agent
	URL^脚注	是
	query 字段	是
	请求体	是
	请求头（名称和值）	是
	所需状态码	是
	HTTP 认证用户名	是
	HTTP 认证密码	是
过滤器
	正则表达式	是
覆盖规则
	过滤器：正则表达式	是
	操作：update 间隔（适用于监控项原型）	否
	操作：历史数据存储周期（适用于监控项原型）	否
	操作：趋势数据存储周期（适用于监控项原型）	否

网络发现

在 network discovery rule 中，
用户宏可用于以下字段：

位置		多个宏/与文本混合^脚注
更新间隔		否
SNMP v1, v2
	SNMP 团体名	是
	SNMP OID	是
SNMP v3
	上下文名称	是
	安全名称	是
	认证口令	是
	加密口令	是
	SNMP OID	是

Proxies

在配置配置中，用户宏可以用于以下字段：

位置		多个宏/与文本混合^脚注
接口端口（用于主动agents，如果proxy属于组）		否
接口端口（用于被动proxy）		否
监控项类型的超时时间		否

proxy 组

在配置-proxy-组配置中，用户宏可以用于以下字段：

位置		多个宏/与文本混合^脚注
故障转移周期		否
最小proxies数量		否

模板

在 template 配置中，用户宏可以用于以下字段：

位置		多个宏/与文本混合^脚注
标签^脚注
	标签名	是
	标签值	是

触发器

在 trigger 配置中，用户宏可以在以下字段中使用：

位置		多个宏/与文本混合^脚注
名称		是
运行数据		是
表达式（仅在常量和函数参数中；不支持密文宏）		是
用于匹配的标签		是
菜单条目名称		是
菜单条目URL^脚注		是
描述		是
标签^脚注
	标签名称	是
	标签值	是

Web 场景

在web scenario配置中，用户宏可以用于以下字段：

位置		多个宏/与文本混合^脚注
名称		是
更新间隔		否
Agent		是
HTTP proxy		是
变量（仅值）		是
请求头（名称和值）		是
步骤
	名称	是
	URL^脚注	是
	变量（仅值）	是
	请求头（名称和值）	是
	超时	否
	必需的string	是
	必需的状态码	否
认证
	用户	是
	密码	是
	SSL 证书	是
	SSL 密钥文件	是
	SSL 密钥密码	是
标签^脚注
	标签名称	是
	标签值	是

其他位置

除了此处列出的位置外，用户宏还可以在以下字段中使用：

位置		多个宏/与文本混合^脚注
全局脚本（URL、脚本、SSH、Telnet、IPMI），包括确认文本		是
Webhooks
	JavaScript 脚本	否
	JavaScript 脚本参数名称	否
	JavaScript 脚本参数值	是
仪表板
	Top 主机仪表板小部件中数据类型为文本的列	是
	监控项值和仪表盘仪表板小部件中的描述参数	是
	蜂巢图仪表板小部件中的主/次标签文本参数	是
	URL 仪表板小部件中的 URL^脚注参数	是
用户 → 用户 → 媒介
	启用时	否
管理 → 常规 → GUI
	工作时间	否
管理 → 常规 → 超时
	监控项类型的超时	否
管理 → 常规 → 连接器
	URL	是
	用户名	是
	密码	是
	Bearer 令牌	是
	超时	否
	HTTP proxy	是
	SSL 证书文件	是
	SSL 密钥文件	是
	SSL 密钥密码	是
告警 → 媒介类型 → 消息模板
	主题	是
	消息	是
告警 → 媒介类型 → 脚本
	脚本参数	是
告警 → 媒介类型 → 媒介类型
	电子邮件媒介类型的用户名和密码字段（当认证设置为 "用户名和密码" 时；推荐使用配置）	是

有关 Zabbix 中支持的所有宏的完整列表，请参见 supported macros。

脚注

¹ 如果字段中的多个宏或与文本混合的宏在该位置不被支持，则单个宏必须填满整个字段。

² 在标签名称和值中使用的宏仅在事件生成过程中解析。

³ 包含配置的 URL 将无法工作，因为其中的宏将被解析为 "******"。

Documentation