Zabbix Documentation 3.2

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


manual:config:macros:lld_macros

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

manual:config:macros:lld_macros [2018/08/21 08:03]
manual:config:macros:lld_macros [2016/11/25 13:55] (current)
wiper [Supported locations]
Line 1: Line 1:
 +==== 3 Low-level discovery macros ====
 +
 +=== Overview ===
 +
 +There is a type of macro used within the [[manual:​discovery:​low_level_discovery|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 [[:​manual/​vm_monitoring#​host_prototypes|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 [[:​manual/​vm_monitoring/​discovery_fields|full list]])
 +
 +In all those places LLD macros can be used inside user [[:​manual/​config/​macros/​usermacros#​user_macro_context|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 [[manual:​discovery:​low_level_discovery#​creating_custom_lld_rules|custom]] low-level discovery rule. Then you may use any other LLD macro name and refer to that name.