2 用户宏

概述

除了开箱即用的宏支持之外,Zabbix还支持用户宏,以提高灵活性。

用户宏可以在全局、模板和主机级别定义。这些宏有一种特殊的语法:

{$MACRO}

Zabbix根据以下优先级解析宏: 1.主机级宏(先选中) 2.为主机的一级模板(即直接链接到主机的模板)定义的宏,按模板ID排序 3.为主机二级模板定义的宏,按模板ID排序 4.为主机的三级模板定义的宏,按模板ID等排序。 5.全局宏(最后选中)

换句话说,如果主机不存在宏,Zabbix将尝试在深度不断增加的主机模板中找到它。如果仍然找不到,将使用全局宏(如果存在)。

如果同一级别的多个链接模板上存在具有相同名称的宏,则将使用ID最低的模板中的宏。因此,在多个模板中使用相同名称的宏是一种配置风险。

如果Zabbix找不到宏,宏将无法解析。

宏(包括用户宏)在配置部分(例如,在触发器列表中)被设计为不可解析,以使复杂的配置更加透明。

用户宏可用于: - 监控项名称 - 监控项key参数 - 监控项更新间隔和灵活间隔 - 触发器名称和描述 - 触发器表达式参数和常量(参见示例) - 许多其他位置-请参阅完整列表

全局和宿主宏的常见用例
  • 在多个位置使用全局宏;然后更改宏值并一键将配置更改应用于所有位置
  • 利用具有主机特定属性的模板:密码、端口号、文件名、正则表达式等。

建议使用主机宏而不是全局宏,因为添加、更新或删除全局宏会导致所有主机进行增量配置更新。更多信息,请参阅相关文档。被动和主动agent检查

配置

要定义用户宏,前往前端的相应位置:

  • 对于全局宏,访问 管理 → 宏
  • 对于主机和模板级别的宏,打开主机或模板属性 并查找 标签

用户宏具有以下属性:

参数 描述
宏名称。名称必须用花括号包裹并以美元符号开头。
示例:{$FRONTEND_URL}。宏名称中允许以下字符:A-Z(仅大写), 0-9 , _ , .
宏值。支持三种值类型:
文本(默认) - 纯文本值
秘密文本 - 值用星号掩码
Vault 秘密 - 值包含指向vault 秘密的路径/查询。

要更改值类型,请点击值输入字段末尾的按钮。

用户宏值的最大长度为2048个字符。
描述 文本字段,用于提供有关此宏的更多信息。

在配置用户宏时,注意以下上下文特定的行为:

  • 如果在模板项或触发器中使用用户宏,考虑将这些宏也添加到模板中(即使它们是全局定义的);这样,文本类型的宏在将模板导出为XML并导入到另一个系统后将按预期工作(秘密宏值不会被导出)
  • 如果在触发器表达式中使用用户宏,这些宏仅在引用参数或常量时解析;如果引用主机、项键、函数、运算符或另一个触发器表达式,它们将解析(触发器表达式中不能使用秘密宏)
  • 如果在具有低级别发现规则和主机原型的主机上使用用户宏,发现的主机将继承该主机上定义的所有用户宏

示例

示例 1

在“SSH daemon 状态”项键中使用主机级宏:net.tcp.service[ssh,,{$SSH_PORT}]

此项可以分配给多个主机,前提是{$SSH_PORT} 在这些主机上定义。

示例 2

在“CPU负载太高”触发器中使用主机级宏:last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}

这样的触发器将在模板上创建,而不是在个别主机。

如果要使用值的数量作为函数参数(例如,max(/host/key,#3)),在宏定义中包含如下哈希标记: SOME_PERIOD => #3

示例 3

在“CPU负载太高”触发器中使用两个宏:min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}

注意宏可以作为触发函数的参数,在这个示例函数min()

示例 4

将agent不可用条件与监控项更新同步间隔:

  • 定义 {$INTERVAL} 宏并在监控项更新间隔中使用它;
  • 使用 {$INTERVAL} 作为agent不可用触发器的参数:

nodata(/ca_001/agent.ping,{$INTERVAL})=1

示例 5

集中配置工作时间:

  • 创建一个全局 {$WORKING_HOURS} 宏,等于 1-5,09:00-18:00
  • AdministrationGeneralWorking time 字段中使用它 图形界面
  • UserUsers ,用户的_媒体_ 页签中的_当激活_ 字段使用;
  • 使用它在工作时间设置更频繁的监控项轮询:

  • 时间段动作条件下使用;
  • AdministrationGeneralMacros 中调整工作时间, 如果需要的话。
示例 6

使用主机原型宏为发现的主机配置监控项:

  • Generic SNMPv2 模板分配给主机原型;
  • Generic SNMPv2SNMP OID 字段中使用 {$SNMPVALUE} 模板项。

用户宏语境

请参阅 带语境的用户宏