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 [2017/09/04 07:22]
martins-v {TRIGGER.HOSTGROUP.NAME} is not supported in map labels
manual:appendix:macros:supported_by_location [2020/07/13 08:34]
martins-v HOST.NAME not supported in autoregistration actions (ZBX-18049)
Line 6: Line 6:
  
   * **X** means "​supported"​ in that location   * **X** means "​supported"​ in that location
-  * The numbered macro syntax of {MACRO**<​1-9>​**} is used to reference hosts in the order in which they appear in a trigger expression. Thus, macros like {HOST.IP1}, {HOST.IP2}, {HOST.IP3} will expand to the IP of the first, second and third host in the trigger expression, providing the expression contains those hosts. Additionally {HOST.HOST**<​1-9>​**} is supported within {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.+  * The numbered macro syntax of {MACRO**<​1-9>​**} is used to reference hosts in the order in which they appear in a trigger expression. Thus, macros like {HOST.IP1}, {HOST.IP2}, {HOST.IP3} will expand to the IP of the first, second and third host in the trigger expression, providing the expression contains those hosts. Additionally {HOST.HOST**<​1-9>​**} is supported within {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.
  
 |                                                                       URL field of dynamic URL **screen** element|||||||||||||||||||▼^ ​ ▼DESCRIPTION▼ ​ | |                                                                       URL field of dynamic URL **screen** element|||||||||||||||||||▼^ ​ ▼DESCRIPTION▼ ​ |
Line 62: Line 62:
 |{HOST.IP<​1-9>​} ​                        | X |   | X | X | X | X | X | X<​sup>​**[[supported_by_location#​footnotes|2]]**</​sup>​| X |   ​| ​  | X |   | X | X<​sup>​**[[supported_by_location#​footnotes|5]]**</​sup>​| X |   | X<​sup>​**[[supported_by_location#​footnotes|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​footnotes|8]]**</​sup>​ |//Host IP address// <​sup>​**[[supported_by_location#​footnotes|3]]**</​sup>​. Supported since 2.0.0.\\ ''​{IPADDRESS<​1-9>​}''​ is deprecated.| |{HOST.IP<​1-9>​} ​                        | X |   | X | X | X | X | X | X<​sup>​**[[supported_by_location#​footnotes|2]]**</​sup>​| X |   ​| ​  | X |   | X | X<​sup>​**[[supported_by_location#​footnotes|5]]**</​sup>​| X |   | X<​sup>​**[[supported_by_location#​footnotes|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​footnotes|8]]**</​sup>​ |//Host IP address// <​sup>​**[[supported_by_location#​footnotes|3]]**</​sup>​. Supported since 2.0.0.\\ ''​{IPADDRESS<​1-9>​}''​ is deprecated.|
 |{HOST.METADATA} ​                       |   ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Host metadata.//​\\ Used only for active agent auto-registration. Supported since 2.2.0.| |{HOST.METADATA} ​                       |   ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Host metadata.//​\\ Used only for active agent auto-registration. Supported since 2.2.0.|
-|{HOST.NAME<​1-9>​} ​                      | X |   ​| ​| X | X | X | X | X | X |   ​| ​  | X |   | X | X<​sup>​**[[supported_by_location#​footnotes|5]]**</​sup>​| X |   | X<​sup>​**[[supported_by_location#​footnotes|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​footnotes|8]]**</​sup>​ |//Visible host name.//\\ Supported since 2.0.0.|+|{HOST.NAME<​1-9>​} ​                      | X |   ​| ​  ​| X | X | X | X | X | X |   ​| ​  | X |   | X | X<​sup>​**[[supported_by_location#​footnotes|5]]**</​sup>​| X |   | X<​sup>​**[[supported_by_location#​footnotes|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​footnotes|8]]**</​sup>​ |//Visible host name.//\\ Supported since 2.0.0.|
 |{HOST.PORT<​1-9>​} ​                      | X |   | X | X | X | X |   ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Host (agent) port// <​sup>​**[[supported_by_location#​footnotes|3]]**</​sup>​.\\ Supported in auto-registration since 2.0.0.\\ Supported in trigger names, trigger descriptions,​ internal and trigger-based notifications since 2.2.2. ​ | |{HOST.PORT<​1-9>​} ​                      | X |   | X | X | X | X |   ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Host (agent) port// <​sup>​**[[supported_by_location#​footnotes|3]]**</​sup>​.\\ Supported in auto-registration since 2.0.0.\\ Supported in trigger names, trigger descriptions,​ internal and trigger-based notifications since 2.2.2. ​ |
 |{HOSTGROUP.ID} ​                        ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Host group ID.//| |{HOSTGROUP.ID} ​                        ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Host group ID.//|
Line 143: Line 143:
 |{ITEM.KEY<​1-9>​} ​                       | X |   ​| ​  | X | X | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Key of the Nth item in the trigger expression that caused a notification.//​ Supported since 2.0.0.\\ ''​{TRIGGER.KEY}''​ is deprecated.| |{ITEM.KEY<​1-9>​} ​                       | X |   ​| ​  | X | X | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​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<​1-9>​} ​                  | X |   ​| ​  | X | X | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​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<​1-9>​} ​                  | X |   ​| ​  | X | X | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​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<​1-9>​} ​                 | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​The latest value of the Nth item in the trigger expression that caused a notification.//​ Supported since 1.4.3. It is alias to ''​{{HOST.HOST}:​{ITEM.KEY}.last()}''​|+|{ITEM.LASTVALUE<​1-9>​} ​                 | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​The latest value of the Nth item in the trigger expression that caused a notification.//​ Supported since 1.4.3. It is alias to ''​%%{{%%HOST.HOST}:​{ITEM.KEY}.last()}''​|
 |{ITEM.LOG.AGE<​1-9>​} ​                   | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Age of the log item event.// ​ | |{ITEM.LOG.AGE<​1-9>​} ​                   | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Age of the log item event.// ​ |
 |{ITEM.LOG.DATE<​1-9>​} ​                  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Date of the log item event.// ​  | |{ITEM.LOG.DATE<​1-9>​} ​                  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Date of the log item event.// ​  |
Line 210: Line 210:
 <​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 229: Line 229:
     * Interface port     * Interface port
  
-  * Items+  * Items and item prototypes
     * SNMPv3 context name     * SNMPv3 context name
     * SNMPv3 security name     * SNMPv3 security name