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
manual:appendix:macros:supported_by_location [2021/01/27 20:27]
127.0.0.1 external edit
manual:appendix:macros:supported_by_location [2021/03/15 13:34] (current)
marinagen [ZBX-18875] Correcting macro descriptions
Line 140: Line 140:
 |{ITEM.KEY} ​                       |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications\\ -> Script type item, item prototype and discovery rule parameter names and values <​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> HTTP agent type item, item prototype and discovery rule fields: \\ URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file.  |//Key of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.KEY[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]].\\ \\ ''​{TRIGGER.KEY}''​ is deprecated.| |{ITEM.KEY} ​                       |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications\\ -> Script type item, item prototype and discovery rule parameter names and values <​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ -> HTTP agent type item, item prototype and discovery rule fields: \\ URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file.  |//Key of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.KEY[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]].\\ \\ ''​{TRIGGER.KEY}''​ is deprecated.|
 |{ITEM.KEY.ORIG} ​                  ​|->​ Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications\\ -> Script type item, item prototype and discovery rule parameter names and values <​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ ​ -> HTTP agent type item, item prototype and discovery rule fields: \\ URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file <​sup>​[[supported_by_location#​footnotes|8]]</​sup>​. |//Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.KEY.ORIG[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ | |{ITEM.KEY.ORIG} ​                  ​|->​ Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications\\ -> Script type item, item prototype and discovery rule parameter names and values <​sup>​[[supported_by_location#​footnotes|8]]</​sup>​\\ ​ -> HTTP agent type item, item prototype and discovery rule fields: \\ URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file <​sup>​[[supported_by_location#​footnotes|8]]</​sup>​. |//Original key (with macros not expanded) of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.KEY.ORIG[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |
-|{ITEM.LASTVALUE} ​                 |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Trigger names, event names, operational data and descriptions\\ -> Tag names and values\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|7]]</​sup> ​ |//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 //Max history display period// time ago (set in the [[:​manual/​web_interface/​frontend_sections/​administration/​general#​gui|Administration->​General]] menu section).\\ Note that since 4.0, when used in the problem name, it will not resolve to the latest item value when viewing problem events, instead it will keep the item value from the time of problem happening.\\ 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.\\ \\ This macro may be used with a numeric index e.g. {ITEM.LASTVALUE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |+|{ITEM.LASTVALUE} ​                 |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Trigger names, event names, operational data and descriptions\\ -> Tag names and values\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|7]]</​sup> ​ |//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 //Max history display period// time ago (set in the [[:​manual/​web_interface/​frontend_sections/​administration/​general#​gui|Administration->​General]] menu section).\\ Note that since 4.0, when used in the problem name, it will not resolve to the latest item value when viewing problem events, instead it will keep the item value from the time of problem happening.\\ 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.\\ \\ This macro may be used with a numeric index e.g. {ITEM.LASTVALUE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. item in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |
 |{ITEM.LOG.AGE} ​                   |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Trigger names, operational data and descriptions\\ -> Trigger URLs\\ -> Event tags and values ​ |//Age of the log item event//, with precision down to a second.\\ \\ This macro may be used with a numeric index e.g. {ITEM.LOG.AGE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ | |{ITEM.LOG.AGE} ​                   |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Trigger names, operational data and descriptions\\ -> Trigger URLs\\ -> Event tags and values ​ |//Age of the log item event//, with precision down to a second.\\ \\ This macro may be used with a numeric index e.g. {ITEM.LOG.AGE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |
 |{ITEM.LOG.DATE} ​                  ​|->​ Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Trigger names, operational data and descriptions\\ -> Trigger URLs\\ -> Event tags and values ​ |//Date of the log item event.//\\ \\ This macro may be used with a numeric index e.g. {ITEM.LOG.DATE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ | |{ITEM.LOG.DATE} ​                  ​|->​ Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Trigger names, operational data and descriptions\\ -> Trigger URLs\\ -> Event tags and values ​ |//Date of the log item event.//\\ \\ This macro may be used with a numeric index e.g. {ITEM.LOG.DATE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |
Line 151: Line 151:
 |{ITEM.NAME.ORIG} ​                 |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications ​ |//Original name (i.e. without macros resolved) of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.NAME.ORIG[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ | |{ITEM.NAME.ORIG} ​                 |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications ​ |//Original name (i.e. without macros resolved) of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.NAME.ORIG[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |
 |{ITEM.STATE} ​                     |-> Item-based internal notifications ​ |//The latest state of the Nth item in the trigger expression that caused a notification.//​ Possible values: **Not supported** and **Normal**.\\ \\ This macro may be used with a numeric index e.g. {ITEM.STATE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ | |{ITEM.STATE} ​                     |-> Item-based internal notifications ​ |//The latest state of the Nth item in the trigger expression that caused a notification.//​ Possible values: **Not supported** and **Normal**.\\ \\ This macro may be used with a numeric index e.g. {ITEM.STATE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |
-|{ITEM.VALUE} ​                     |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Trigger names, event names, operational data and descriptions\\ -> Tag names and values\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|7]]</​sup> ​ |Resolved to either:\\ 1) the historical (at-the-time-of-event) value of the Nth item in the trigger expression, if used in the context of trigger status change, for example, when displaying events or sending notifications.\\ 2) the latest value of the Nth item in the trigger expression, if used without the context of trigger status change, for example, when displaying a list of triggers in a pop-up selection window. In this case works the same as {ITEM.LASTVALUE}\\ In the first case it will resolve to *UNKNOWN* if the history value has already been deleted or has never been stored.\\ In the second case, and in the frontend only, it will resolve to *UNKNOWN* if the latest history value has been collected more than the //Max history display period// time ago (set in the [[:​manual/​web_interface/​frontend_sections/​administration/​general#​gui|Administration->​General]] menu section). \\ Supported since 1.4.3.\\ \\ [[:​manual/​config/​macros/​macro_functions|Customizing]] the macro value is supported for this macro, starting with Zabbix 3.2.0.\\ \\ This macro may be used with a numeric index e.g. {ITEM.VALUE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. host in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |+|{ITEM.VALUE} ​                     |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Trigger names, event names, operational data and descriptions\\ -> Tag names and values\\ -> Trigger URLs<​sup>​[[supported_by_location#​footnotes|7]]</​sup> ​ |Resolved to either:\\ 1) the historical (at-the-time-of-event) value of the Nth item in the trigger expression, if used in the context of trigger status change, for example, when displaying events or sending notifications.\\ 2) the latest value of the Nth item in the trigger expression, if used without the context of trigger status change, for example, when displaying a list of triggers in a pop-up selection window. In this case works the same as {ITEM.LASTVALUE}\\ In the first case it will resolve to *UNKNOWN* if the history value has already been deleted or has never been stored.\\ In the second case, and in the frontend only, it will resolve to *UNKNOWN* if the latest history value has been collected more than the //Max history display period// time ago (set in the [[:​manual/​web_interface/​frontend_sections/​administration/​general#​gui|Administration->​General]] menu section). \\ Supported since 1.4.3.\\ \\ [[:​manual/​config/​macros/​macro_functions|Customizing]] the macro value is supported for this macro, starting with Zabbix 3.2.0.\\ \\ This macro may be used with a numeric index e.g. {ITEM.VALUE[[supported_by_location#​indexed_macros|<​1-9>​]]} to point to the first, second, third, etc. item in a trigger expression. See [[supported_by_location#​indexed_macros|indexed macros]]. ​ |
 |{LLDRULE.DESCRIPTION} ​                 |-> LLD-rule based internal notifications ​ |//​Description of the low-level discovery rule which caused a notification.//​\\ Supported since 2.2.0. ​ | |{LLDRULE.DESCRIPTION} ​                 |-> LLD-rule based internal notifications ​ |//​Description of the low-level discovery rule which caused a notification.//​\\ Supported since 2.2.0. ​ |
 |{LLDRULE.DESCRIPTION.ORIG} ​                 |-> LLD-rule based internal notifications ​ |//​Description (with macros unresolved) of the low-level discovery rule which caused a notification.//​\\ Supported since 5.2.0. ​ | |{LLDRULE.DESCRIPTION.ORIG} ​                 |-> LLD-rule based internal notifications ​ |//​Description (with macros unresolved) of the low-level discovery rule which caused a notification.//​\\ Supported since 5.2.0. ​ |