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
manual:appendix:macros:supported_by_location [2018/10/08 05:37]
martins-v updating title
manual:appendix:macros:supported_by_location [2019/01/18 08:32]
martins-v fixing some formatting issues
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>​