2. Пользовательские макросы, поддерживаемые по местоположению

Обзор

В этом разделе представлен список мест, где поддерживаются определяемые пользователем макросы.

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

Чтобы настроить значения макросов (например, сократить или извлечь определённые подстроки), можно использовать функции макросов.

Действия

При настройке действий пользовательские макросы могут быть использованы в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Оповещения и команды на события триггеров да
Внутренние оповещения на события триггеров да
Оповещения об обновлении проблем да
Оповещения и команды на события услуг да
Оповещения об обновлении услуг да
Условие периода времени нет
Операции
Длительность шага операции по умолчанию нет
Длительность шага нет

Узлы сети / прототипы узлов сети

При настройке узла сети и прототипа узла сети пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
IP адрес / DNS имя интерфейса только DNS
Порт интерфейса нет
SNMP v1, v2
SNMP community да
SNMP v3
Имя контекста да
Имя безопасности да
Пароль аутентификации да
Ключевая фраза безопасности да
IPMI
Имя пользователя да
Пароль да
Теги2
Имена тегов да
Значения тегов да

Элементы данных / прототипы элементов данных

При настройке элементов данных или прототипов элементов данных пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Имя элемента данных да
Параметры ключа элемента данных да
Интервал обновления нет
Пользовательские интервалы нет
Время ожидания (доступно для поддерживаемых типов элементов данных) нет
Хранить до (для истории и динамики изменений) нет
Описание да
Вычисляемый/агрегируемый элемент данных
Формула (константы выражения и параметры функции; параметры ключа элемента данных; (только агрегируемый элемент данных) условия фильтра (имя группы узлов сети и имя тега)) да
Монитор баз данных
Имя пользователя да
Пароль да
SQL запрос да
HTTP агент
URL3 да
Поля запроса да
Тело запроса да
Заголовки (имена и значения) да
Требуемые коды состояния да
HTTP прокси да
Имя пользователя для HTTP аутентификации да
Пароль для HTTP аутентификации да
Файл SSL сертификата да
Файл SSL ключа да
Пароль к SSL ключу да
Разрешённые хосты да
JMX агент
JMX endpoint да
Скриптовый элемент данных
Имена и значения параметров да
Элемент данных типа «Браузер»
Имена и значения параметров да
SNMP агент
SNMP OID да
SSH агент
Имя пользователя да
Файл публичного ключа да
Файл приватного ключа да
Пароль да
Выполняемый скрипт да
TELNET агент
Имя пользователя да
Пароль да
Выполняемый скрипт да
Zabbix траппер
Разрешённые хосты да
Теги2
Имена тегов да
Значения тегов да
Шаги предобработки
Параметры (включая пользовательские скрипты) да
Пользовательские параметры обработки ошибок (поля Задать значением (Set value to) и Задать ошибку в (Set error to)) да

Низкоуровневое обнаружение

При настройке правил низкоуровневого обнаружения пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Параметры ключа да
Интервал обновления нет
Пользовательские интервалы нет
Время ожидания (доступно для поддерживаемых типов элементов данных) нет
Удаление потерянных ресурсов нет
Деактивация потерянных ресурсов нет
Описание да
SNMP агент
SNMP OID да
SSH агент
Имя пользователя да
Файл публичного ключа да
Файл приватного ключа да
Пароль да
Выполняемый скрипт да
TELNET агент
Имя пользователя да
Пароль да
Выполняемый скрипт да
Zabbix траппер
Разрешённые хосты да
Монитори баз данных
Имя пользователя да
Пароль да
SQL запрос да
JMX агент
JMX endpoint да
HTTP агент
URL3 да
Поля запроса да
Тело запроса да
Заголовки (имена и значения) да
Требуемые коды состояния да
Имя пользователя для HTTP аутентификации да
Пароль для HTTP аутентификации да
Фильтры
Регулярное выражение да
Замещения
Фильтры: регулярное выражение да
Операции: интервал обновления (для прототипов элементов данных) нет
Операции: период хранения истории (для прототипов элементов данных) нет
Операции: период хранения динамики изменений (для прототипов элементов данных) нет

Сетевое обнаружение

При настройке правил сетевого обнаружения пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Интервал обновления нет
SNMP v1, v2
SNMP community да
SNMP OID да
SNMP v3
Имя контекста да
Имя безопасности да
Пароль аутентификации да
Ключевая фраза безопасности да
SNMP OID да

Прокси серверы

При настройке прокси серверов пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Порт интерфейса (для активных агентов, если прокси принадлежит группе) нет
Порт интерфейса (для пассивных прокси) нет
Время ожидания по типам элементов данных нет

Группы прокси

При настройке групп прокси пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Период аварийного переключения (Failover period) нет
Минимальное количество прокси (Minimum number of proxies) нет

Шаблоны

При настройке шаблонов пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Теги2
Имена тегов да
Значения тегов да

Триггеры

При настройке триггеров пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Имя да
Оперативные данные да
Выражение (только в константах и параметрах функций; секретные макросы не поддерживаются) да
Теги для совпадения да
Имя записи в меню да
URL записи в меню3 да
Описание да
Теги2
Имена тегов да
Значения тегов да

Веб-сценарии

При настройке веб-сценариев пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Имя да
Интервал обновления нет
Агент да
HTTP прокси да
Переменные (только значения) да
Заголовки (имена и значения) да
Шаги
Имя да
URL3 да
Переменные (только значения) да
Заголовки (имена и значения) да
Время ожидания нет
Требуемая строка да
Требуемые коды состояния нет
Аутентификация
Пользователь да
Пароль да
Файл SSL сертификата да
Файл SSL ключа да
Пароль к SSL ключу да
Теги2
Имена тегов да
Значения тегов да

Другие места

Помимо перечисленных здесь мест, пользовательские макросы могут использоваться в следующих полях:

Место Несколько макросов/вперемешку с текстом1
Глобальные скрипты (URL, скрипт, SSH, Telnet, IPMI), включая текст подтверждения да
Вебхуки
Скрипт JavaScript нет
Имя параметра скрипта JavaScript нет
Значение параметра скрипта JavaScript да
Панели
Столбец данных типа Текст в виджете панели Топ узлов сети да
Параметр Описание в виджетах панели Значение элемента данных и Радиальный датчик да
Параметр Текст Первичной/Вторичной метки в виджете панели Сотовый график да
Параметр URL3 в виджете панели URL да
Пользователи → Пользователи → Оповещения*
Когда активен нет
Администрирование → Общие → Веб-интерфейс
Рабочее время нет
Администрирование → Общие → Время ожидания
Время ожидания по типам элементов данных нет
Администрирование → Общие → Коннекторы
URL да
Имя пользователя да
Пароль да
Токен на предъявителя (Bearer token) да
Время ожидания (Timeout) нет
HTTP прокси да
Файл SSL сертификата да
Файл SSL ключа да
Пароль к SSL ключу да
Оповещения → Способы оповещений → Шаблоны сообщений
Тема да
Сообщение да
Оповещения → Способы оповещений → Скрипты
Параметры скрипта да
Оповещения → Способы оповещений → Способ оповещений
Поля Имя пользователя и Пароль для способа оповещений Email (когда параметр Аутентификация имеет значение "Имя пользователя и пароль"; рекомендуются секретные макросы) да

Полный список всех макросов, поддерживаемых в Zabbix, смотрите в разделе поддерживаемые макросы.

Примечания

1 Если несколько макросов в поле или макросы вперемешку с текстом не поддерживаются для данного места, то один макрос должен заполнять целиком всё поле.

2 Макросы, которые используются в именах и значениях тегов, раскрываются только во время процесса генерации событий.

3 URL-ы, которые содержат секретные макросы, работать не будут, поскольку макросы в них будут раскрыты как «******».