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