Zabbix Documentation 5.0

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

Both sides previous revision Previous revision
Next revision
Previous revision
manual:config:macros:lld_macros [2020/02/05 15:21]
marinagen field names changed to singular
manual:config:macros:lld_macros [2020/06/10 08:40]
martins-v updating link target
Line 1: Line 1:
-==== Low-level discovery macros ====+==== Low-level discovery macros ====
  
 === Overview === === Overview ===
Line 7: Line 7:
   {#​MACRO} ​   {#​MACRO} ​
  
-It is a macro that is used in an LLD rule and returns real values of file system ​names, network ​interfaces, SNMP OIDs, etc.+It is a macro that is used in an LLD rule and returns real values of the file system ​name, network ​interface, SNMP OID, etc.
  
 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 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.
Line 22: Line 22:
   * for item prototypes in   * for item prototypes in
     * name     * name
-    * key parameter+    * key parameters
     * unit     * unit
-    * update interval +    * update interval<​sup>​[[lld_macros#​footnotes|1]]</​sup> ​ 
-    * history storage period +    * history storage period<​sup>​[[lld_macros#​footnotes|1]]</​sup> ​ 
-    * trend storage period +    * trend storage period<​sup>​[[lld_macros#​footnotes|1]]</​sup> ​ 
-    * item value preprocessing ​step+    * item value preprocessing ​steps
     * SNMP OID     * SNMP OID
     * IPMI sensor field     * IPMI sensor field
     * calculated item formula     * calculated item formula
-    * SSH and Telnet script+    * SSH script ​and Telnet script
     * database monitoring SQL query     * database monitoring SQL query
     * JMX item endpoint field     * JMX item endpoint field
Line 46: Line 46:
     * HTTP agent HTTP SSL key file field     * HTTP agent HTTP SSL key file field
     * HTTP agent HTTP SSL key password field     * HTTP agent HTTP SSL key password field
-    * HTTP agent HTTP timeout field+    * HTTP agent HTTP timeout<​sup>​[[lld_macros#​footnotes|1]]</​sup> ​field
   * for trigger prototypes in   * for trigger prototypes in
     * name     * name
Line 60: Line 60:
     * visible name     * visible name
     * host group prototype name     * host group prototype name
 +    * host macro value
     * (see the [[:​manual/​vm_monitoring/​discovery_fields|full list]])     * (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]].+In all those places LLD macros can be used inside ​static ​user [[manual:config:macros:​user_macros_context|macro context]].
  
 === Using macro functions === === Using macro functions ===
Line 75: Line 76:
  
 {{:​manual:​config:​macros:​lld_macro_function.png|}} {{:​manual:​config:​macros:​lld_macro_function.png|}}
 +
 +Note, that commas are not allowed in unquoted item [[:​manual/​config/​items/​item/​key#​key_parameters|key parameters]],​ so the parameter containing a macro function has to be quoted. The backslash (''​\''​) character should be used to escape double quotes inside the parameter. Example:
 +  net.if.in["​{{#​IFALIAS}.regsub(\"​(.*)_([0-9]+)\",​ \1)}",​bytes]
  
 For more information on macro function syntax, see: [[:​manual/​config/​macros/​macro_functions|Macro functions]] For more information on macro function syntax, see: [[:​manual/​config/​macros/​macro_functions|Macro functions]]
  
 Macro functions are supported in low-level discovery macros since Zabbix 4.0. Macro functions are supported in low-level discovery macros since Zabbix 4.0.
 +
 +== Footnotes ==
 +
 +<​sup>​**1**</​sup>​ In the fields marked with <​sup>​[[lld_macros#​footnotes|1]]</​sup>​ a single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.