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, script, SSH, Telnet, IPMI), включая текст подтверждения yes
Вебхуки
Скрипт JavaScript no
Имя параметра скрипта JavaScript no
Значение параметра скрипта JavaScript yes
Панели
Столбец типа данных Text в виджете панели Top hosts yes
Параметр Description в виджете панели Item value и Gauge yes
Параметр Text для основной/вторичной метки в виджете панели Honeycomb yes
Параметр URL3 в виджете панели URL yes
Пользователи → Пользователи → Медиа
Когда активно yes
Администрирование → Общее → GUI
Рабочее время no
Администрирование → Общее → Тайм-ауты
Тайм-ауты для типов элементов данных no
Администрирование → Общее → Коннекторы
URL yes
Имя пользователя yes
Пароль yes
Bearer token yes
Тайм-аут no
HTTP proxy yes
Файл SSL-сертификата yes
Файл SSL-ключа yes
Пароль SSL-ключа yes
Оповещения → Типы медиа → Шаблоны сообщений
Тема yes
Сообщение yes
Оповещения → Типы медиа → Скрипт
Параметры скрипта yes
Оповещения → Типы медиа → Тип медиа
Поля Username и Password для типа медиа Email (когда для Authentication установлено значение "Username and password"; secret macros recommended) yes

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

Примечания

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

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

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