Zabbix Documentation 3.4

3.04.04.24.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.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 [2017/05/29 13:23]
martins-v adding {ACK.MESSAGE} and {USER.FULLNAME}
manual:appendix:macros:supported_by_location [2019/01/18 08:31] (current)
martins-v fixing some formatting issues
Line 1: Line 1:
-==== 1 Macros supported by location ​====+==== 1 Supported macros ​====
  
 === Overview === === Overview ===
  
 The table contains a complete list of macros supported by Zabbix. The table contains a complete list of macros supported by Zabbix.
 +
 +<note tip>To see all macros supported in a location (for example, in "map URL"), you may paste the location name into the search box at the bottom of your browser window (accessible by pressing CTRL+F) and do a search for //​next//​.</​note>​
  
 ^Macro ​ ^Supported in  ^Description ​ | ^Macro ​ ^Supported in  ^Description ​ |
-|{ACK.MESSAGE} ​                         |-> Acknowledgement notifications ​ |//Acknowledgement ​message.//​\\ Supported since 3.4.0. ​ | +|{ACK.DATE} ​                            ​|->​ Acknowledgement notifications ​ |//Date of event acknowledgement.//​\\ Supported since 3.4.0. ​ | 
-|{ACTION.ID} ​                           |-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Numeric ID of the triggered action.//\\ Supported since 2.2.0. ​ | +|{ACK.MESSAGE} ​                         |-> Acknowledgement notifications ​ |//Event acknowledgement ​message.//\\ Supported since 3.4.0. ​ | 
-|{ACTION.NAME} ​                         |-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Name of the triggered action.//\\ Supported since 2.2.0. ​ |+|{ACK.TIME} ​                            ​|->​ Acknowledgement notifications ​ |//Time of event acknowledgement.//\\ Supported since 3.4.0. ​ | 
 +|{ACTION.ID} ​                           |-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Numeric ID of the triggered action.//\\ Supported since 2.2.0. ​ | 
 +|{ACTION.NAME} ​                         |-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Name of the triggered action.//\\ Supported since 2.2.0. ​ |
 |{ALERT.MESSAGE} ​                       |-> Alert script parameters ​ |//'​Default message'​ value from action configuration.//​\\ Supported since 3.0.0. ​ | |{ALERT.MESSAGE} ​                       |-> Alert script parameters ​ |//'​Default message'​ value from action configuration.//​\\ Supported since 3.0.0. ​ |
 |{ALERT.SENDTO} ​                        ​|->​ Alert script parameters ​ |//'​Send to' value from user media configuration.//​\\ Supported since 3.0.0. ​ | |{ALERT.SENDTO} ​                        ​|->​ Alert script parameters ​ |//'​Send to' value from user media configuration.//​\\ Supported since 3.0.0. ​ |
 |{ALERT.SUBJECT} ​                       |-> Alert script parameters ​ |//'​Default subject'​ value from action configuration.//​\\ Supported since 3.0.0. ​ | |{ALERT.SUBJECT} ​                       |-> Alert script parameters ​ |//'​Default subject'​ value from action configuration.//​\\ Supported since 3.0.0. ​ |
-|{DATE} ​                                ​|-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Current date in yyyy.mm.dd. format.// ​ |+|{DATE} ​                                ​|-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Current date in yyyy.mm.dd. format.// ​ |
 |{DISCOVERY.DEVICE.IPADDRESS} ​          ​|->​ Discovery notifications ​ |//IP address of the discovered device.//\\ Available always, does not depend on host being added. ​ | |{DISCOVERY.DEVICE.IPADDRESS} ​          ​|->​ Discovery notifications ​ |//IP address of the discovered device.//\\ Available always, does not depend on host being added. ​ |
 |{DISCOVERY.DEVICE.DNS} ​                ​|->​ Discovery notifications ​ |//DNS name of the discovered device.//\\ Available always, does not depend on host being added. ​ | |{DISCOVERY.DEVICE.DNS} ​                ​|->​ Discovery notifications ​ |//DNS name of the discovered device.//\\ Available always, does not depend on host being added. ​ |
Line 25: Line 29:
 |{EVENT.ACK.HISTORY} ​                   |-> Trigger-based notifications and commands ​ |//Log of acknowledgements on the problem.// ​ | |{EVENT.ACK.HISTORY} ​                   |-> Trigger-based notifications and commands ​ |//Log of acknowledgements on the problem.// ​ |
 |{EVENT.ACK.STATUS} ​                    ​|->​ Trigger-based notifications and commands ​ |//​Acknowledgement status of the event (Yes/​No)//​. ​ | |{EVENT.ACK.STATUS} ​                    ​|->​ Trigger-based notifications and commands ​ |//​Acknowledgement status of the event (Yes/​No)//​. ​ |
-|{EVENT.AGE} ​                           |-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Age of the event that triggered an action.//\\ Useful in escalated messages. ​ | +|{EVENT.AGE} ​                           |-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Age of the event that triggered an action.//\\ Useful in escalated messages. ​ | 
-|{EVENT.DATE} ​                          ​|-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Date of the event that triggered an action.// ​ | +|{EVENT.DATE} ​                          ​|-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Date of the event that triggered an action.// ​ | 
-|{EVENT.ID} ​                            ​|-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Numeric ID of the event that triggered an action.// ​ | +|{EVENT.ID} ​                            ​|-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Numeric ID of the event that triggered an action.// ​ | 
-|{EVENT.RECOVERY.DATE} ​                 |-> Trigger-based notifications ​and commands\\ -> Internal notifications ​ |//Date of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only.\\ Supported since 2.2.0. ​ | +|{EVENT.RECOVERY.DATE} ​                 |-> Trigger-based notifications \\ -> Internal notifications ​ |//Date of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only.\\ Supported since 2.2.0. ​ | 
-|{EVENT.RECOVERY.ID} ​                   |-> Trigger-based notifications ​and commands\\ -> Internal notifications ​ |//Numeric ID of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only. Supported since 2.2.0. ​ | +|{EVENT.RECOVERY.ID} ​                   |-> Trigger-based notifications \\ -> Internal notifications ​ |//Numeric ID of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only. Supported since 2.2.0. ​ | 
-|{EVENT.RECOVERY.STATUS} ​               |-> Trigger-based notifications ​and commands\\ -> Internal notifications ​ |//Verbal value of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only. Supported since 2.2.0. ​ |+|{EVENT.RECOVERY.STATUS} ​               |-> Trigger-based notifications \\ -> Internal notifications ​ |//Verbal value of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only. Supported since 2.2.0. ​ |
 |{EVENT.RECOVERY.TAGS} ​                          ​|->​ Trigger-based notifications and commands ​ |//A comma separated list of recovery event tags.// Expanded to an empty string if no tags exist.\\ Supported since 3.2.0. ​ | |{EVENT.RECOVERY.TAGS} ​                          ​|->​ Trigger-based notifications and commands ​ |//A comma separated list of recovery event tags.// Expanded to an empty string if no tags exist.\\ Supported since 3.2.0. ​ |
-|{EVENT.RECOVERY.TIME} ​                 |-> Trigger-based notifications ​and commands\\ -> Internal notifications ​ |//Time of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only.\\ Supported since 2.2.0. ​ | +|{EVENT.RECOVERY.TIME} ​                 |-> Trigger-based notifications\\ -> Internal notifications ​ |//Time of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only.\\ Supported since 2.2.0. ​ | 
-|{EVENT.RECOVERY.VALUE} ​                ​|->​ Trigger-based notifications ​and commands\\ -> Internal notifications ​ |//Numeric value of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only.\\ Supported since 2.2.0. ​ | +|{EVENT.RECOVERY.VALUE} ​                ​|->​ Trigger-based notifications\\ -> Internal notifications ​ |//Numeric value of the recovery event.//\\ Can be used in [[manual:​config:​notifications:​action#​configuring_an_action|recovery]] messages only.\\ Supported since 2.2.0. ​ | 
-|{EVENT.STATUS} ​                        ​|-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Verbal value of the event that triggered an action.//\\ Supported since 2.2.0. ​ |+|{EVENT.STATUS} ​                        ​|-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Verbal value of the event that triggered an action.//\\ Supported since 2.2.0. ​ |
 |{EVENT.TAGS} ​                          ​|->​ Trigger-based notifications and commands ​ |//A comma separated list of event tags.// Expanded to an empty string if no tags exist.\\ Supported since 3.2.0. ​ | |{EVENT.TAGS} ​                          ​|->​ Trigger-based notifications and commands ​ |//A comma separated list of event tags.// Expanded to an empty string if no tags exist.\\ Supported since 3.2.0. ​ |
-|{EVENT.TIME} ​                          ​|-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Time of the event that triggered an action.// ​ | +|{EVENT.TIME} ​                          ​|-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Time of the event that triggered an action.// ​ | 
-|{EVENT.VALUE} ​                         |-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Numeric value of the event that triggered an action.//\\ Supported since 2.2.0. ​ | +|{EVENT.VALUE} ​                         |-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Numeric value of the event that triggered an action ​(1 for problem, 0 for recovering).//\\ Supported since 2.2.0. ​ | 
-|{HOST.CONN[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                      ​|->​ Trigger-based notifications and commands\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Item key parameters<​sup>​[[supported_by_location#​footnotes|2]]</​sup>​\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//Host IP address or DNS name, depending on host settings//<​sup>​[[supported_by_location#​footnotes|3]]</​sup>​.\\ Supported in trigger names since 2.0.0. ​ | +|{HOST.CONN[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                      ​|->​ Trigger-based notifications and commands\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Item key parameters<​sup>​[[supported_by_location#​footnotes|2]]</​sup>​\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> JMX item endpoint field\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL dashboard widget/screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//Host IP address or DNS name, depending on host settings//<​sup>​[[supported_by_location#​footnotes|3]]</​sup>​.\\ Supported in trigger names since 2.0.0. ​ | 
 |{HOST.DESCRIPTION[[supported_by_location#​indexed_macros|<​1-9>​]]} ​               |-> Trigger-based notifications and commands\\ -> Internal notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Host description.//​\\ Supported since 2.4.0. ​ | |{HOST.DESCRIPTION[[supported_by_location#​indexed_macros|<​1-9>​]]} ​               |-> Trigger-based notifications and commands\\ -> Internal notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Host description.//​\\ Supported since 2.4.0. ​ |
-|{HOST.DNS[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                       |-> Trigger-based notifications and commands\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Item key parameters<​sup>​[[supported_by_location#​footnotes|2]]</​sup>​\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//Host DNS name//<​sup>​[[supported_by_location#​footnotes|3]]</​sup>​.\\ Supported in trigger names since 2.0.0. ​ | +|{HOST.DNS[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                       |-> Trigger-based notifications and commands\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Item key parameters<​sup>​[[supported_by_location#​footnotes|2]]</​sup>​\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> JMX item endpoint field\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL dashboard widget/screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//Host DNS name//<​sup>​[[supported_by_location#​footnotes|3]]</​sup>​.\\ Supported in trigger names since 2.0.0. ​ | 
-|{HOST.HOST[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                      ​|->​ Trigger-based notifications and commands\\ -> Auto registration notifications\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Item key parameters\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs <​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//Host name.//\\ ''​{HOSTNAME<​1-9>​}''​ is deprecated. ​ | +|{HOST.HOST[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                      ​|->​ Trigger-based notifications and commands\\ -> Auto registration notifications\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Item key parameters\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> JMX item endpoint field\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL dashboard widget/screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs <​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//Host name.//\\ ''​{HOSTNAME<​1-9>​}''​ is deprecated. ​ | 
-|{HOST.ID[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                        ​|->​ Map URLs\\ -> URL field of dynamic URL screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//Host ID.//  | +|{HOST.ID[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                        ​|->​ Map URLs\\ -> URL field of dynamic URL dashboard widget/screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//Host ID.//  | 
-|{HOST.IP[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                        ​|->​ Trigger-based notifications and commands\\ -> Auto registration notifications\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Item key parameters<​sup>​[[supported_by_location#​footnotes|2]]</​sup>​\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​  ​|//​Host IP address//<​sup>​[[supported_by_location#​footnotes|3]]</​sup>​.\\ Supported since 2.0.0. ''​{IPADDRESS<​1-9>​}''​ is deprecated. ​ |+|{HOST.IP[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                        ​|->​ Trigger-based notifications and commands\\ -> Auto registration notifications\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Item key parameters<​sup>​[[supported_by_location#​footnotes|2]]</​sup>​\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> JMX item endpoint field\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL dashboard widget/screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​  ​|//​Host IP address//<​sup>​[[supported_by_location#​footnotes|3]]</​sup>​.\\ Supported since 2.0.0. ''​{IPADDRESS<​1-9>​}''​ is deprecated. ​ |
 |{HOST.METADATA} ​                       |-> Auto registration notifications ​ |//Host metadata.//​\\ Used only for active agent auto-registration. Supported since 2.2.0. ​ | |{HOST.METADATA} ​                       |-> Auto registration notifications ​ |//Host metadata.//​\\ Used only for active agent auto-registration. Supported since 2.2.0. ​ |
-|{HOST.NAME[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                      ​|->​ Trigger-based notifications and commands\\ -> Auto registration notifications\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Item key parameters\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​  ​|//​Visible host name.//\\ Supported since 2.0.0. ​ | +|{HOST.NAME[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                      ​|->​ Trigger-based notifications and commands\\ -> Auto registration notifications\\ -> Internal notifications\\ -> Global scripts (including confirmation text)\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​\\ -> Item key parameters\\ -> Host interface IP/DNS\\ -> Database monitoring additional parameters<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> SSH and Telnet scripts<​sup>​[[supported_by_location#​footnotes|5]]</​sup>​\\ -> Web monitoring<​sup>​[[supported_by_location#​footnotes|6]]</​sup>​\\ -> Low-level discovery rule filter regular expressions<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> URL field of dynamic URL dashboard widget/screen element<​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​  ​|//​Visible host name.//\\ Supported since 2.0.0. ​ | 
-|{HOST.PORT[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                      ​|->​ Trigger-based notifications and commands\\ -> Auto registration notifications\\ -> Internal notifications\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> Event tags and values ​ |//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[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                      ​|->​ Trigger-based notifications and commands\\ -> Auto registration notifications\\ -> Internal notifications\\ -> Trigger names and descriptions\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|10]]</​sup>​\\ -> JMX item endpoint field\\ -> Event tags and values ​ |//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} ​                        ​|->​ Map URLs  |//Host group ID.//  | |{HOSTGROUP.ID} ​                        ​|->​ Map URLs  |//Host group ID.//  |
 |{INVENTORY.ALIAS[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                ​|->​ Trigger-based notifications\\ -> Internal notifications ​ |//Alias field in host inventory.// ​ | |{INVENTORY.ALIAS[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                ​|->​ Trigger-based notifications\\ -> Internal notifications ​ |//Alias field in host inventory.// ​ |
Line 122: Line 126:
 |{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 143: Line 147:
 |{MAP.ID} ​                              ​|->​ Map URLs  |//Network map ID.//| |{MAP.ID} ​                              ​|->​ Map URLs  |//Network map ID.//|
 |{MAP.NAME} ​                            ​|->​ Text field in map shapes ​ |//Network map name.//\\ Supported since 3.4.0. ​ | |{MAP.NAME} ​                            ​|->​ Text field in map shapes ​ |//Network map name.//\\ Supported since 3.4.0. ​ |
-|{PROXY.DESCRIPTION[[supported_by_location#​indexed_macros|<​1-9>​]]} ​              ​|-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Proxy description ​of the Nth item in the trigger expression ​that caused a notification.// Supported since 2.4.0.| +|{PROXY.DESCRIPTION[[supported_by_location#​indexed_macros|<​1-9>​]]} ​              ​|-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Description of the proxy//. Resolves to either:\\ 1) proxy of the Nth item in the trigger expression ​(in trigger-based notifications)You may use [[:manual/appendix/macros/​supported_by_location#​indexed_macros|indexed]] macros here.\\ 2) proxy, which executed discovery (in discovery notifications). Use {PROXY.DESCRIPTION} here, without indexing.\\ 3) proxy to which an active agent registered (in auto-registration notifications). Use {PROXY.DESCRIPTION} here, without indexing.\\ ​Supported since 2.4.0.| 
-|{PROXY.NAME[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                     |-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Proxy name of the Nth item in the trigger expression ​that caused a notification.// Supported since 1.8.4.| +|{PROXY.NAME[[supported_by_location#​indexed_macros|<​1-9>​]]} ​                     |-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Name of the proxy//. Resolves to either:\\ 1) proxy of the Nth item in the trigger expression ​(in trigger-based notifications)You may use [[:manual/appendix/macros/​supported_by_location#​indexed_macros|indexed]] macros here.\\ 2) proxy, which executed discovery (in discovery notifications). Use {PROXY.NAME} here, without indexing.\\ 3) proxy to which an active agent registered (in auto-registration notifications). Use {PROXY.NAME} here, without indexing.\\ ​Supported since 1.8.4.| 
-|{TIME} ​                                ​|-> ​Notifications ​and commands\\ -> Internal notifications ​ |//Current time in hh:​mm:​ss.//​|+|{TIME} ​                                ​|-> ​Trigger-based notifications ​and commands\\ ​-> Discovery notifications\\ ​ -> Auto-registration notifications\\  ​-> Internal notifications ​ |//Current time in hh:​mm:​ss.//​|
 |{TRIGGER.DESCRIPTION} ​                 |-> Trigger-based notifications\\ -> Trigger-based internal notifications ​ |//Trigger description.//​ Supported since 2.0.4.\\ Starting with 2.2.0, all macros supported in a trigger description will be expanded if ''​{TRIGGER.DESCRIPTION}''​ is used in notification text.\\ ''​{TRIGGER.COMMENT}''​ is deprecated.| |{TRIGGER.DESCRIPTION} ​                 |-> Trigger-based notifications\\ -> Trigger-based internal notifications ​ |//Trigger description.//​ Supported since 2.0.4.\\ Starting with 2.2.0, all macros supported in a trigger description will be expanded if ''​{TRIGGER.DESCRIPTION}''​ is used in notification text.\\ ''​{TRIGGER.COMMENT}''​ is deprecated.|
 |{TRIGGER.EVENTS.ACK} ​                  ​|->​ Trigger-based notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of acknowledged events for a map element in maps, or for the trigger which generated current event in notifications.//​ Supported since 1.8.3.| |{TRIGGER.EVENTS.ACK} ​                  ​|->​ Trigger-based notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of acknowledged events for a map element in maps, or for the trigger which generated current event in notifications.//​ Supported since 1.8.3.|
Line 151: Line 155:
 |{TRIGGER.EVENTS.PROBLEM.UNACK} ​        ​|->​ Trigger-based notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of unacknowledged PROBLEM events for all triggers disregarding their state.// Supported since 1.8.3.| |{TRIGGER.EVENTS.PROBLEM.UNACK} ​        ​|->​ Trigger-based notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of unacknowledged PROBLEM events for all triggers disregarding their state.// Supported since 1.8.3.|
 |{TRIGGER.EVENTS.UNACK} ​                ​|->​ Trigger-based notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of unacknowledged events for a map element in maps, or for the trigger which generated current event in notifications.//​ Supported in map element labels since 1.8.3.| |{TRIGGER.EVENTS.UNACK} ​                ​|->​ Trigger-based notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of unacknowledged events for a map element in maps, or for the trigger which generated current event in notifications.//​ Supported in map element labels since 1.8.3.|
-|{TRIGGER.HOSTGROUP.NAME} ​              ​|->​ Trigger-based notifications\\ -> Trigger-based internal notifications\\ -> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//A sorted (by SQL query), comma-space separated list of host groups in which the trigger is defined.// Supported since 2.0.6.|+|{TRIGGER.HOSTGROUP.NAME} ​              ​|->​ Trigger-based notifications\\ -> Trigger-based internal notifications ​ |//A sorted (by SQL query), comma-space separated list of host groups in which the trigger is defined.// Supported since 2.0.6.|
 |{TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK} ​  ​|->​ Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of acknowledged PROBLEM events for triggers in PROBLEM state.// Supported since 1.8.3.| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK} ​  ​|->​ Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of acknowledged PROBLEM events for triggers in PROBLEM state.// Supported since 1.8.3.|
 |{TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK} |-> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of unacknowledged PROBLEM events for triggers in PROBLEM state.// Supported since 1.8.3.| |{TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK} |-> Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of unacknowledged PROBLEM events for triggers in PROBLEM state.// Supported since 1.8.3.|
Line 170: Line 174:
 |{TRIGGERS.ACK} ​                        ​|->​ Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of acknowledged triggers for a map element, disregarding trigger state.//\\ A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.\\ Supported since 1.8.3.| |{TRIGGERS.ACK} ​                        ​|->​ Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of acknowledged triggers for a map element, disregarding trigger state.//\\ A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.\\ Supported since 1.8.3.|
 |{TRIGGERS.PROBLEM.ACK} ​                ​|->​ Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of acknowledged PROBLEM triggers for a map element.//​\\ A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.\\ Supported since 1.8.3.| |{TRIGGERS.PROBLEM.ACK} ​                ​|->​ Icon labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​ |//Number of acknowledged PROBLEM triggers for a map element.//​\\ A trigger is considered to be acknowledged if all of it's PROBLEM events are acknowledged.\\ Supported since 1.8.3.|
-|{USER.FULLNAME} ​                       |-> Acknowledgement notifications ​ |//Name and surname of the user.//\\ Supported since 3.4.0. ​ | +|{USER.FULLNAME} ​                       |-> Acknowledgement notifications ​ |//Name and surname of the user// ​who added event acknowledgement.\\ Supported since 3.4.0. ​ | 
-|{host:​key.func(param)} ​                ​|->​ Trigger-based notifications\\ -> Icon labels and link labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup>​ <​sup>​[[supported_by_location#​footnotes|4]]</​sup>​\\ -> Graph names<​sup>​[[supported_by_location#​footnotes|7]]</​sup>​\\ -> Trigger expressions<​sup>​[[supported_by_location#​footnotes|9]]</​sup> ​ |//Simple macros, as used in building trigger [[manual:​config:​triggers:​expression|expressions]]//​.|+|{host:​key.func(param)} ​                ​|->​ Trigger-based notifications\\ -> Icon/​shape ​labels in maps<​sup>​[[supported_by_location#​footnotes|1]]</​sup> ​<​sup>​[[supported_by_location#​footnotes|4]]</​sup>​\\ -> Link labels in maps<​sup>​[[supported_by_location#​footnotes|4]]</​sup>​\\ -> Graph names<​sup>​[[supported_by_location#​footnotes|7]]</​sup>​\\ -> Trigger expressions<​sup>​[[supported_by_location#​footnotes|9]]</​sup> ​ |//Simple macros, as used in building trigger [[manual:​config:​triggers:​expression|expressions]]//​.\\ \\ Supported for shape labels in maps since 3.4.2.  ​|
 |{$MACRO} ​                              ​|->​ See: [[:​manual/​appendix/​macros/​supported_by_location_user|User macros supported by location]] ​ |//​[[:​manual/​config/​macros/​usermacros|User-definable]] macros.// ​ | |{$MACRO} ​                              ​|->​ See: [[:​manual/​appendix/​macros/​supported_by_location_user|User macros supported by location]] ​ |//​[[:​manual/​config/​macros/​usermacros|User-definable]] macros.// ​ |
 |{#​MACRO} ​                              ​|->​ See: [[:​manual/​config/​macros/​lld_macros|Low-level discovery macros]] ​ |//​Low-level discovery macros.//\\ Supported since 2.0.0. ​ | |{#​MACRO} ​                              ​|->​ See: [[:​manual/​config/​macros/​lld_macros|Low-level discovery macros]] ​ |//​Low-level discovery macros.//\\ Supported since 2.0.0. ​ |
Line 191: Line 195:
 <​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 203: Line 207:
 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>​