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 [2021/01/21 14:14]
marinagen [ZBXNEXT-6399] More macros supported for Script item and HTTP item
manual:appendix:macros:supported_by_location [2021/01/27 21:18] (current)
Line 137: Line 137:
 |{ITEM.DESCRIPTION} ​               |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications ​ |//​Description of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION[[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.DESCRIPTION} ​               |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications ​ |//​Description of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION[[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.DESCRIPTION.ORIG} ​               |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications ​ |//​Description (with macros unresolved) of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION.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]].\\ \\ Supported since 5.2.0.| |{ITEM.DESCRIPTION.ORIG} ​               |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications ​ |//​Description (with macros unresolved) of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.DESCRIPTION.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]].\\ \\ Supported since 5.2.0.|
-|{ITEM.ID} ​                        ​|->​ Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications\\ ​ -> Script type item, item prototype and discovery rule parameter names and values\\ -> HTTP agent type item, item prototype and discovery rule fields: \\ URL, query fields, request body, headers, proxy, SSL certificate file, SSL key file.  |//Numeric ID of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.ID[[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.ID} ​                        ​|->​ 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.  |//Numeric ID of the Nth item in the trigger expression that caused a notification.//​\\ \\ This macro may be used with a numeric index e.g. {ITEM.ID[[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} ​                       |-> Trigger-based notifications and commands\\ -> Problem update notifications and commands\\ -> Internal notifications\\ ​ -> Script type item, item prototype and discovery rule parameter names and values\\ ​ -> 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\\ ​ -> HTTP agent type item, item prototype and discovery rule fields:\\ URL, Query fields, Request body, Headers, Proxy, SSL certificate file, SSL key file, Allowed hosts. ​ |//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, Allowed hosts.<​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 ​<​sup>​[[supported_by_location#​footnotes|4]]</​sup>​.//\\ \\ 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.\\ 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.\\ 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.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]]. ​ |
Line 216: Line 216:
  
 <​sup>​**7**</​sup>​ Supported since 4.0.0. <​sup>​**7**</​sup>​ Supported since 4.0.0.
 +
 +<​sup>​**8**</​sup>​ Supported since 5.2.5.
  
 === Indexed macros === === Indexed macros ===