2 支持用户自定义宏的位置

概述

用户自定义宏可以用于以下场景。

动作、网络发现、Proxies以及本页 其他位置下列出的内容仅支持全局级用户宏。在这些提到的位置，主机级和模板级宏将不会被解析。

动作

在动作中，用户宏可用于以下地方：

位置		多个宏/混合文本¹
基于触发器的通知和命令		支持
基于触发器的内部通知		支持
问题更新通知		支持
基于服务的通知和命令		支持
服务更新通知		支持
时间段条件		不支持
操作
	默认操作步骤持续时间	不支持
	步骤持续时间	不支持

主机/主机原型

在主机和主机原型配置中，用户宏可用于以下地方:

位置		多个宏/混合文本¹
接口IP/DNS		仅支持DNS
接口端口		不支持
SNMP v1, v2
	SNMP团体名	支持
SNMP v3
	上下文名称	支持
	安全名称	支持
	身份验证密码	支持
	隐私密码	支持
IPMI
	用户名	支持
	密码	支持
标签²
	标签名称	支持
	标签值	支持

监控项 / 监控项原型

在监控项或监控项原型配置中，用户宏可用于以下地方：

位置		多个宏/混合文本¹
监控项键参数		支持
更新间隔		不支持
自定义间隔		不支持
历史存储周期		不支持
趋势存储周期		不支持
描述		支持
计算监控项
	公式	支持
数据库监控
	用户名	支持
	密码	支持
	SQL查询	支持
HTTP代理
	URL³	支持
	查询字段	支持
	超时时间	不支持
	请求正文	支持
	请求头部 (名字和值)	支持
	返回状态码	支持
	HTTP代理	支持
	HTTP认证用户名	支持
	HTTP认证密码	支持
	SSl证书文件	支持
	SSl密钥文件	支持
	SSl密钥密码	支持
	允许的主机	支持
JMX代理
	JMX端点	支持
脚本监控项
	参数名称和值	支持
SNMP 代理
	SNMP OID	支持
SSH 代理
	用户名	支持
	公钥文件	支持
	私钥文件	支持
	密码	支持
	脚本	支持
TELNET 代理
	用户名	支持
	密码	支持
	脚本	支持
Zabbix采集器
	允许的主机	支持
标签²
	标签名称	支持
	标签值	支持
预处理
	步骤参数（包括自定义脚本）	支持

底层自动发现

在底层自动发现规则中，用户宏可用于以下地方：

位置		多个宏/混合文本¹
键参数		支持
更新间隔		不支持
自定义间隔		不支持
保留失效资源的时间		不支持
描述		支持
SNMP 代理
	SNMP OID	支持
SSH 代理
	用户名	支持
	公钥文件	支持
	私钥文件	支持
	密码	支持
	脚本	支持
TELNET 代理
	用户名	支持
	密码	支持
	脚本	支持
Zabbix采集器
	允许的主机	支持
数据库监控
	用户名	支持
	密码	支持
	SQL查询	支持
JMX 代理
	JMX 端点	支持
HTTP 代理
	URL³	支持
	查询字段	支持
	超时时间	不支持
	请求正文	支持
	请求头部 (名字和值)	支持
	返回状态码	支持
	HTTP认证用户名	支持
	HTTP认证密码	支持
过滤器
	正则表达式	支持
覆盖
	过滤器：正则表达式	支持
	操作: 更新间隔 (对于监控项原型)	不支持
	操作: 历史存储周期 (对于监控项原型)	不支持
	操作: 趋势存储周期 (对于监控项原型)	不支持

网络发现

在网络发现规则中，用户宏可用于以下地方：

位置		多个宏/混合文本¹
更新间隔		不支持
SNMP v1, v2
	SNMP 团体名	支持
	SNMP OID	支持
SNMP v3
	上下文名称	支持
	安全名称	支持
	身份验证密码	支持
	隐私密码	支持
	SNMP OID	支持

代理

在 proxy配置中，用户宏可用于以下地方：

位置		多个宏/混合文本¹
接口端口（用于被动代理）		不支持

模板

在模板配置中，用户宏可用于以下地方：

位置		多个宏/混合文本¹
标签²
	标签名称	支持
	标签值	支持

触发器

在触发器配置中，用户宏可用于以下地方：

位置		多个宏/混合文本¹
名称		支持
操作数据		支持
表达式 (仅在常量和函数参数中; 不支持加密的宏).		支持
描述		支持
URL³		支持
匹配标签		支持
标签²
	标签名字	支持
	标签值	支持

Web 场景

在 web 场景配置中，用户宏可用于以下地方：

位置		多个宏/混合文本¹
名称		支持
更新间隔		不支持
Agent		支持
HTTP 代理		支持
变量 (只允许值)		支持
请求头部 (名称和值)		支持
步骤
	名称	支持
	URL³	支持
	变量 (只允许值)	支持
	请求头部 (名称和值)	支持
	超时时间	不支持
	返回字符串	支持
	返回状态码	不支持
认证
	用户	支持
	密码	支持
	SSL 证书	支持
	SSL 密钥文件	支持
	SSL 密钥密码	支持
标签
	标签名称	支持
	标签值	支持

其他位置

除了以上列出的位置外，用户宏还可用于以下地方：

位置		多个宏/混合文本¹
全局脚本(脚本, SSH, Telnet, IPMI),包括确认文本		支持
Webhooks
	JavaScript 脚本	不支持
	JavaScript 脚本参数名称	不支持
	JavaScript 脚本参数值	支持
监控 → 仪表盘
	监控项键值仪表板组件的描述字段	支持
	动态 URL 仪表板组件的URL³字段	支持
管理 → 用户 → 媒介
	活动时间	不支持
管理 → 一般 → 界面设置
	工作时间	不支持
管理 → 媒介类型 → 消息模板
	主题	支持
	消息	支持

有关 Zabbix 支持的所有宏的完整列表，请参阅支持的宏。

附注

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

² URLs 包含秘密宏将不起作用，因为其中的宏将被解析为 "******"。

Documentation