Sidebar

Zabbix Summit 2022
View presentations

1 Макросы поддерживаемые по назначению

Обзор

В таблице содержится полный список поддерживаемых макросов Zabbix. X означает "поддерживается".

Дополнительные параметры к монитору БД, SSH и Telnet скриптам ОПИСАНИЕ
IP/DNS интерфейса ▼▼
Имена элементов данных ▼▼
Имена триггеров ▼▼
Выражения триггеров ▼▼
Ссылки URL на картах ▼▼
Подписи на картах1 ▼▼
Параметры ключей элементов данных ▼▼
Скрипты в веб-интерфейсе ▼▼
Оповещения авторегистрации ▼▼
Оповещения обнаружения ▼▼
Оповещения и команды ▼▼
МАКРОС ▼▼
▼▼ 1 2 3 4 5 6 7 8 9 10 11 12
{DATE} X X X Текущая дата в формате гггг.мм.дд.
{DISCOVERY.DEVICE.IPADDRESS} X IP адрес обнаруженного устройства. Доступен всегда, вне зависимости от того добавлен узел сети или нет.
{DISCOVERY.DEVICE.DNS} X DNS имя обнаруженного устройства. Доступен всегда, вне зависимости от того добавлен узел сети или нет.
{DISCOVERY.DEVICE.STATUS} X Состояние обнаруженного устройства: может быть ДОСТУПЕН или НЕДОСТУПЕН.
{DISCOVERY.DEVICE.UPTIME} X Время с момента последнего изменения состояния обнаружения для конкретного устройства.
Например: 1ч 29м.
Для устройств с состоянием НЕДОСТУПЕН, значением будет период недоступности.
{DISCOVERY.RULE.NAME} X Имя правила обнаружения, которое обнаружило наличие или отсутствие устройства или сервиса.
{DISCOVERY.SERVICE.NAME} X Имя сервиса, который был обнаружен.
Например: HTTP.
{DISCOVERY.SERVICE.PORT} X Порт сервиса, который был обнаружен.
Например: 80.
{DISCOVERY.SERVICE.STATUS} X Состояние обнаруженного сервиса: может быть ДОСТУПЕН или НЕДОСТУПЕН.
{DISCOVERY.SERVICE.UPTIME} X Время с момента последнего изменения состояния обнаружения для конкретного сервиса.
Например: 1ч 29м.
Для сервисов с состоянием НЕДОСТУПЕН, значением будет период недоступности.
{ESC.HISTORY} X История эскалаций. Журнал ранее отправленных сообщений. Показывает ранее отправленные оповещения, на каком шагу эскалации были отправлены и их состояние (отправлено, в процессе или ошибочный).
{EVENT.ACK.HISTORY} X
{EVENT.ACK.STATUS} X
{EVENT.AGE} X X X Возраст события. Полезно в сообщениях эскалаций.
{EVENT.DATE} X X X Дата события.
{EVENT.ID} X X X Числовой ID события, вызвавшего это действие.
{EVENT.TIME} X X X Время события.
{HOST.CONN<1-9>} X X X2 X X X IP или DNS имя узла сети в зависимости от настроек узла сети3. Поддерживается в именах триггеров начиная с 2.0.0.
{HOST.DNS<1-9>} X X X2 X X X DNS имя узла сети3. Поддерживается в именах триггеров начиная с 2.0.0.
{HOST.HOST<1-9>} X X X X X X X X5 Имя узла сети. {HOSTNAME<1-9>} устарел.
{HOST.ID} X ID узла сети.
{HOST.IP<1-9>} X X X X2 X X X X5 IP адрес узла сети3. Поддерживается начиная с 2.0.0. {IPADDRESS<1-9>} устарел.
{HOST.NAME<1-9>} X X X X X X X X5 Видимое имя узла сети. Поддерживается начиная с 2.0.0.
{HOST.PORT} X Порт3 узла сети (агента). Поддерживается начиная с 2.0.0.
{HOSTGROUP.ID} X ID группы узлов сети.
1 2 3 4 5 6 7 8 9 10 11 12
{INVENTORY.ALIAS<1-9>} X Поле Псевдоним в инвентарных данных узла сети.
{INVENTORY.ASSET.TAG<1-9>} X Поле Этикетка владельца в инвентарных данных узла сети.
{INVENTORY.CHASSIS<1-9>} X Поле Шасси в инвентарных данных узла сети.
{INVENTORY.CONTACT<1-9>} X Поле Контактная информация в инвентарных данных узла сети. {PROFILE.CONTACT<1-9>} устарел.
{INVENTORY.CONTRACT.NUMBER<1-9>} X Поле Номер контракта в инвентарных данных узла сети.
{INVENTORY.DEPLOYMENT.STATUS<1-9>} X Поле Состояние развертывания в инвентарных данных узла сети.
{INVENTORY.HARDWARE<1-9>} X Поле Аппаратные средства в инвентарных данных узла сети. {PROFILE.HARDWARE<1-9>} устарел.
{INVENTORY.HARDWARE.FULL<1-9>} X Поле Аппаратные средства (полная детализация) в инвентарных данных узла сети.
{INVENTORY.HOST.NETMASK<1-9>} X Поле Маска подсети узла сети в инвентарных данных узла сети.
{INVENTORY.HOST.NETWORKS<1-9>} X Поле Сети узла сети в инвентарных данных узла сети.
{INVENTORY.HOST.ROUTER<1-9>} X Поле Роутер узла сети в инвентарных данных узла сети.
{INVENTORY.HW.ARCH<1-9>} X Поле Архитектура HW в инвентарных данных узла сети.
{INVENTORY.HW.DATE.DECOMM<1-9>} X Поле Дата списания HW в инвентарных данных узла сети.
{INVENTORY.HW.DATE.EXPIRY<1-9>} X Поле Дата окончания обслуживания HW в инвентарных данных узла сети.
{INVENTORY.HW.DATE.INSTALL<1-9>} X Поле Дата установки HW в инвентарных данных узла сети.
{INVENTORY.HW.DATE.PURCHASE<1-9>} X Поле Дата покупки HW в инвентарных данных узла сети.
{INVENTORY.INSTALLER.NAME<1-9>} X Поле Имя установщика в инвентарных данных узла сети.
{INVENTORY.LOCATION<1-9>} X Поле Местоположение в инвентарных данных узла сети. {PROFILE.LOCATION<1-9>} устарел.
{INVENTORY.LOCATION.LAT<1-9>} X Поле Размещение (широта) в инвентарных данных узла сети.
{INVENTORY.LOCATION.LON<1-9>} X Поле Размещение (долгота) в инвентарных данных узла сети.
1 2 3 4 5 6 7 8 9 10 11 12
{INVENTORY.MACADDRESS.A<1-9>} X Поле MAC адрес A в инвентарных данных узла сети. {PROFILE.MACADDRESS<1-9>} устарел.
{INVENTORY.MACADDRESS.B<1-9>} X Поле MAC адрес B в инвентарных данных узла сети.
{INVENTORY.MODEL<1-9>} X Поле Модель в инвентарных данных узла сети.
{INVENTORY.NAME<1-9>} X Поле Имя в инвентарных данных узла сети. {PROFILE.NAME<1-9>} устарел.
{INVENTORY.NOTES<1-9>} X Поле Примечания в инвентарных данных узла сети {PROFILE.NOTES<1-9>} устарел.
{INVENTORY.OOB.IP<1-9>} X Поле OOB IP адрес в инвентарных данных узла сети.
{INVENTORY.OOB.NETMASK<1-9>} X Поле OOB маска подсети в инвентарных данных узла сети.
{INVENTORY.OOB.ROUTER<1-9>} X Поле OOB роутер в инвентарных данных узла сети.
{INVENTORY.OS<1-9>} X Поле ОС в инвентарных данных узла сети. {PROFILE.OS<1-9>} устарел.
{INVENTORY.OS.FULL<1-9>} X Поле ОС (полная детализация) в инвентарных данных узла сети.
{INVENTORY.OS.SHORT<1-9>} X Поле ОС (Короткое описание) в инвентарных данных узла сети.
{INVENTORY.POC.PRIMARY.CELL<1-9>} X Поле Первичный мобильный для контакта в инвентарных данных узла сети.
{INVENTORY.POC.PRIMARY.EMAIL<1-9>} X Поле Первичный email для контакта в инвентарных данных узла сети.
{INVENTORY.POC.PRIMARY.NAME<1-9>} X Поле Первичное имя для контакта в инвентарных данных узла сети.
{INVENTORY.POC.PRIMARY.NOTES<1-9>} X Поле Первичные примечания для контакта в инвентарных данных узла сети.
{INVENTORY.POC.PRIMARY.PHONE.A<1-9>} X Поле Первичный телефон A для контакта в инвентарных данных узла сети.
{INVENTORY.POC.PRIMARY.PHONE.B<1-9>} X Поле Первичный телефон B для контакта в инвентарных данных узла сети.
{INVENTORY.POC.PRIMARY.SCREEN<1-9>} X Поле Первичное ник-имя для контакта в инвентарных данных узла сети.
{INVENTORY.POC.SECONDARY.CELL<1-9>} X Поле Вторичный мобильный для контакта в инвентарных данных узла сети.
{INVENTORY.POC.SECONDARY.EMAIL<1-9>} X Поле Вторичный email для контакта в инвентарных данных узла сети.
1 2 3 4 5 6 7 8 9 10 11 12
{INVENTORY.POC.SECONDARY.NAME<1-9>} X Поле Вторичное имя для контакта в инвентарных данных узла сети.
{INVENTORY.POC.SECONDARY.NOTES<1-9>} X Поле Вторичные примечания для контакта в инвентарных данных узла сети.
{INVENTORY.POC.SECONDARY.PHONE.A<1-9>} X Поле Вторичный телефон A для контакта в инвентарных данных узла сети.
{INVENTORY.POC.SECONDARY.PHONE.B<1-9>} X Поле Вторичный телефон B для контакта в инвентарных данных узла сети.
{INVENTORY.POC.SECONDARY.SCREEN<1-9>} X Поле Вторичное ник-имя для контакта в инвентарных данных узла сети.
{INVENTORY.SERIALNO.A<1-9>} X Поле Серийный номер A в инвентарных данных узла сети. {PROFILE.SERIALNO<1-9>} устарел.
{INVENTORY.SERIALNO.B<1-9>} X Поле Серийный номер B в инвентарных данных узла сети.
{INVENTORY.SITE.ADDRESS.A<1-9>} X Поле Адрес A в инвентарных данных узла сети.
{INVENTORY.SITE.ADDRESS.B<1-9>} X Поле Адрес B в инвентарных данных узла сети.
{INVENTORY.SITE.ADDRESS.C<1-9>} X Поле Адрес C в инвентарных данных узла сети.
{INVENTORY.SITE.CITY<1-9>} X Поле Город в инвентарных данных узла сети.
{INVENTORY.SITE.COUNTRY<1-9>} X Поле Страна в инвентарных данных узла сети.
{INVENTORY.SITE.NOTES<1-9>} X Поле Заметки в инвентарных данных узла сети.
{INVENTORY.SITE.RACK<1-9>} X Поле Размещение стойки в инвентарных данных узла сети.
{INVENTORY.SITE.STATE<1-9>} X Поле Область / район в инвентарных данных узла сети.
{INVENTORY.SITE.ZIP<1-9>} X Поле Почтовый индекс в инвентарных данных узла сети.
{INVENTORY.SOFTWARE<1-9>} X Поле Программное обеспечение в инвентарных данных узла сети. {PROFILE.SOFTWARE<1-9>} устарел.
{INVENTORY.SOFTWARE.APP.A<1-9>} X Поле Программное обеспечение A в инвентарных данных узла сети.
{INVENTORY.SOFTWARE.APP.B<1-9>} X Поле Программное обеспечение B в инвентарных данных узла сети.
{INVENTORY.SOFTWARE.APP.C<1-9>} X Поле Программное обеспечение C в инвентарных данных узла сети.
1 2 3 4 5 6 7 8 9 10 11 12
{INVENTORY.SOFTWARE.APP.D<1-9>} X Поле Программное обеспечение D в инвентарных данных узла сети.
{INVENTORY.SOFTWARE.APP.E<1-9>} X Поле Программное обеспечение E в инвентарных данных узла сети.
{INVENTORY.SOFTWARE.FULL<1-9>} X Поле Программное обеспечение (полная детализация) в инвентарных данных узла сети.
{INVENTORY.TAG<1-9>} X Поле Этикетка в инвентарных данных узла сети. {PROFILE.TAG<1-9>} устарел.
{INVENTORY.TYPE<1-9>} X Поле Тип в инвентарных данных узла сети. {PROFILE.DEVICETYPE<1-9>} устарел.
{INVENTORY.TYPE.FULL<1-9>} X Поле Тип (полная детализация) в инвентарных данных узла сети.
{INVENTORY.URL.A<1-9>} X Поле URL A в инвентарных данных узла сети.
{INVENTORY.URL.B<1-9>} X Поле URL B в инвентарных данных узла сети.
{INVENTORY.URL.C<1-9>} X Поле URL C в инвентарных данных узла сети.
{INVENTORY.VENDOR<1-9>} X Поле производителя из инвентарных данных узла сети.
1 2 3 4 5 6 7 8 9 10 11 12
{ITEM.ID<1-9>} X Числовое ID N-го элемента данных из выражения триггера вызвавшего оповещение. Поддерживается начиная с 1.8.12.
{ITEM.DESCRIPTION<1-9>} X Описание N-го элемента данных из выражения триггера вызвавшего оповещение. Поддерживается начиная с 2.0.0.
{ITEM.KEY<1-9>} X Ключ N-го элемента данных из выражения триггера вызвавшего оповещение. Поддерживается начиная с 2.0.0. {TRIGGER.KEY} устарел.
{ITEM.KEY.ORIG<1-9>} X Оригинальный ключ (с нераскрытыми макросами) N-го элемента данных из выражения триггера вызвавшего оповещение. Поддерживается начиная с 2.0.6.
{ITEM.LASTVALUE<1-9>} X X Последнее значение N-го элемента данных из выражения триггера вызвавшего оповещение. Поддерживается начиная с 1.4.3. Это алиас к {{HOST.HOST}:{ITEM.KEY}.last(0)}
{ITEM.LOG.AGE<1-9>} X
{ITEM.LOG.DATE<1-9>} X
{ITEM.LOG.EVENTID<1-9>} X
{ITEM.LOG.NSEVERITY<1-9>} X
{ITEM.LOG.SEVERITY<1-9>} X
{ITEM.LOG.SOURCE<1-9>} X
{ITEM.LOG.TIME<1-9>} X
{ITEM.NAME<1-9>} X Имя N-го элемента данных из выражения триггера вызвавшего оповещение.
{ITEM.NAME.ORIG<1-9>} X Оригинальное имя (с нераскрытыми макросами) N-го элемента данных из выражения триггера вызвавшего оповещение. Поддерживается начиная с 2.0.6.
{ITEM.VALUE<1-9>} X X Преобразуется в следующих случаях:
1) Последнее значение N-го элемента данных из выражения триггера, если используется для отображения триггеров.В этом случае работает также как {ITEM.LASTVALUE}.
2) Значение из истории (когда произошло событие) N-го элемента данных из выражения триггера, если используется для отображения в событиях и оповещениях.
В обоих случаях преобразуется в НЕИЗВЕСТНО если значекния в истории уже были удалены либо вобще не были записаны.
Поддерживается начиная с 1.4.3.
{MAP.ID} X ID карты сети.
{NODE.ID<1-9>} X X X
{NODE.NAME<1-9>} X X X
1 2 3 4 5 6 7 8 9 10 11 12
{PROXY.NAME<1-9>} X X X Имя прокси N-го элемента данных из выражения триггера вызвавшего оповещение. Поддерживается начиная с 1.8.4.
{TIME} X X X Текущее время в формате чч:мм:сс.
{TRIGGER.DESCRIPTION} X Описание к триггеру. Поддерживается начиная с 2.0.4. {TRIGGER.COMMENT} является устаревшим.
{TRIGGER.EVENTS.ACK} X X Количество подтвержденных событий для элемента карты сети, или для триггера, который сгенерировал текущее собыие в оповещениях. Поддерживается начиная с 1.8.3.
{TRIGGER.EVENTS.PROBLEM.ACK} X X Количество подтвержденных событий ПРОБЛЕМА для всех триггеров, вне зависимости от их состояния. Поддерживается начиная с 1.8.3.
{TRIGGER.EVENTS.PROBLEM.UNACK} X X Количество неподтвержденных событий ПРОБЛЕМА для всех триггеров, вне зависимости от их состояния. Поддерживается начиная с 1.8.3.
{TRIGGER.EVENTS.UNACK} X X Количество неподтвержденных событий для элемента карты сети, или для триггера, который сгенерировал текущее собыие в оповещениях. Поддерживается в подписях к элементам карт сетей начиная с 1.8.3.
{TRIGGER.PROBLEM.EVENTS.PROBLEM.ACK} X Количество подтвержденных событий ПРОБЛЕМА для триггеров в состоянии ПРОБЛЕМА. Поддерживается начиная с 1.8.3.
{TRIGGER.PROBLEM.EVENTS.PROBLEM.UNACK} X Количество неподтвержденных событий ПРОБЛЕМА для триггеров в состоянии ПРОБЛЕМА. Поддерживается начиная с 1.8.3.
1 2 3 4 5 6 7 8 9 10 11 12
{TRIGGER.EXPRESSION} X Выражение триггера. Поддерживается начиная с 1.8.12.
{TRIGGER.ID} X X Числовой ID триггера вызвавшего это действие.
{TRIGGER.NAME} X Имя триггера.
{TRIGGER.NAME.ORIG} X Оригинальное имя (с нераскрытыми макросами) триггера. Поддерживается начиная с 2.0.6.
{TRIGGER.NSEVERITY} X Числовое представление важности триггера. Возможные значения: 0 - Не классифицировано, 1 - Информация, 2 - Предупреждение, 3 - Средняя, 4 - Высокая, 5 - Чрезвычайная. Поддерживается Zabbix начиная с версии 1.6.2.
{TRIGGER.SEVERITY} X Имя важности триггера. Может быть задано в АдминистрированиеОбщиеВажности триггеров.
{TRIGGER.STATUS} X Состояние триггера. Может быть ПРОБЛЕМА или ОК. {STATUS} устарел.
{TRIGGER.TEMPLATE.NAME} X Отсортированный (с помощью SQL запроса) разделенный запятыми список шаблонов, которым принадлежит триггер, или *UNKNOWN*, если триггер назначен напрямую на узел сети. Поддерживается начиная с 2.0.6.
{TRIGGER.URL} X URL триггера.
{TRIGGER.VALUE} X X Текущее значение триггера: 0 - триггер в состоянии ОК, 1 - триггер в состоянии ПРОБЛЕМА, 2 - триггер в НЕИЗВЕСТНО. Этот макрос может быть также использован в выражениях триггеров.
{TRIGGERS.UNACK} X Количество неподтвержденных триггеров для элемента карты, вне зависимости от состояния триггера. Триггер считается неподтвержденным, если по крайней мере один из событий ПРОБЛЕМА неподтвержден.
{TRIGGERS.PROBLEM.UNACK} X Количество неподтвержденных триггеров с состоянии ПРОБЛЕМА для элемента карты. Триггер считается неподтвержденным, если по крайней мере один из событий ПРОБЛЕМА неподтвержден. Поддерживается начиная с 1.8.3.
{TRIGGERS.ACK} X Количество подтвержденных триггеров для элемента карты, вне зависимости от состояния триггера. Триггер считается подтвержденным, если все его события ПРОБЛЕМА подтверждены. Поддерживается начиная с 1.8.3.
{TRIGGERS.PROBLEM.ACK} X Количество подтвержденных триггеров с состоянии ПРОБЛЕМА для элемента карты. Триггер считается подтвержденным, если все его события ПРОБЛЕМА подтверждены. Поддерживается начиная с 1.8.3.
{host:key.func(param)} X X4 X6 Простые макросы, такие как в выражениях триггеров.
{$MACRO} X X X X X X Пользовательские макросы. Поддерживаются в именах элементов данных и триггеров начиная с версии 1.8.4.
1 2 3 4 5 6 7 8 9 10 11 12

[1] Макросы для подписей на карте сети поддерживаются начиная с 1.8.

[2] Начиная с 2.0.3 макросы HOST.* поддерживаются только в тех ключах элементов данных, которые работают с типами элементов данных, для которых требуется указать интерфейс. Например, эти макросы не будут работать с типами "Zabbix агент (активный)", "Вычисляемый" и с прочими.

[3] В зависимости от контекста макрос будет раскрываться по-разному.

В версиях 2.0.1 и более ранних в контексте полей выполнения удаленных команд, скриптов веб-интерфейса, параметров ключей элементов данных и IP/DNS интерфейсов, только главный интерфейс агента будет рассматриваться как источник информации.

Начиная с 2.0.3 версии макрос будет использовать главный интерфейс SNMP. Кроме того, если SNMP нет, то будет использован интерфейс JMX. Если JMX также не указан, будет использован интерфейс IMPI.

В параметрах ключа элемента данных будет использован тот интерфейс, который выбран для элемента данных в целом, начиная с 2.0.3 версии.

[4] В подписях на карте сети поддерживаются только функции last, avg, max и min с секундами в качестве аргумента.

[5] Поддерживается начиная с 2.0.3. [6] Только в выражениях триггеров константах и параметрах функций.

Макрос {TRIGGER.ID} поддерживается в URL триггеров начиная с Zabbix 1.8.8.

Дополнительная поддержка для пользовательских макросов

В дополнение к назначениям, представленным в таблице выше, пользовательские макросы начиная с 2.0 поддерживаются также и во многих других местах.

  • Узлы сети
    • IP/DNS интерфейса
    • Порт интерфейса
  • Пассивный прокси
    • Порт интерфейса
  • Элементы данных
    • SNMPv3 security name
    • SNMPv3 auth pass
    • SNMPv3 priv pass
    • SNMPv1/v2 community
    • SNMP OID
    • SNMP port
    • Дополнительные параметры монитора баз данных
    • SSH имя пользователя
    • SSH публичный ключ
    • SSH приватный ключ
    • SSH пароль
    • SSH скрипт
    • Telnet имя пользователя
    • Telnet пароль
    • Telnet скрипт
    • Формула вычисляемого элемента данных
  • Обнаружение
    • SNMPv3 security name
    • SNMPv3 auth pass
    • SNMPv3 priv pass
    • SNMPv1/v2 community
    • SNMP OID

Макросы используемые в низкоуровневом обнаружении

Существует тип макросов используемых в функции низкоуровневого обнаружения function - {#MACRO}. Этот макрос, который используется в LLD и возвращает реальныйе значения имен файловых систем, сетевых интерфейсов и SNMP OID-ов.

Эти макросы могут быть использованы для создания прототипов элементов данных, триггеров и графиков. Далее, когда обнаруживаются реальные файловые системы, сетевые интерфейсы и т.п., эти макросы заменяются реальными значениями и становятся основой для создания реальный элементов данных, триггеров и графиков.

LLD макросы можно использовать:

  • для прототипов элементов данных в
    • имена
    • параметры ключей
    • SNMP OIDs
    • формулы вычисляемого элемента данных
    • SSH и Telnet скрипты
    • параметры элемента данных Монитора баз данных
  • для прототипов триггеров в
    • имена
    • выражения (по причине обращения к ключу прототипа элемента данных)
  • для прототипов графиков
    • имена

Некоторые макросы низкоуровневого обнаружения "упакованы" в функцию LLD в Zabbix - {#FSNAME}, {#FSTYPE}, {#IFNAME}, {#SNMPINDEX}, {#SNMPVALUE}. Однако, придерживаться этих имен не обязательно при создании пользовательского низкоуровневого правила обнаружения. В этом случае вы можете использовать любое другое LLD имя макроса и ссылаться по этому имени.