2 支持用户自定义宏的位置
概述
本章节包含支持 用户可定义 宏的位置列表。
对于 动作，网络发现， Proxy 和此页的 其他位置 部分下列出的所有位置，仅支持全局级别的用户宏。 在上述位置，主机级和模板级宏将不会被解析。
若要自定义宏值（例如，缩短或提取特定的子字符串），你可以使用宏函数。
动作
在 动作中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 基于触发器的通知和命令 | 支持 | |
| 基于触发器的内部通知 | 支持 | |
| 问题更新通知 | 支持 | |
| 基于服务的通知和命令 | 支持 | |
| 服务更新通知 | 支持 | |
| 时间周期条件 | 不支持 | |
| 操作 | ||
| 默认操作步骤持续时间 | 不支持 | |
| 步骤持续时间 | 不支持 | |
主机/主机原型
在 主机 和 主机原型 配置中，用户宏可以在以下字段中使用：
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 接口 IP/DNS | 仅 DNS | |
| 接口端口 | 否 | |
| SNMP v1, v2 | ||
| SNMP 社区 | 是 | |
| SNMP v3 | ||
| 上下文名称 | 是 | |
| 安全名称 | 是 | |
| 认证密码 | 是 | |
| 隐私密码 | 是 | |
| IPMI | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 标签2 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
监控项 / 监控项原型
在item或item prototype配置中，用户宏可以在以下字段中使用：
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 监控项名称 | 是 | |
| 监控项键参数 | 是 | |
| 更新间隔 | 否 | |
| 自定义间隔 | 否 | |
| 超时时间(适用于supported 监控项类型) | 否 | |
| 存储至(用于历史和趋势) | 否 | |
| 描述 | 是 | |
| 计算/聚合监控项 | ||
| 公式(表达式常量和函数参数;监控项键参数;(聚合监控项仅)过滤条件(主机组名称和标签名称)) | 是 | |
| 数据库监视器 | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| SQL query | 是 | |
| HTTP agent | ||
| URL3 | 是 | |
| query字段 | 是 | |
| 请求正文 | 是 | |
| 标头(名称和值) | 是 | |
| 需要的状态代码 | 是 | |
| HTTP proxy | 是 | |
| HTTP认证用户名 | 是 | |
| HTTP认证密码 | 是 | |
| SSL证书文件 | 是 | |
| SSL密钥文件 | 是 | |
| SSL密钥密码 | 是 | |
| 允许的主机 | 是 | |
| JMX agent | ||
| JMX端点 | 是 | |
| 脚本监控项 | ||
| 参数名称和值 | 是 | |
| 浏览器监控项 | ||
| 参数名称和值 | 是 | |
| SNMP agent | ||
| SNMP OID | 是 | |
| SSH agent | ||
| 用户名 | 是 | |
| 公钥文件 | 是 | |
| 私钥文件 | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| TELNET agent | ||
| 用户名 | 是 | |
| 密码 | 是 | |
| 脚本 | 是 | |
| Zabbix接收器 | ||
| 允许的主机 | 是 | |
| 标签2 | ||
| 标签名称 | 是 | |
| 标签值 | 是 | |
| 预处理步骤 | ||
| 参数(包括自定义脚本) | 是 | |
| 自定义错误处理参数(设置值为和设置错误为字段) | 是 | |
低级别自动发现
在低级别自动发现规则中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 键参数 | 支持 | |
| 更新间隔 | 不支持 | |
| 自定义间隔 | 不支持 | |
| 超时 (适用于支持的 监控项类型) | 不支持 | |
| 删除丢失的资源 | 不支持 | |
| 禁用丢失的资源 | 不支持 | |
| 描述 | 支持 | |
| SNMP 代理 | ||
| SNMP OID | 支持 | |
| SSH 代理 | ||
| 用户名 | 支持 | |
| 公钥文件 | 支持 | |
| 私钥文件 | 支持 | |
| 密码 | 支持 | |
| 脚本 | 支持 | |
| TELNET 代理 | ||
| 用户名 | 支持 | |
| 密码 | 支持 | |
| 脚本 | 支持 | |
| Zabbix采集器 | ||
| 允许的主机 | 支持 | |
| 数据库监控 | ||
| 用户名 | 支持 | |
| 密码 | 支持 | |
| SQL查询 | 支持 | |
| JMX 代理 | ||
| JMX 端点 | 支持 | |
| HTTP 代理 | ||
| URL3 | 支持 | |
| 查询字段 | 支持 | |
| 请求体 | 支持 | |
| 请求头部 (名字和值) | 支持 | |
| 返回状态码 | 支持 | |
| HTTP认证用户名 | 支持 | |
| HTTP认证密码 | 支持 | |
| 过滤器 | ||
| 正则表达式 | 支持 | |
| 覆盖 | ||
| 过滤器：正则表达式 | 支持 | |
| 操作: 更新间隔 (对于监控项原型) | 不支持 | |
| 操作: 历史存储周期 (对于监控项原型) | 不支持 | |
| 操作: 趋势存储周期 (对于监控项原型) | 不支持 | |
网络发现
在 网络发现规则中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 更新间隔 | 不支持 | |
| SNMP v1, v2 | ||
| SNMP 团体名 | 支持 | |
| SNMP OID | 支持 | |
| SNMP v3 | ||
| 上下文名称 | 支持 | |
| 安全名称 | 支持 | |
| 身份验证密码 | 支持 | |
| 隐私密码 | 支持 | |
| SNMP OID | 支持 | |
代理
在 代理配置中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 接口端口（如果代理属于组，则用于主动代理） | 不支持 | |
| 接口端口（用于被动代理） | 不支持 | |
| 监控项类型的超时 | 不支持 | |
代理组
在 代理组配置中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 故障恢复时间 | 不支持 | |
| 最小代理数量 | 不支持 | |
模板
在 模板 配置中，用户宏可用于以下地方：
触发器
在 触发器 配置中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 名称 | 支持 | |
| 操作数据 | 支持 | |
| 表达式 (仅在常量和函数参数中; 不支持加密的宏)。 | 支持 | |
| 匹配标签 | 支持 | |
| 菜单项名称 | 支持 | |
| 菜单项URL3 | 支持 | |
| 描述 | 支持 | |
| 标签2 | ||
| 标签名称 | 支持 | |
| 标签值 | 支持 | |
Web 场景
在 Web 场景配置中，用户宏可用于以下地方：
| 位置 | 多个宏/混合文本1 | |
|---|---|---|
| 名称 | 支持 | |
| 更新间隔 | 不支持 | |
| 代理 | 支持 | |
| HTTP 代理 | 支持 | |
| 变量 (只允许值) | 支持 | |
| 请求头部 (名称和值) | 支持 | |
| 步骤 | ||
| 名称 | 支持 | |
| URL3 | 支持 | |
| 变量 (只允许值) | 支持 | |
| 请求头部 (名称和值) | 支持 | |
| 超时 | 不支持 | |
| 返回字符串 | 支持 | |
| 返回状态码 | 不支持 | |
| 认证 | ||
| 用户 | 支持 | |
| 密码 | 支持 | |
| SSL 证书 | 支持 | |
| SSL 密钥文件 | 支持 | |
| SSL 密钥密码 | 支持 | |
| 标签 | ||
| 标签名称 | 支持 | |
| 标签值 | 支持 | |
其他位置
除了此处列出的位置，用户宏还可以在以下字段中使用：
| 位置 | 多个宏/与文本混合1 | |
|---|---|---|
| 全局脚本（URL、脚本、SSH、Telnet、IPMI），包括确认文本 | 是 | |
| Webhooks | ||
| JavaScript 脚本 | 否 | |
| JavaScript 脚本参数名称 | 否 | |
| JavaScript 脚本参数值 | 是 | |
| 仪表板 | ||
| 数据类型 Text 在 Top 主机 仪表板小部件的列中 | 是 | |
| Description 参数在 监控项 value 和 Gauge 仪表板小部件中 | 是 | |
| 主/次标签 Text 参数在 Honeycomb 仪表板小部件中 | 是 | |
| URL3 参数在 URL 仪表板小部件中 | 是 | |
| 用户 → 用户 → 媒体 | ||
| 当激活时 | 否 | |
| 管理 → 一般 → GUI | ||
| 工作时间 | 否 | |
| 管理 → 一般 → 超时时间 | ||
| 监控项 类型的超时时间 | 否 | |
| 管理 → 一般 → 连接器 | ||
| URL | 是 | |
| 用户名 | 是 | |
| 密码 | 是 | |
| 载体令牌 | 是 | |
| 超时时间 | 否 | |
| HTTP proxy | 是 | |
| SSL 证书文件 | 是 | |
| SSL 密钥文件 | 是 | |
| SSL 密钥密码 | 是 | |
| 警报 → 媒体类型 → 消息模板 | ||
| 主题 | 是 | |
| 消息 | 是 | |
| 警报 → 媒体类型 → 脚本 | ||
| 脚本参数 | 是 | |
| 警报 → 媒体类型 → 媒体类型 | ||
| Username 和 Password 字段对于 Email 媒体类型（当 Authentication 设置为“Username and password”；secret macros 推荐） | 是 | |
对于 Zabbix 中支持的所有宏的完整列表，请参阅supported macros。
附注
1 如果该位置不支持字段中的多个宏或与混合文本的宏，则必须使用单个宏填充整个字段。
2标记名称和值中使用的宏仅在事件生成过程中解析。
3 URLs 包含密钥宏 将不起作用，因为其中的宏将被解析为 "******"。