2 按位置支持的用户宏
概述
本节列出了支持 user-definable宏 的所有位置。
对于动作、 网络发现、Proxies以及本页面其他位置部分列出的所有位置， 仅支持全局级别的用户宏。在上述位置中，主机级别 和模板级别的宏将不会被解析。
动作
在actions中，用户宏可以 用于以下字段：
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 基于触发器的通知和命令 | 是 | |
| 基于触发器的内部通知 | 是 | |
| 问题update通知 | 是 | |
| 基于服务的通知和命令 | 是 | |
| 服务update通知 | 是 | |
| 时间段条件 | 否 | |
| 操作 | ||
| 默认操作步骤持续时间 | 否 | |
| 步骤持续时间 | 否 | |
主机/主机原型
| 位置 | 支持多宏/与文本混合1 | |
|---|---|---|
| 接口IP/DNS | 仅DNS | |
| 接口端口 | 否 | |
| SNMP v1, v2 | ||
| SNMP团体名 | 是 | |
| SNMP v3 | ||
| 上下文名称 | 是 | |
| 安全名称 | 是 | |
| 认证口令 | 是 | |
| 加密口令 | 是 | |
| IPMI | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 标签2 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
监控项/监控项原型
在item或item prototype配置中 用户宏可用于以下字段：
| 位置 | 多宏/与文本混合1 | |
|---|---|---|
| 监控项键参数 | 是 | |
| 更新间隔 | 否 | |
| 自定义间隔 | 否 | |
| 历史存储周期 | 否 | |
| 趋势存储周期 | 否 | |
| 描述 | 是 | |
| 计算/聚合监控项 | ||
| 公式（表达式常量和函数参数；监控项键参数；(仅聚合监控项)过滤条件(主机组名称和标签名)) | 是 | |
| 数据库监控 | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| SQL query | 是 | |
| HTTP agent | ||
| URL3 | 是 | |
| query字段 | 是 | |
| 超时 | 否 | |
| 请求体 | 是 | |
| 头部（名称和值） | 是 | |
| 必需状态码 | 是 | |
| HTTP proxy | 是 | |
| HTTP认证用户名 | 是 | |
| HTTP认证密码 | 是 | |
| SSL证书file | 是 | |
| SSL密钥file | 是 | |
| SSL密钥密码 | 是 | |
| 允许主机 | 是 | |
| JMX agent | ||
| JMX端点 | 是 | |
| 脚本监控项 | ||
| 参数名和值 | 是 | |
| SNMP agent | ||
| SNMP OID | 是 | |
| SSH agent | ||
| 用户名 | 是 | |
| 公钥file | 是 | |
| 私钥file | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| TELNET agent | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| Zabbix trapper | ||
| 允许主机 | 是 | |
| 标签2 | ||
| 标签名 | 是 | |
| 标签值 | 是 | |
| 预处理 | ||
| 步骤参数（包括自定义脚本） | 是 | |
低级发现
在配置低级发现中， 用户宏可用于以下字段：
| 位置 | 多宏/与文本混合1 | |
|---|---|---|
| 键参数 | 是 | |
| 更新间隔 | 否 | |
| 自定义间隔 | 否 | |
| 保留丢失资源周期 | 否 | |
| 描述 | 是 | |
| SNMP agent | ||
| SNMP OID | 是 | |
| SSH agent | ||
| 用户名 | 是 | |
| 公钥 file | 是 | |
| 私钥 file | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| TELNET agent | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| Zabbix trapper | ||
| 允许的 主机 | 是 | |
| 数据库监控 | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| SQL query | 是 | |
| JMX agent | ||
| JMX端点 | 是 | |
| HTTP agent | ||
| URL3 | 是 | |
| query 字段 | 是 | |
| 超时 | 否 | |
| 请求体 | 是 | |
| 头部（名称和值） | 是 | |
| 必需状态码 | 是 | |
| HTTP认证用户名 | 是 | |
| HTTP认证密码 | 是 | |
| 过滤器 | ||
| 正则表达式 | 是 | |
| 覆盖 | ||
| 过滤器：正则表达式 | 是 | |
| 操作：update 间隔（用于 监控项原型） | 否 | |
| 操作：历史存储周期（用于 监控项原型） | 否 | |
| 操作：趋势存储周期（用于 监控项原型） | 否 | |
网络发现
在network discovery rule中， 用户宏可用于以下字段：
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 更新间隔 | 否 | |
| SNMP v1, v2 | ||
| SNMP团体名 | 是 | |
| SNMP OID | 是 | |
| SNMP v3 | ||
| 上下文名称 | 是 | |
| 安全名称 | 是 | |
| 认证口令 | 是 | |
| 加密口令 | 是 | |
| SNMP OID | 是 | |
Proxies
在配置 配置中，用户宏可用于以下字段：
| 位置 | 多宏/与文本混合1 | |
|---|---|---|
| 接口端口（用于被动proxy） | 否 | |
模板
在template配置中 用户宏可用于以下字段:
触发器
在trigger配置中 用户宏可用于以下字段:
Web 场景
在web scenario配置中 用户宏可用于以下字段:
| 位置 | 多宏/与文本混合1 | |
|---|---|---|
| 名称 | 是 | |
| 更新间隔 | 否 | |
| Agent | 是 | |
| HTTP proxy | 是 | |
| 变量(仅值) | 是 | |
| 头部(名称和值) | 是 | |
| 步骤 | ||
| 名称 | 是 | |
| URL3 | 是 | |
| 变量(仅值) | 是 | |
| 头部(名称和值) | 是 | |
| 超时 | 否 | |
| 必需string | 是 | |
| 必需状态码 | 否 | |
| 认证 | ||
| 用户 | 是 | |
| 密码 | 是 | |
| SSL证书 | 是 | |
| SSL密钥file | 是 | |
| SSL密钥密码 | 是 | |
| 标签2 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
其他位置
除此处列出的位置外，用户宏还可用于以下字段：
| 位置 | 是否支持多宏/与文本混用1 | |
|---|---|---|
| 全局脚本（脚本、SSH、Telnet、IPMI），包括确认文本 | 是 | |
| Webhooks | ||
| JavaScript脚本 | 否 | |
| JavaScript脚本参数名称 | 否 | |
| JavaScript脚本参数值 | 是 | |
| 监控 → 仪表板 | ||
| Top 主机仪表板小部件中的文本数据类型列 | 是 | |
| 监控项值仪表板小部件中的描述参数 | 是 | |
| URL3仪表板小部件中的URL参数 | 是 | |
| 管理 → 用户 → 媒介 | ||
| 激活时段 | 否 | |
| 管理 → 常规 → GUI | ||
| 工作时间 | 否 | |
| 管理 → 媒介类型 → 消息模板 | ||
| 主题 | 是 | |
| 消息 | 是 | |
| 管理 → 媒介类型 → 媒介类型 | ||
| Email媒介类型的用户名和密码字段（当认证设置为"用户名和密码"时；推荐配置） | 是 | |
有关Zabbix支持的所有宏的完整列表，请参阅supported macros。
脚注
1 如果某字段位置不支持多个宏或宏与文本混合使用，则必须由单个宏填充整个字段。
2 标签名称和值中使用的宏仅在事件生成过程中解析。
3 包含配置的URL将无法正常工作，因为其中的宏会被解析为"******"。