[comment]: # translation:outdated [comment]: # ({d428738a-d428738a}) # 2 按位置支持的用户宏 [comment]: # ({/d428738a-d428738a}) [comment]: # ({0586ac4e-f0afb8e0}) #### 概述 本节包含支持[user-definable](/manual/config/macros/user_macros)宏的位置列表。 ::: noteclassic 对于*动作*、*网络发现*、*Proxies*以及本页“其他位置”部分下所列的所有位置，仅支持全局级别的用户宏。 在上述提到的位置中，主机级别和模板级别的宏将不会被解析。 ::: ::: noteclassic 若要自定义宏值（例如缩短或提取特定子字符串），您可以使用[macro functions](/manual/config/macros/macro_functions)。 ::: [comment]: # ({/0586ac4e-f0afb8e0}) [comment]: # ({bb611c5d-7cb4c86b}) #### 动作 在 [actions](/manual/config/notifications/action) 中，用户宏可以用于以下字段： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 基于触发器的通知和命令 | < | 是 | | 基于触发器的内部通知 | < | 是 | | 问题 update 通知 | < | 是 | | 基于服务的通知和命令 | < | 是 | | 服务 update 通知 | < | 是 | | 时间段条件 | < | 否 | | *操作* | < | < | | | 默认操作步骤持续时间 | 否 | | ^ | 步骤持续时间 | 否 | [comment]: # ({/bb611c5d-7cb4c86b}) [comment]: # ({9d1364cf-f30645e0}) #### 主机/主机原型 在[host](/manual/config/hosts/host)和[创建-一个主机-原型](/manual/vm_monitoring/example#创建-一个主机-原型)配置中，用户宏可用于以下字段： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 接口 IP/DNS | < | 仅限DNS | | 接口端口 | < | 否 | | *SNMP v1, v2* | < | < | | | SNMP团体名 | 是 | | *SNMP v3* | < | < | | | 上下文名称 | 是 | | ^ | 安全名称 | 是 | | ^ | 认证口令 | 是 | | ^ | 隐私口令 | 是 | | *IPMI* | < | < | | | 用户名 | 是 | | ^ | 密码 | 是 | | *标签*^[脚注](supported_by_location_user#脚注)^ | < | < | | | 标签名称 | 是 | | ^ | 标签值 | 是 | [comment]: # ({/9d1364cf-f30645e0}) [comment]: # ({7be6d794-d51563d6}) #### 监控项/监控项原型 在[item](/manual/config/items/item)或[item prototype](/manual/discovery/low_level_discovery/item_prototypes) 配置中，用户宏可以用于以下字段： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 监控项 名称 | < | 是 | | 监控项 键值参数 | < | 是 | | 更新间隔 | < | 否 | | 自定义间隔 | < | 否 | | 超时（适用于[超时](/manual/web_interface/frontend_sections/administration/general#超时) 监控项类型） | < | 否 | | 存储至（历史和趋势） | < | 否 | | 描述 | < | 是 | | *计算/聚合监控项* | < | < | | | 公式（表达式常量和函数参数；监控项键值参数；（*仅聚合监控项*）过滤条件（主机组名称和标签名称）） | 是 | | *数据库监控* | < | < | | | 用户名 | 是 | | ^ | 密码 | 是 | | ^ | SQL query | 是 | | *HTTP agent* | < | < | | | URL^[脚注](supported_by_location_user#脚注)^ | 是 | | ^ | query字段 | 是 | | ^ | 请求体 | 是 | | ^ | 请求头（名称和值） | 是 | | ^ | 必需的状态码 | 是 | | ^ | HTTP proxy | 是 | | ^ | HTTP认证用户名 | 是 | | ^ | HTTP认证密码 | 是 | | ^ | SSL证书文件 | 是 | | ^ | SSL密钥文件 | 是 | | ^ | SSL密钥密码 | 是 | | ^ | 允许的主机 | 是 | | *JMX agent* | < | < | | | JMX端点 | 是 | | *脚本监控项* | < | < | | | 参数名称和值 | 是 | | *浏览器监控项* | < | < | | | 参数名称和值 | 是 | | *SNMP agent* | < | < | | | SNMP OID | 是 | | *SSH agent* | < | < | | | 用户名 | 是 | | ^ | 公钥文件 | 是 | | ^ | 私钥文件 | 是 | | ^ | 密码 | 是 | | ^ | 脚本 | 是 | | *TELNET agent* | < | < | | | 用户名 | 是 | | ^ | 密码 | 是 | | ^ | 脚本 | 是 | | *Zabbix trapper* | < | < | | | 允许的主机 | 是 | | *标签*^[脚注](supported_by_location_user#脚注)^ | < | < | | | 标签名称 | 是 | | ^ | 标签值 | 是 | | *预处理步骤* | < | < | | | 参数（包括自定义脚本） | 是 | | | 自定义错误处理参数（“设置值为”和“设置错误为”字段） | 是 | [comment]: # ({/7be6d794-d51563d6}) [comment]: # ({2e0d1dad-747bd0ca}) #### 低级发现 在 [配置低级发现](/manual/discovery/low_level_discovery#配置低级发现) 中， 用户宏可以用于以下字段： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 监控项键值参数 | < | 是 | | 更新间隔 | < | 否 | | 自定义间隔 | < | 否 | | 超时（适用于 [超时](/manual/web_interface/frontend_sections/administration/general#超时) 监控项 类型） | < | 否 | | 删除丢失资源 | < | 否 | | 禁用丢失资源 | < | 否 | | 描述 | < | 是 | | *SNMP agent* | < | < | | | SNMP OID | 是 | | *SSH agent* | < | < | | | 用户名 | 是 | | ^ | 公钥文件 | 是 | | ^ | 私钥文件 | 是 | | ^ | 密码 | 是 | | ^ | 脚本 | 是 | | *TELNET agent* | < | < | | | 用户名 | 是 | | ^ | 密码 | 是 | | ^ | 脚本 | 是 | | *Zabbix trapper* | < | < | | | 允许的 主机 | 是 | | *数据库监控* | < | < | | | 用户名 | 是 | | ^ | 密码 | 是 | | ^ | SQL query | 是 | | *JMX agent* | < | < | | | JMX 端点 | 是 | | *HTTP agent* | < | < | | | URL^[脚注](supported_by_location_user#脚注)^ | 是 | | ^ | query 字段 | 是 | | ^ | 请求体 | 是 | | ^ | 请求头（名称和值） | 是 | | ^ | 所需状态码 | 是 | | ^ | HTTP 认证用户名 | 是 | | ^ | HTTP 认证密码 | 是 | | *过滤器* | < | < | | | 正则表达式 | 是 | | *覆盖规则* | < | < | | | 过滤器：正则表达式 | 是 | | ^ | 操作：update 间隔（适用于 监控项原型） | 否 | | ^ | 操作：历史数据存储周期（适用于 监控项原型） | 否 | | ^ | 操作：趋势数据存储周期（适用于 监控项原型） | 否 | [comment]: # ({/2e0d1dad-747bd0ca}) [comment]: # ({7c6ab06a-95f2f372}) #### 网络发现 在 [network discovery rule](/manual/discovery/network_discovery/rule) 中， 用户宏可用于以下字段： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 更新间隔 | < | 否 | | *SNMP v1, v2* | < | < | | | SNMP 团体名 | 是 | | ^ | SNMP OID | 是 | | *SNMP v3* | < | < | | | 上下文名称 | 是 | | ^ | 安全名称 | 是 | | ^ | 认证口令 | 是 | | ^ | 加密口令 | 是 | | ^ | SNMP OID | 是 | [comment]: # ({/7c6ab06a-95f2f372}) [comment]: # ({3962fa7e-575d88fc}) #### Proxies 在[配置](/manual/distributed_monitoring/proxies#配置) 配置中，用户宏可用于以下字段： | 位置 | < | 多宏/与文本混合^[1](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | *主动agents的地址 > 端口*（如果proxy属于某个组） | < | 否 | | 接口地址和端口（用于被动proxy） | < | 否 | | 监控项类型的超时设置 | < | 否 | [comment]: # ({/3962fa7e-575d88fc}) [comment]: # ({76ff2b0f-dbeb9eca}) #### proxy 组 在[配置-proxy-组](/manual/distributed_monitoring/proxies/ha#配置-proxy-组)配置中，用户宏可以用于以下字段： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 故障转移周期 | < | 否 | | 最小proxies数量 | < | 否 | [comment]: # ({/76ff2b0f-dbeb9eca}) [comment]: # ({d5117b03-32b6aef1}) #### 模板 在 [template](/manual/config/templates/template) 配置中， 用户宏可以用于以下字段： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | *标签*^[脚注](supported_by_location_user#脚注)^ | < | < | | | 标签名 | 是 | | ^ | 标签值 | 是 | [comment]: # ({/d5117b03-32b6aef1}) [comment]: # ({0d27e496-c78b04ef}) #### 触发器 在 [trigger](/manual/config/triggers/trigger) 配置中，用户宏可以在以下字段中使用： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 名称 | < | 是 | | 运行数据 | < | 是 | | 表达式（仅在常量和函数参数中；不支持密文宏） | < | 是 | | 用于匹配的标签 | < | 是 | | 菜单条目名称 | < | 是 | | 菜单条目URL^[脚注](supported_by_location_user#脚注)^ | < | 是 | | 描述 | < | 是 | | *标签*^[脚注](supported_by_location_user#脚注)^ | < | < | | | 标签名称 | 是 | | ^ | 标签值 | 是 | [comment]: # ({/0d27e496-c78b04ef}) [comment]: # ({423f6587-78f1f511}) #### Web 场景 在[web scenario](/manual/web_monitoring)配置中，用户宏可以用于以下字段： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 名称 | < | 是 | | 更新间隔 | < | 否 | | Agent | < | 是 | | HTTP proxy | < | 是 | | 变量（仅值） | < | 是 | | 请求头（名称和值） | < | 是 | | *步骤* | < | < | | | 名称 | 是 | | ^ | URL^[脚注](supported_by_location_user#脚注)^ | 是 | | ^ | 变量（仅值） | 是 | | ^ | 请求头（名称和值） | 是 | | ^ | 超时 | 否 | | ^ | 必需的string | 是 | | ^ | 必需的状态码 | 否 | | *认证* | < | < | | | 用户 | 是 | | ^ | 密码 | 是 | | ^ | SSL 证书 | 是 | | ^ | SSL 密钥文件 | 是 | | ^ | SSL 密钥密码 | 是 | | *标签*^[脚注](supported_by_location_user#脚注)^ | < | < | | | 标签名称 | 是 | | ^ | 标签值 | 是 | [comment]: # ({/423f6587-78f1f511}) [comment]: # ({1052c243-efe84e1d}) #### 其他位置 除了此处列出的位置外，用户宏还可以在以下字段中使用： | 位置 | < | 多个宏/与文本混合^[脚注](supported_by_location_user#脚注)^ | |-|------------------------------|----------| | 全局脚本（URL、脚本、SSH、Telnet、IPMI），包括确认文本 | < | 是 | | Webhooks | < | < | | | JavaScript 脚本 | 否 | | ^ | JavaScript 脚本参数名称 | 否 | | ^ | JavaScript 脚本参数值 | 是 | | *仪表板* | < | < | | | *Top 主机* 仪表板小部件中数据类型为 *文本* 的列 | 是 | | ^ | *监控项 值* 和 *仪表盘* 仪表板小部件中的 *描述* 参数 | 是 | | ^ | *蜂巢图* 仪表板小部件中的主/次标签 *文本* 参数 | 是 | | ^ | *URL* 仪表板小部件中的 *URL*^[脚注](supported_by_location_user#脚注)^ 参数 | 是 | | *用户 → 用户 → 媒介* | < | < | | | 启用时 | 否 | | *管理 → 常规 → GUI* | < | < | | | 工作时间 | 否 | | *管理 → 常规 → 超时* | < | < | | | 监控项 类型的超时 | 否 | | *管理 → 常规 → 连接器* | < | < | | | URL | 是 | | ^ | 用户名 | 是 | | ^ | 密码 | 是 | | ^ | Bearer 令牌 | 是 | | ^ | 超时 | 否 | | ^ | HTTP proxy | 是 | | ^ | SSL 证书文件 | 是 | | ^ | SSL 密钥文件 | 是 | | ^ | SSL 密钥密码 | 是 | | *告警 → 媒介类型 → 消息模板* | < | < | | | 主题 | 是 | | ^ | 消息 | 是 | | *告警 → 媒介类型 → 脚本* | < | < | | | 脚本参数 | 是 | | *告警 → 媒介类型 → 媒介类型* | < | < | | | *电子邮件* 媒介类型的 *用户名* 和 *密码* 字段（当 *认证* 设置为 "用户名和密码" 时；推荐使用 [配置](/manual/config/macros/user_macros#配置)） | 是 | 有关 Zabbix 中支持的所有宏的完整列表，请参见 [supported macros](/manual/appendix/macros/supported_by_location)。 [comment]: # ({/1052c243-efe84e1d}) [comment]: # ({3f947571-5a370e78}) ##### 脚注 ^**1**^ 如果字段中的多个宏或与文本混合的宏在该位置不被支持，则单个宏必须填满整个字段。 ^**2**^ 在标签名称和值中使用的宏仅在事件生成过程中解析。 ^**3**^ 包含 [配置](/manual/config/macros/user_macros#配置) 的 URL 将无法工作，因为其中的宏将被解析为 "\*\*\*\*\*\*"。 [comment]: # ({/3f947571-5a370e78})