5 低级别自动发现宏

概述

在 低级发现（LLD）功能中使用一种宏类型：

{#MACRO} 

这是在 LLD 规则中使用的一种宏，它会返回文件系统名称、网络接口、SNMP OID 等的实际值。

这些宏可用于创建实体原型（监控项、触发器、图形、主机和主机组原型）。 在发现实际的 文件系统、网络接口、虚拟机 等时，这些宏会被替换为实际值，并作为创建实际实体的基础。

Zabbix 中的 LLD 功能自带一些“预打包”的低级发现宏 - {#FSNAME}、{#FSTYPE}、{#IFNAME}、{#SNMPINDEX}、{#SNMPVALUE}。 不过，在创建 自定义 低级发现规则时，并不强制要求遵循这些名称。 此时，你可以使用任何其他 LLD 宏名称，并引用该名称。

支持的数据类型

在定义自定义发现规则时，JSON 对象中返回的用于 LLD 宏的属性值必须是以下基本类型之一：

• string
• number
• boolean

不支持数组、对象和 null 值。 任何引用此类值的 LLD 宏都将保持未展开状态，并在监控项预处理和创建过程中以字面形式显示（例如 '{#MY_MACRO}'）。

支持的位置

LLD 宏可用于：

• 低级别发现规则过滤器中
• 监控项原型的以下字段中
  • 名称
  • 键值参数
  • 单位
  • 更新间隔¹
  • 超时时间¹
  • 历史数据保存周期¹
  • 趋势数据保存周期¹
  • 监控项值预处理步骤
  • SNMP OID
  • IPMI 传感器字段
  • 计算/聚合监控项表达式中的以下位置：
    • 表达式常量和函数参数
    • 监控项键值参数
  • 聚合监控项过滤条件（主机组名称和标签名称）
  • SSH 脚本和 Telnet 脚本
  • 数据库监控 SQL 查询
  • JMX 监控项端点字段
  • 描述
  • HTTP agent URL 字段
  • HTTP agent HTTP 查询字段字段
  • HTTP agent 请求体字段
  • HTTP agent 所需状态码字段
  • HTTP agent 标头字段的键和值
  • HTTP agent HTTP 身份验证用户名字段
  • HTTP agent HTTP 身份验证密码字段
  • HTTP agent HTTP proxy 字段
  • HTTP agent HTTP SSL 证书文件字段
  • HTTP agent HTTP SSL 密钥文件字段
  • HTTP agent HTTP SSL 密钥密码字段
  • 标签
• 触发器原型的以下字段中
  • 名称
  • 运维数据
  • 表达式（仅在常量和函数参数中）
  • URL
  • 描述
  • 标签
• 图形原型的以下字段中
  • 名称
• 主机原型的以下字段中
  • 名称
  • 可见名称
  • 自定义接口字段：IP、DNS、端口、SNMP v1/v2 community、SNMP v3 context name、SNMP v3 security name、SNMP v3 authentication passphrase、SNMP v3 privacy passphrase
  • 主机组原型名称
  • 主机标签值
  • 主机宏值
  • （请参见完整列表）

在上述所有位置中，除低级别发现规则过滤器外，LLD 宏还可用于静态用户宏上下文中。

使用宏函数

宏函数支持低级别发现宏（低级别发现规则 filter 中除外），可用于通过正则表达式提取宏值的某一部分。

例如，您可能希望从以下 LLD 宏中提取客户名称和接口编号，以用于事件标签：

{#IFALIAS}=customername_1

为此，可以在触发器原型的事件标签值字段中，将 regsub 宏函数与该宏一起使用：

请注意，未加引号的监控项 key parameters 中不允许使用逗号，因此包含宏函数的参数必须加引号。 参数中的双引号应使用反斜杠（\）进行转义。 示例：

net.if.in["{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \1)}",bytes]

有关宏函数语法的更多信息，请参见：宏函数

自 Zabbix 4.0 起，低级别发现宏支持宏函数。

不带 key 参数的监控项原型

当不使用监控项 key 参数时，请将 LLD 宏放在 item key 参数括号 [...] 内，这样它会被视为参数，并在发现过程中进行替换：

v_[{#MACRO}]

脚注

¹ 在标有 ¹ 的字段中，单个宏必须填满整个字段。 字段中不支持多个宏，或宏与文本混合使用。