位置支持的用户宏
概述
本章节包含支持 用户可定义 宏的位置列表。
对于 动作，网络发现， Proxy 和此页的 其他位置 部分下列出的所有位置，仅支持全局级别的用户宏。 在上述位置，主机级和模板级宏将不会被解析。
若要自定义宏值（例如，缩短或提取特定的子字符串），你可以使用宏函数。
动作
在 动作中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 基于触发器的通知和命令 | 支持 | |
| 基于触发器的内部通知 | 支持 | |
| 问题更新通知 | 支持 | |
| 基于服务的通知和命令 | 支持 | |
| 服务更新通知 | 支持 | |
| 时间周期条件 | 不支持 | |
| 操作 | ||
| 默认操作步骤持续时间 | 不支持 | |
| 步骤持续时间 | 不支持 | |
主机/主机原型
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 接口 IP/DNS | 仅 DNS | |
| 接口端口 | 否 | |
| SNMP | ||
| SNMP community | 是 | |
| 最大重复次数 | 否 | |
| 重试次数 | 否 | |
| 上下文名称 | 是 | |
| 安全名称 | 是 | |
| 身份验证密码 | 是 | |
| 隐私密码 | 是 | |
| IPMI | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 标签2 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
监控项 / 监控项原型
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 监控项名称 | 是 | |
| 监控项键参数 | 是4 | |
| 更新间隔 | 否 | |
| 自定义间隔 | 否 | |
| 超时（适用于支持的监控项类型） | 否 | |
| 保留时长（用于历史数据和趋势数据） | 否 | |
| 描述 | 是 | |
| 计算/聚合监控项 | ||
| 公式（表达式常量和函数参数；监控项键参数；（仅聚合监控项）筛选条件（主机组名称和标签名称）） | 是 | |
| 数据库监控 | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| SQL 查询 | 是 | |
| HTTP agent | ||
| URL3 | 是 | |
| 查询字段 | 是 | |
| 请求正文 | 是 | |
| 标头（名称和值） | 是 | |
| 所需状态码 | 是 | |
| HTTP proxy | 是 | |
| HTTP 身份验证用户名 | 是 | |
| HTTP 身份验证密码 | 是 | |
| SSl 证书文件 | 是 | |
| SSl 密钥文件 | 是 | |
| SSl 密钥密码 | 是 | |
| 允许的主机 | 是 | |
| JMX agent | ||
| JMX 端点 | 是 | |
| 脚本监控项 | ||
| 参数名称和值 | 是 | |
| 浏览器监控项 | ||
| 参数名称和值 | 是 | |
| Telemetry 查询监控项 | ||
| 时间偏移 | 否 | |
| 回溯限制 | 否 | |
| 粒度 | 否 | |
| SNMP agent | ||
| SNMP OID | 是 | |
| SSH agent | ||
| 用户名 | 是 | |
| 公钥文件 | 是 | |
| 私钥文件 | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| TELNET agent | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| Zabbix trapper | ||
| 允许的主机 | 是 | |
| 标签2 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
| 预处理步骤 | ||
| 参数（包括自定义脚本） | 是 | |
| 自定义错误处理参数（设置值为和设置错误为字段） | 是 | |
低级别发现
在低级别发现规则中，用户宏可用于以下字段：
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 键参数 | 是 | |
| 更新间隔 | 否 | |
| 自定义间隔 | 否 | |
| 超时（适用于受支持的监控项类型） | 否 | |
| 删除丢失的资源 | 否 | |
| 禁用丢失的资源 | 否 | |
| 描述 | 是 | |
| SNMP agent | ||
| SNMP OID | 是 | |
| SSH agent | ||
| 用户名 | 是 | |
| 公钥文件 | 是 | |
| 私钥文件 | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| TELNET agent | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| Zabbix trapper | ||
| 允许的主机 | 是 | |
| 数据库监控 | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| SQL 查询 | 是 | |
| JMX agent | ||
| JMX 端点 | 是 | |
| HTTP agent | ||
| URL3 | 是 | |
| 查询字段 | 是 | |
| 请求正文 | 是 | |
| 标头（名称和值） | 是 | |
| 必需的状态码 | 是 | |
| HTTP 身份验证用户名 | 是 | |
| HTTP 身份验证密码 | 是 | |
| Telemetry 查询 | ||
| 时间偏移 | 否 | |
| 回溯限制 | 否 | |
| 粒度 | 否 | |
| 过滤器 | ||
| 正则表达式 | 是 | |
| 覆盖 | ||
| 过滤器：正则表达式 | 是 | |
| 操作：更新间隔（用于监控项原型） | 否 | |
| 操作：历史数据存储周期（用于监控项原型） | 否 | |
| 操作：趋势数据存储周期（用于监控项原型） | 否 | |
网络发现
在 网络发现规则中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 更新间隔 | 不支持 | |
| SNMP v1, v2 | ||
| SNMP 团体名 | 支持 | |
| SNMP OID | 支持 | |
| SNMP v3 | ||
| 上下文名称 | 支持 | |
| 安全名称 | 支持 | |
| 身份验证密码 | 支持 | |
| 隐私密码 | 支持 | |
| SNMP OID | 支持 | |
proxy
在 proxy 配置中，用户宏可用于以下字段：
| Location | Multiple macros/mix with text1 | |
|---|---|---|
| Address for active agents > Port（如果 proxy 属于某个组） | no | |
| Interface address and port（用于被动 proxy） | no | |
| Timeouts for item types | no | |
proxy 组
在 proxy group 配置中，用户宏可用于以下字段：
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 故障切换周期 | 否 | |
| proxy 最小数量 | 否 | |
模板
在 模板 配置中，用户宏可用于以下地方：
触发器
在 触发器 配置中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 名称 | 支持 | |
| 操作数据 | 支持 | |
| 表达式 (仅在常量和函数参数中; 不支持加密的宏)。 | 支持 | |
| 匹配标签 | 支持 | |
| 菜单项名称 | 支持 | |
| 菜单项URL3 | 支持 | |
| 描述 | 支持 | |
| 标签2 | ||
| 标签名称 | 支持 | |
| 标签值 | 支持 | |
Web 场景
在 Web 场景配置中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 名称 | 支持 | |
| 更新间隔 | 不支持 | |
| 代理 | 支持 | |
| HTTP 代理 | 支持 | |
| 变量 (只允许值) | 支持 | |
| 请求头部 (名称和值) | 支持 | |
| 步骤 | ||
| 名称 | 支持 | |
| URL3 | 支持 | |
| 变量 (只允许值) | 支持 | |
| 请求头部 (名称和值) | 支持 | |
| 超时 | 不支持 | |
| 返回字符串 | 支持 | |
| 返回状态码 | 不支持 | |
| 认证 | ||
| 用户 | 支持 | |
| 密码 | 支持 | |
| SSL 证书 | 支持 | |
| SSL 密钥文件 | 支持 | |
| SSL 密钥密码 | 支持 | |
| 标签 | ||
| 标签名称 | 支持 | |
| 标签值 | 支持 | |
其他位置
除了此处列出的位置外，用户宏还可以用于以下字段：
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 全局脚本（URL、脚本、SSH、Telnet、IPMI），包括确认文本 | 是 | |
| Webhook | ||
| JavaScript 脚本 | 否 | |
| JavaScript 脚本参数名称 | 否 | |
| JavaScript 脚本参数值 | 是 | |
| 仪表板 | ||
| Top hosts 仪表板小组件中数据类型为 Text 的列 | 是 | |
| Item value 和 Gauge 仪表板小组件中的 Description 参数 | 是 | |
| Honeycomb 仪表板小组件中主/次标签的 Text 参数 | 是 | |
| URL 仪表板小组件中的 URL3 参数 | 是 | |
| 监控 > 问题、主机、最新数据 | ||
| 自定义文本列 | 是 | |
| 数据采集 > 模板、主机 | ||
| 自定义文本列 | 是 | |
| 数据采集 > 事件处理 | ||
| CEP 规则中的 Duration 字段 | 是 | |
| CEP 规则中的 Capacity 字段 | 是 | |
| 报警 > 媒介类型 > 消息模板 | ||
| 主题 | 是 | |
| 消息 | 是 | |
| 报警 > 媒介类型 > 脚本 | ||
| 脚本参数 | 是 | |
| 报警 > 媒介类型 > 媒介类型 | ||
| Email 媒介类型的 Username 和 Password 字段（当 Authentication 设置为“Username and password”时；建议使用机密宏） | 是 | |
| 用户 > 用户 > 媒介 | ||
| 启用时段 | 是 | |
| 管理 > 常规 > GUI | ||
| 工作时间 | 否 | |
| 管理 > 常规 > 超时 | ||
| 监控项类型的超时 | 否 | |
| 管理 > 常规 > 连接器 | ||
| URL | 是 | |
| Username | 是 | |
| Password | 是 | |
| Bearer token | 是 | |
| Timeout | 否 | |
| HTTP proxy | 是 | |
| SSL certificate file | 是 | |
| SSL key file | 是 | |
| SSL key password | 是 | |
如需查看 Zabbix 支持的所有宏的完整列表，请参阅支持的宏。
脚注
1 如果某个位置不支持字段中包含多个宏或宏与文本混合，则必须使用单个宏填满整个字段。
2 标签名称和值中使用的宏仅在事件生成过程中解析。
3 包含secret macro的 URL 将无法正常工作，因为其中的宏会被解析为 "******"。
4 Zabbix trapper 监控项的监控项键中不支持宏。