4 低级别发现宏

概述

有一种在 低级别自动发现 函数中使用的宏:

{#MACRO}

它是一个在低级别发现规则中使用的宏，其返回文件系统名称、网络接口和SNMP OIDs等的真实值。

这些宏可以用于创建监控项、触发器和图形原型。然后，当发现真实的文件系统、网络接口等时，这些宏将被替换为真实的值，并且以这些值来创建真实的监控项、触发器和图形。

这些宏还用于在虚拟机 自动发现 中创建主机和主机组原型。

一些低级别发现宏在 Zabbix 中是已经预先内置了的，例如 {#FSNAME}、{#FSTYPE}、{#IFNAME}、{#SNMPINDEX}、{#SNMPVALUE} 这些宏。但是，在创建 自定义 低级别发现规则的时候，遵守这些宏名称并不是强制性的。所以，你可以使用任何其他的低级别发现宏名称并引用该名称。

可支持的位置

低级别发现宏可以用在：

• 在低级别规则过滤器中

• 用于监控项原型中：

  • names

  • key parameters

  • units

  • update intervals

  • history storage periods

  • trend storage periods

  • SNMP OIDs

  • IPMI sensor fields

  • calculated item formulas

  • SSH and Telnet scripts

  • database monitoring SQL queries

  • JMX item endpoint fields

  • descriptions

  • 从Zabbix 4.0开始，也适用于:

    • item value preprocessing steps

    • HTTP agent URL field

    • HTTP agent HTTP query fields field

    • HTTP agent request body field

    • HTTP agent required status codes field

    • HTTP agent headers field key and value

    • HTTP agent HTTP authentication username field

    • HTTP agent HTTP authentication password field

    • HTTP agent HTTP proxy field

    • HTTP agent HTTP SSL certificate file field

    • HTTP agent HTTP SSL key file field

    • HTTP agent HTTP SSL key password field

    • HTTP agent HTTP timeout field

• 用于触发器原型中：

• names

• operational data

• expressions(仅用于常量和函数参数中)

• URLs

• descriptions

• event tag names and values

• 用于图形原型中：

• names

• 用于主机原型中：

• names

• visible names

• host group prototype names

• host macro value

• (详细查阅 完整列表)

在上述所有位置，低级别发现宏都可以在静态用户 宏上下文 中使用。

使用宏函数

宏函数支持低级别发现的宏（除了在低级别发现规则过滤器中），允许使用正则表达式提取宏值的特定部分。

比如，您可能希望从以下低级别发现宏中提取客户名称和接口编号，以便进行事件标记：

{#IFALIAS}=customername_1

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

注意, 在未加引号的监控项 键值参数 中不允许使用逗号, 因此，包含宏函数的参数必须用引号括起来。 反斜杠(\)字符用作于转义参数内的双引号。 例如:

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

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

从Zabbix 4.0开始，低级别发现宏就支持宏函数了。

脚注

1 在标记为单个宏的字段1中必须填满整个字段。字段中不支持多个宏或宏与文本的混合。