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

Обзор

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

Дополнительные параметры к монитору БД, SSH и Telnet скриптам													ОПИСАНИЕ
IP/DNS интерфейса												▼▼
Имена элементов данных											▼▼
Имена триггеров										▼▼
Выражения триггеров									▼▼
Ссылки URL на картах								▼▼
Подписи на картах¹							▼▼
Параметры ключей элементов данных						▼▼
Скрипты в веб-интерфейсе					▼▼
Оповещения авторегистрации				▼▼
Оповещения обнаружения			▼▼
Оповещения и команды		▼▼
МАКРОС	▼▼	▼▼
▼▼	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	X²	X			X		X		IP или DNS имя узла сети в зависимости от настроек узла сети³. Поддерживается в именах триггеров начиная с 2.0.0.
{HOST.DNS<1-9>}	X			X	X²	X			X		X		DNS имя узла сети³. Поддерживается в именах триггеров начиная с 2.0.0.
{HOST.HOST<1-9>}	X		X	X	X	X			X		X	X⁵	Имя узла сети. {HOSTNAME<1-9>} устарел.
{HOST.ID}							X					ID узла сети.
{HOST.IP<1-9>}	X		X	X	X²	X			X		X	X⁵	IP адрес узла сети³. Поддерживается начиная с 2.0.0. {IPADDRESS<1-9>} устарел.
{HOST.NAME<1-9>}	X		X	X	X	X			X		X	X⁵	Видимое имя узла сети. Поддерживается начиная с 2.0.0.
{HOST.PORT}			X										Порт³ узла сети (агента). Поддерживается начиная с 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					X⁴		X⁶					Простые макросы, такие как в выражениях триггеров.
{$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 имя макроса и ссылаться по этому имени.

Documentation

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

Обзор

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

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