2 按位置支持的用户宏
概述
本节包含支持user-definable宏的位置列表。
对于动作、网络发现、Proxies以及本页“其他位置”部分下所列的所有位置，仅支持全局级别的用户宏。 在上述提到的位置中，主机级别和模板级别的宏将不会被解析。
若要自定义宏值（例如缩短或提取特定子字符串），您可以使用macro functions。
动作
在 actions 中，用户宏可以用于以下字段：
| 位置 | 多个宏/与文本混合脚注 | |
|---|---|---|
| 基于触发器的通知和命令 | 是 | |
| 基于触发器的内部通知 | 是 | |
| 问题 update 通知 | 是 | |
| 基于服务的通知和命令 | 是 | |
| 服务 update 通知 | 是 | |
| 时间段条件 | 否 | |
| 操作 | ||
| 默认操作步骤持续时间 | 否 | |
| 步骤持续时间 | 否 | |
主机/主机原型
在host和创建-一个主机-原型配置中，用户宏可用于以下字段：
| 位置 | 多个宏/与文本混合脚注 | |
|---|---|---|
| 接口 IP/DNS | 仅限DNS | |
| 接口端口 | 否 | |
| SNMP v1, v2 | ||
| SNMP团体名 | 是 | |
| SNMP v3 | ||
| 上下文名称 | 是 | |
| 安全名称 | 是 | |
| 认证口令 | 是 | |
| 隐私口令 | 是 | |
| IPMI | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 标签脚注 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
监控项 / 监控项原型
在 监控项 或 监控项 原型 配置中，可以在以下字段中使用用户宏：
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| 监控项名称 | yes | |
| 监控项键值参数 | yes4 | |
| 更新间隔 | no | |
| 自定义间隔 | no | |
| 超时（适用于受支持的监控项类型） | no | |
| 最多存储（用于历史数据和趋势数据） | no | |
| 描述 | yes | |
| 计算/聚合监控项 | ||
| 公式（表达式常量和函数参数；监控项键值参数；（仅聚合监控项）筛选条件（主机组名称和标签名称）） | yes | |
| 数据库监控器 | ||
| 用户名 | yes | |
| 密码 | yes | |
| SQL 查询 | yes | |
| HTTP agent | ||
| URL3 | yes | |
| 查询字段 | yes | |
| 请求正文 | yes | |
| 标头（名称和值） | yes | |
| 必需状态码 | yes | |
| HTTP 代理 | yes | |
| HTTP 身份验证用户名 | yes | |
| HTTP 身份验证密码 | yes | |
| SSL 证书文件 | yes | |
| SSL 密钥文件 | yes | |
| SSL 密钥密码 | yes | |
| 允许的主机 | yes | |
| JMX agent | ||
| JMX 端点 | yes | |
| 脚本监控项 | ||
| 参数名称和值 | yes | |
| 浏览器监控项 | ||
| 参数名称和值 | yes | |
| SNMP agent | ||
| SNMP OID | yes | |
| SSH agent | ||
| 用户名 | yes | |
| 公钥文件 | yes | |
| 私钥文件 | yes | |
| 密码 | yes | |
| 脚本 | yes | |
| TELNET agent | ||
| 用户名 | yes | |
| 密码 | yes | |
| 脚本 | yes | |
| Zabbix trapper | ||
| 允许的主机 | yes | |
| 标签2 | ||
| 标签名称 | yes | |
| 标签值 | yes | |
| 预处理步骤 | ||
| 参数（包括自定义脚本） | yes | |
| 自定义错误处理参数（Set value to 和 Set error to 字段） | yes | |
低级别发现
在低级别发现规则中，可以在以下字段中使用用户宏：
| 位置 | 多个宏/与文本混用1 | |
|---|---|---|
| Key parameters | yes | |
| Update interval | no | |
| Custom interval | no | |
| Timeout (available for supported item types) | no | |
| Delete lost resources | no | |
| Disable lost resources | no | |
| Description | yes | |
| SNMP agent | ||
| SNMP OID | yes | |
| SSH agent | ||
| Username | yes | |
| Public key file | yes | |
| Private key file | yes | |
| Password | yes | |
| Script | yes | |
| TELNET agent | ||
| Username | yes | |
| Password | yes | |
| Script | yes | |
| Zabbix trapper | ||
| Allowed hosts | yes | |
| Database monitor | ||
| Username | yes | |
| Password | yes | |
| SQL query | yes | |
| JMX agent | ||
| JMX endpoint | yes | |
| HTTP agent | ||
| URL3 | yes | |
| Query fields | yes | |
| Request body | yes | |
| Headers (names and values) | yes | |
| Required status codes | yes | |
| HTTP authentication username | yes | |
| HTTP authentication password | yes | |
| Filters | ||
| Regular expression | yes | |
| Overrides | ||
| Filters: regular expression | yes | |
| Operations: update interval (for item prototypes) | no | |
| Operations: history storage period (for item prototypes) | no | |
| Operations: trend storage period (for item prototypes) | no | |
网络发现
在 network discovery rule 中，
用户宏可用于以下字段：
| 位置 | 多个宏/与文本混合脚注 | |
|---|---|---|
| 更新间隔 | 否 | |
| SNMP v1, v2 | ||
| SNMP 团体名 | 是 | |
| SNMP OID | 是 | |
| SNMP v3 | ||
| 上下文名称 | 是 | |
| 安全名称 | 是 | |
| 认证口令 | 是 | |
| 加密口令 | 是 | |
| SNMP OID | 是 | |
Proxies
在配置 配置中，用户宏可用于以下字段：
| 位置 | 多宏/与文本混合1 | |
|---|---|---|
| 主动agents的地址 > 端口（如果proxy属于某个组） | 否 | |
| 接口地址和端口（用于被动proxy） | 否 | |
| 监控项类型的超时设置 | 否 | |
proxy 组
在配置-proxy-组配置中，用户宏可以用于以下字段：
| 位置 | 多个宏/与文本混合脚注 | |
|---|---|---|
| 故障转移周期 | 否 | |
| 最小proxies数量 | 否 | |
模板
在 template 配置中， 用户宏可以用于以下字段：
触发器
在 trigger 配置中，用户宏可以在以下字段中使用：
| 位置 | 多个宏/与文本混合脚注 | |
|---|---|---|
| 名称 | 是 | |
| 运行数据 | 是 | |
| 表达式（仅在常量和函数参数中；不支持密文宏） | 是 | |
| 用于匹配的标签 | 是 | |
| 菜单条目名称 | 是 | |
| 菜单条目URL脚注 | 是 | |
| 描述 | 是 | |
| 标签脚注 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
Web 场景
在web scenario配置中，用户宏可以用于以下字段：
| 位置 | 多个宏/与文本混合脚注 | |
|---|---|---|
| 名称 | 是 | |
| 更新间隔 | 否 | |
| Agent | 是 | |
| HTTP proxy | 是 | |
| 变量（仅值） | 是 | |
| 请求头（名称和值） | 是 | |
| 步骤 | ||
| 名称 | 是 | |
| URL脚注 | 是 | |
| 变量（仅值） | 是 | |
| 请求头（名称和值） | 是 | |
| 超时 | 否 | |
| 必需的string | 是 | |
| 必需的状态码 | 否 | |
| 认证 | ||
| 用户 | 是 | |
| 密码 | 是 | |
| SSL 证书 | 是 | |
| SSL 密钥文件 | 是 | |
| SSL 密钥密码 | 是 | |
| 标签脚注 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
其他位置
除了此处列出的位置信息外，用户宏还可用于以下字段：
| 位置 | 多个宏/与文本混用1 | |
|---|---|---|
| 全局脚本（URL、脚本、SSH、Telnet、IPMI），包括确认文本 | yes | |
| webhook | ||
| JavaScript 脚本 | no | |
| JavaScript 脚本参数名 | no | |
| JavaScript 脚本参数值 | yes | |
| 仪表板 | ||
| Top hosts 仪表板小组件中的数据类型为 Text 的列 | yes | |
| Item value 和 Gauge 仪表板小组件中的 Description 参数 | yes | |
| Honeycomb 仪表板小组件中的主/副标签 Text 参数 | yes | |
| URL 仪表板小组件中的 URL3 参数 | yes | |
| Alerts → Media types → Message templates | ||
| 主题 | yes | |
| 消息 | yes | |
| Alerts → Media types → Script | ||
| 脚本参数 | yes | |
| Alerts → Media types → Media type | ||
| Email 媒介类型的 Username 和 Password 字段（当 Authentication 设置为 "Username and password" 时；建议使用secret macros） | yes | |
| Users → Users → Media | ||
| 启用时 | no | |
| Administration → General → GUI | ||
| 工作时间 | no | |
| Administration → General → Timeouts | ||
| 监控项类型的超时时间 | no | |
| Administration → General → Connectors | ||
| URL | yes | |
| 用户名 | yes | |
| 密码 | yes | |
| Bearer token | yes | |
| 超时 | no | |
| HTTP proxy | yes | |
| SSL 证书文件 | yes | |
| SSL 密钥文件 | yes | |
| SSL 密钥密码 | yes | |
有关 Zabbix 支持的所有宏的完整列表，请参见支持的宏。
脚注
1 如果某个位置不支持字段中包含多个宏或宏与文本混合，则单个宏必须填满整个字段。
2 标签名称和值中使用的宏仅在事件生成过程中解析。
3 包含secret macro的 URL 将无法正常工作，因为其中的宏会被解析为 "******"。
4 Zabbix trapper 监控项的 item key 中不支持宏。