Zabbix Documentation 3.4

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

manual:config:macros:lld_macros

3 Low-level discovery macros

Overview

There is a type of macro used within the low-level discovery function:

{#MACRO} 

It is a macro that is used in an LLD rule and returns real values of file system names, network interfaces and SNMP OIDs.

These macros can be used for creating item, trigger and graph prototypes. Then, when discovering real file systems, network interfaces etc., these macros are substituted with real values and are the basis for creating real items, triggers and graphs.

These macros are also used in creating host and host group prototypes in virtual machine discovery.

Supported locations

LLD macros can be used:

  • in the low-level discovery rule filter
  • for item prototypes in
    • names
    • key parameters
    • units
    • update intervals (supported since 3.4.0)
    • history storage periods (supported since 3.4.0)
    • trend storage periods (supported since 3.4.0)
    • SNMP OIDs
    • IPMI sensor fields
    • calculated item formulas
    • SSH and Telnet scripts
    • database monitoring SQL queries
    • JMX item endpoint fields
    • descriptions (supported since 2.2.0)
  • for trigger prototypes in
    • names
    • expression (only in constants and function parameters)
    • URLs (supported since 3.0.0)
    • descriptions (supported since 2.2.0)
    • event tag names and values (supported since 3.2.0)
  • for graph prototypes in
    • names
  • for host prototypes (supported since 2.2.0) in
    • names
    • visible names
    • host group prototype names
    • (see the full list)

In all those places LLD macros can be used inside user macro context.

Some low-level discovery macros come “pre-packaged” with the LLD function in Zabbix - {#FSNAME}, {#FSTYPE}, {#IFNAME}, {#SNMPINDEX}, {#SNMPVALUE}. However, adhering to these names is not compulsory when creating a custom low-level discovery rule. Then you may use any other LLD macro name and refer to that name.