Zabbix Documentation 4.0

3.04.04.24.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.4Guidelines

User Tools

Site Tools


manual:config: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 [2015/06/11 09:04]
martins-v overview section about macros expanded; macros as part of item key parameter
manual:config:macros [2017/10/06 14:12] (current)
Line 1: Line 1:
-===== - #8 Macros =====+===== 10 Macros =====
  
 === Overview === === Overview ===
  
-Zabbix supports a number of macros which may be used in various situations. Macros are variables, identified by a **{MACRO}** syntax, and resolve to a specific value depending on the context.+Zabbix supports a number of macros which may be used in various situations. Macros are variables, identified by a specific syntax: 
 + 
 +  ​{MACRO} ​ 
 +   
 +Macros ​resolve to a specific value depending on the context.
  
 Effective use of macros allows to save time and make Zabbix configuration more transparent. ​ Effective use of macros allows to save time and make Zabbix configuration more transparent. ​
Line 9: Line 13:
 In one of typical uses, a macro may be used in a template. Thus a trigger on a template may be named "​Processor load is too high on {HOST.NAME}"​. When the template is applied to the host, such as Zabbix server, the name will resolve to "​Processor load is too high on Zabbix server"​ when the trigger is displayed in the Monitoring section. In one of typical uses, a macro may be used in a template. Thus a trigger on a template may be named "​Processor load is too high on {HOST.NAME}"​. When the template is applied to the host, such as Zabbix server, the name will resolve to "​Processor load is too high on Zabbix server"​ when the trigger is displayed in the Monitoring section.
  
-Macros may be used in item key parameters. A macro may be used for only a part of the parameter, for example ''​item.key[server_{HOST.HOST}_local]''​. ​It is important to double-qoute the whole parameter ​if the macro part may resolve to ambiguous special symbols.+Macros may be used in item key parameters. A macro may be used for only a part of the parameter, for example ''​item.key[server_{HOST.HOST}_local]''​. ​Double-quoting ​the parameter ​is not necessary as Zabbix will take care of any ambiguous special symbols, if present in the resolved macro.
  
-See a full list of [[manual:appendix:​macros:​supported_by_location|supported macros]] by location.+See also:
  
-You can also configure ​your own [[manual:​config:​macros:​usermacros|user macros]].+  * full list [[:​manual/​appendix/​macros/​supported_by_location|of supported macros]] 
 +  * macro [[:​manual/​config/​macros/​macro_functions|functions]] 
 +  * how to configure [[manual:​config:​macros:​usermacros|user macros]]