Zabbix Documentation 2.4

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


ru: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
ru:manual:appendix:macros:supported_by_location [2015/12/25 19:05]
dotneft
ru:manual:appendix:macros:supported_by_location [2016/12/06 13:24] (current)
dotneft
Line 1: Line 1:
-{{odt>​page:​A3,​landscape,​1,​1,​1,​1}} +==== 1 Макросы поддерживаемые по назначению ====
- +
-==== - #1 Макросы поддерживаемые по назначению ====+
  
 === Обзор === === Обзор ===
Line 8: Line 6:
  
   * **X** означает "​поддерживается"​ в указанном месте   * **X** означает "​поддерживается"​ в указанном месте
-  * Нумерованный макрос вида {МАКРОС**<​1-9>​**} используется для того, чтобы сослаться на узлы сети в порядке в котором они следуют в выражении триггера. Таким образом,​ макросы {HOST.IP1}, {HOST.IP2}, {HOST.IP3} заменяются на IP-адреса первого,​ второго и третьего узлов сети в выражении триггера с учетом того, что выражение содержит эти узлы сети. ​+  * Нумерованный макрос вида {МАКРОС**<​1-9>​**} используется для того, чтобы сослаться на узлы сети в порядке в котором они следуют в выражении триггера. Таким образом,​ макросы {HOST.IP1}, {HOST.IP2}, {HOST.IP3} заменяются на IP-адреса первого,​ второго и третьего узлов сети в выражении триггера с учетом того, что выражение содержит эти узлы сети. Кроме того, макросы {HOST.HOST**<​1-9>​**} поддерживаются в {узел_сети:​ключ.функ(парам)} макросе в именах графиков. Например,​ {{HOST.HOST2}:​ключ.функ()} в имени графика ссылается на узел сети второго элемента данных из графика.
  
 |                                                                       ​Поле URL динамического элемента URL **комплексного экрана**|||||||||||||||||||▼^ ​ ▼ОПИСАНИЕ▼ ​ | |                                                                       ​Поле URL динамического элемента URL **комплексного экрана**|||||||||||||||||||▼^ ​ ▼ОПИСАНИЕ▼ ​ |
Line 20: Line 18:
 |                                                                         ​**Выражения** триггеров|||||||||||▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​| |                                                                         ​**Выражения** триггеров|||||||||||▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|
 |                                                                 ​**URL'​ы** на картах сети|||||||||^▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​| |                                                                 ​**URL'​ы** на картах сети|||||||||^▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|
- **Подписи<​sup>​[[supported_by_location#​примечания|1]]</​sup>​** на картах сети|||||||||▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|+         **Подписи<​sup>​[[supported_by_location#​примечания|1]]</​sup>​** ​к иконкам ​на картах сети|||||||||▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|
 |                                              **Параметры** ключей элементов данных|||||||^▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​| |                                              **Параметры** ключей элементов данных|||||||^▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|
 |                                    Глобальные **скрипты**,​ включая текст подтверждения|||||||▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​| |                                    Глобальные **скрипты**,​ включая текст подтверждения|||||||▼|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|:::​|
Line 186: Line 184:
 |{TRIGGER.STATE} ​                       |   ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Самое новое состояние триггера.//​ Возможные значения:​ **Unknown** и **Normal**.\\ Поддерживается начиная с 2.2.0. | |{TRIGGER.STATE} ​                       |   ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Самое новое состояние триггера.//​ Возможные значения:​ **Unknown** и **Normal**.\\ Поддерживается начиная с 2.2.0. |
 |{TRIGGER.STATUS} ​                      | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Текущее значение триггера.//​ Может быть PROBLEM или OK.\\ ''​{STATUS}''​ является устаревшим.| |{TRIGGER.STATUS} ​                      | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Текущее значение триггера.//​ Может быть PROBLEM или OK.\\ ''​{STATUS}''​ является устаревшим.|
-|{TRIGGER.TEMPLATE.NAME} ​               | X |   ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Отсортированный (посредством SQL запроса),​ разделенный запятыми список шаблонов,​ которым принадлежит триггер или *UNKNOWN*, если триггер назначен на узел сети напрямую.// ​Supported since 2.0.6.|+|{TRIGGER.TEMPLATE.NAME} ​               | X |   ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Отсортированный (посредством SQL запроса),​ разделенный запятыми список шаблонов,​ которым принадлежит триггер или *UNKNOWN*, если триггер назначен на узел сети напрямую.// ​Поддерживается начиная с 2.0.6.|
 |{TRIGGER.URL} ​                         | X |   ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​URL триггера.//​| |{TRIGGER.URL} ​                         | X |   ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​URL триггера.//​|
 |{TRIGGER.VALUE} ​                       | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Текущее числовое значение триггера//:​ 0 - триггер в состоянии ОК, 1 - триггер в состоянии ПРОБЛЕМА.| |{TRIGGER.VALUE} ​                       | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Текущее числовое значение триггера//:​ 0 - триггер в состоянии ОК, 1 - триггер в состоянии ПРОБЛЕМА.|
Line 194: Line 192:
 |{TRIGGERS.PROBLEM.ACK} ​                ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Количество подтвержденных триггеров в состоянии ПРОБЛЕМА у элемента карты сети.//​\\ Триггер считается подтвержденным,​ если все его ПРОБЛЕМА события являются подтвержденными.\\ Поддерживается начиная с 1.8.3.| |{TRIGGERS.PROBLEM.ACK} ​                ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​|//​Количество подтвержденных триггеров в состоянии ПРОБЛЕМА у элемента карты сети.//​\\ Триггер считается подтвержденным,​ если все его ПРОБЛЕМА события являются подтвержденными.\\ Поддерживается начиная с 1.8.3.|
 |{узел_сети:​ключ.функция(параметр)}| X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X<​sup>​**[[supported_by_location#​примечания|4]]**</​sup>​| ​  | X<​sup>​**[[supported_by_location#​примечания|10]]**</​sup>​ |   ​| ​  ​| ​  ​| ​  ​| ​  | X<​sup>​**[[supported_by_location#​примечания|7]]**</​sup>​| ​  ​| ​  ​|//​Простой макрос,​ который используется для построения [[ru:​manual:​config:​triggers:​expression|выражений]] триггеров//​.| |{узел_сети:​ключ.функция(параметр)}| X |   ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  ​| ​  | X<​sup>​**[[supported_by_location#​примечания|4]]**</​sup>​| ​  | X<​sup>​**[[supported_by_location#​примечания|10]]**</​sup>​ |   ​| ​  ​| ​  ​| ​  ​| ​  | X<​sup>​**[[supported_by_location#​примечания|7]]**</​sup>​| ​  ​| ​  ​|//​Простой макрос,​ который используется для построения [[ru:​manual:​config:​triggers:​expression|выражений]] триггеров//​.|
-|{$MACRO}                               | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X | X |   ​| ​  | X<​sup>​**[[supported_by_location#​примечания|9]]**</​sup>​ | X | X | X | X | X |   | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ |//​[[ru:​manual:​config:​macros:​usermacros|Пользовательские]] макросы.//​\\ Поддерживаются в элементах данных и именах триггеров начиная с 1.8.4.\\ Поддерживаются в командах и текстах подтверждения глобальных скриптов начиная с Zabbix 2.2.0.|+|{$МАКРОС}                               | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X | X |   ​| ​  | X<​sup>​**[[supported_by_location#​примечания|9]]**</​sup>​ | X | X | X | X | X |   | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ | X<​sup>​**[[supported_by_location#​примечания|8]]**</​sup>​ |//​[[ru:​manual:​config:​macros:​usermacros|Пользовательские]] макросы.//​\\ Поддерживаются в элементах данных и именах триггеров начиная с 1.8.4.\\ Поддерживаются в командах и текстах подтверждения глобальных скриптов начиная с Zabbix 2.2.0.|
 ^                                       ​| ​ 1  ^  2  |  3  ^  4  |  5  ^  6  |  7  ^  8  |  9  ^  10  |  11  ^  12  |  13  ^  14  |  15  ^  16  |  17  ^  18  |  19  ^  | ^                                       ​| ​ 1  ^  2  |  3  ^  4  |  5  ^  6  |  7  ^  8  |  9  ^  10  |  11  ^  12  |  13  ^  14  |  15  ^  16  |  17  ^  18  |  19  ^  |
  
Line 201: Line 199:
 <​sup>​**1**</​sup>​ Макросы для подписей на картах сети поддерживаются начиная с 1.8. <​sup>​**1**</​sup>​ Макросы для подписей на картах сети поддерживаются начиная с 1.8.
  
-<​sup>​**2**</​sup> ​Начиная с Zabbix 2.0.3, макросы HOST.*, поддерживаемые в параметрах ключей элементов данных, работают только с теми типами элементов данных, которые имеют ​интерфейсы, то есть эти макросы не будут ​работать с типами "​Zabbix агент (активный)",​ "​Вычисляемый"​ и т.п.+<​sup>​**2**</​sup> ​Макросы ​''​{HOST.*}''​, поддерживаемые в параметрах ключей элементов данных будут раскрыты в данные интерфейсакоторый выбран для этого ​элемента данных. Эти макросы не раскроются, когда используются в элементах данных без ​интерфейсов,​ таких как ​"​Zabbix агент (активный)",​ "​Вычисляемый"​ и остальные.
  
-<​sup>​**3**</​sup>​ В зависимости от контекста макрос будет раскрываться по-разному. В **2.0.1** и более ранних версиях в контексте выполнения ​удаленных команд, ​скриптов в веб-интерфейсе,​ параметров ключей элементов данных и полей интерфейса IP/​DNS ​только основной ​интерфейса агента считается источником информации. Начиная с **2.0.2** ​и в веб-сценариях ​с **2.2.0**, ​макрос ​использует основной интерфейс агента,​ однако,​ если он не существует,​ будет использоваться ​основной интерфейс ​SNMP. Если SNMP также ​не существует,​ будет использоваться основной ​интерфейс ​JMX. Если JMX не существует,​ будет использоваться ​основной ​интерфейс ​IPMI. В **параметрах** ключа элемента данных будет использоваться тот ​интерфейс, который выбран для элемента данных,​ начиная с 2.0.3.+<​sup>​**3**</​sup>​ В удаленных командахглобальных ​скриптах, в IP/​DNS ​полях интерфейсов и в веб-сценариях макрос ​будет раскрываться беря данные с основного интерфейса агента,​ однако,​ если он не существует,​ будет использован основной ​SNMP интерфейс. Если SNMP также ​отсутствует,​ будет использован ​JMX интерфейс. Если также ​и JMX отсутствует,​ будет использован основной IPMI интерфейс.
  
-<​sup>​**4**</​sup>​ В этом макроcе в подписях на картах сетей поддерживаются только **avg**, **last**, **max** и **min** функции с секундами в качестве параметра.+<​sup>​**4**</​sup> ​Этот макрос поддерживается в подписях к иконкам и в подписях к связям на картах сетей. ​В этом макроcе в подписях на картах сетей поддерживаются только **avg**, **last**, **max** и **min** функции с секундами в качестве параметра.
  
 <​sup>​**5**</​sup>​ Поддерживается начиная с 2.0.3. <​sup>​**5**</​sup>​ Поддерживается начиная с 2.0.3.
Line 271: Line 269:
     * формулах вычисляемых элементов данных     * формулах вычисляемых элементов данных
     * SSH и Telnet скриптах     * SSH и Telnet скриптах
-    * параметрах элементов данных типа ​монитора баз данных+    * SQL запросах монитора баз данных
     * описаниях (поддерживается начиная с 2.2.0)     * описаниях (поддерживается начиная с 2.2.0)
   * в прототипах триггеров в   * в прототипах триггеров в