Zabbix Documentation 3.2

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

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:

  • for item prototypes in
    • names
    • key parameters
    • units
    • SNMP OIDs
    • IPMI sensor fields
    • calculated item formulas
    • SSH and Telnet scripts
    • database monitoring SQL queries
    • descriptions (supported since 2.2.0)
  • for trigger prototypes in
    • names
    • expressions (insofar as when referencing an item key prototype and as standalone constants)
    • URLs (supported since 3.0.0)
    • descriptions (supported since 2.2.0)
    • event tag names and values (except macro function parameters) (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.