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:appendix:macros:supported_by_location

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
Last revision Both sides next revision
manual:appendix:macros:supported_by_location [2017/12/04 16:00]
natalja.cernohajeva Added info about {EVENT.RECOVERY.*} macros
manual:appendix:macros:supported_by_location [2019/01/18 08:32]
martins-v fixing some formatting issues
Line 1: Line 1:
-==== - #Macros supported by location ​====+==== 1 Supported macros ​====
  
 === Overview === === Overview ===
Line 121: Line 121:
 |{ITEM.KEY[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                       |-> Trigger-based notifications\\ -> Internal notifications ​ |//Key of the Nth item in the trigger expression that caused a notification.//​ Supported since 2.0.0.\\ ''​{TRIGGER.KEY}''​ is deprecated.| |{ITEM.KEY[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                       |-> Trigger-based notifications\\ -> Internal notifications ​ |//Key of the Nth item in the trigger expression that caused a notification.//​ Supported since 2.0.0.\\ ''​{TRIGGER.KEY}''​ is deprecated.|
 |{ITEM.KEY.ORIG[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                  ​|->​ Trigger-based notifications\\ -> Internal notifications ​ |//Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification.//​ Supported since 2.0.6.| |{ITEM.KEY.ORIG[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                  ​|->​ Trigger-based notifications\\ -> Internal notifications ​ |//Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification.//​ Supported since 2.0.6.|
-|{ITEM.LASTVALUE[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                 |-> Trigger-based notifications\\ -> Trigger names and descriptions\\ -> Event tags and values ​ |//The latest value of the Nth item in the trigger expression that caused a notification.//​\\ It will resolve to *UNKNOWN* in the frontend if the latest history value has been collected more than the //​ZBX_HISTORY_PERIOD//​ time ago (defined in [[:​manual/​web_interface/​definitions|defines.inc.php]]).\\ Supported since 1.4.3. It is alias to ''​{{HOST.HOST}:​{ITEM.KEY}.last()}''​\\ \\ [[:​manual/​config/​macros/​macro_functions|Customizing]] the macro value is supported for this macro; starting with Zabbix 3.2.0. ​ |+|{ITEM.LASTVALUE[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                 |-> Trigger-based notifications\\ -> Trigger names and descriptions\\ -> Event tags and values ​ |//The latest value of the Nth item in the trigger expression that caused a notification.//​\\ It will resolve to *UNKNOWN* in the frontend if the latest history value has been collected more than the //​ZBX_HISTORY_PERIOD//​ time ago (defined in [[:​manual/​web_interface/​definitions|defines.inc.php]]).\\ Supported since 1.4.3. It is alias to ''​%%{{%%HOST.HOST}:​{ITEM.KEY}.last()}''​\\ \\ [[:​manual/​config/​macros/​macro_functions|Customizing]] the macro value is supported for this macro; starting with Zabbix 3.2.0. ​ |
 |{ITEM.LOG.AGE[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                   |-> Trigger-based notifications ​ |//Age of the log item event.// ​ | |{ITEM.LOG.AGE[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                   |-> Trigger-based notifications ​ |//Age of the log item event.// ​ |
 |{ITEM.LOG.DATE[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                  ​|->​ Trigger-based notifications ​ |//Date of the log item event.// ​  | |{ITEM.LOG.DATE[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                  ​|->​ Trigger-based notifications ​ |//Date of the log item event.// ​  |
Line 188: Line 188:
 <​sup>​**7**</​sup>​ Supported since Zabbix 2.2.0. Only the **avg**, **last**, **max** and **min** functions, with seconds as parameter are supported within this macro in graph names. The {HOST.HOST<​1-9>​} macro can be used as host within the macro. For example: <​sup>​**7**</​sup>​ Supported since Zabbix 2.2.0. Only the **avg**, **last**, **max** and **min** functions, with seconds as parameter are supported within this macro in graph names. The {HOST.HOST<​1-9>​} macro can be used as host within the macro. For example:
    * {Cisco switch:​ifAlias[{#​SNMPINDEX}].last()}    * {Cisco switch:​ifAlias[{#​SNMPINDEX}].last()}
-   * {{HOST.HOST}:​ifAlias[{#​SNMPINDEX}].last()}+   ​* ​%%{{%%HOST.HOST}:​ifAlias[{#​SNMPINDEX}].last()}
  
 <​sup>​**8**</​sup>​ Supported since 2.4.0. <​sup>​**8**</​sup>​ Supported since 2.4.0.
Line 200: Line 200:
 The indexed macro syntax of {MACRO**<​1-9>​**} is limited to the context of **trigger expressions**. It can be used to reference hosts in the order in which they appear in the expression. Macros like {HOST.IP1}, {HOST.IP2}, {HOST.IP3} will resolve to the IP of the first, second and third host in the trigger expression (providing the trigger expression contains those hosts). The indexed macro syntax of {MACRO**<​1-9>​**} is limited to the context of **trigger expressions**. It can be used to reference hosts in the order in which they appear in the expression. Macros like {HOST.IP1}, {HOST.IP2}, {HOST.IP3} will resolve to the IP of the first, second and third host in the trigger expression (providing the trigger expression contains those hosts).
  
-Additionally the {HOST.HOST<​1-9>​} macro is also supported within the ''​{host:​key.func(param)}''​ macro in **graph names**. For example, ''​{{HOST.HOST2}:​key.func()}''​ in the graph name will refer to the host of the second item in the graph.+Additionally the {HOST.HOST<​1-9>​} macro is also supported within the ''​{host:​key.func(param)}''​ macro in **graph names**. For example, ''​%%{{%%HOST.HOST2}:​key.func()}''​ in the graph name will refer to the host of the second item in the graph.
  
 <note warning>​Use macros **without** index (i. e.{HOST.HOST},​ {HOST.IP}, etc) in all other contexts.</​note>​ <note warning>​Use macros **without** index (i. e.{HOST.HOST},​ {HOST.IP}, etc) in all other contexts.</​note>​