[comment]: # ({d428738a-d428738a})
# 2. Пользовательские макросы, поддерживаемые по местоположению

[comment]: # ({/d428738a-d428738a})

[comment]: # ({0586ac4e-f0afb8e0})
#### Обзор

В этом разделе представлен список мест, где поддерживаются [определяемые пользователем](/manual/config/macros/user_macros) макросы.

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

::: noteclassic
Чтобы настроить значения макросов (например, сократить или извлечь определённые подстроки), можно использовать [функции макросов](/manual/config/macros/macro_functions).
:::

[comment]: # ({/0586ac4e-f0afb8e0})

[comment]: # ({bb611c5d-7cb4c86b})
#### Действия

При настройке [действий](/manual/config/notifications/action) пользовательские макросы
могут быть использованы в следующих полях:

|Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^|
|-|------------------------------|----------|
|Оповещения и команды на события триггеров|<|да|
|Внутренние оповещения на события триггеров|<|да|
|Оповещения об обновлении проблем|<|да|
|Оповещения и команды на события услуг|<|да|
|Оповещения об обновлении услуг|<|да|
|Условие периода времени|<|нет|
|*Операции*|<|<|
| |Длительность шага операции по умолчанию|нет|
|^|Длительность шага|нет|

[comment]: # ({/bb611c5d-7cb4c86b})

[comment]: # ({9d1364cf-f30645e0})
#### Узлы сети / прототипы узлов сети

При настройке [узла сети](/manual/config/hosts/host) и [прототипа узла
сети](/manual/vm_monitoring/example#создайте-узел-сети) пользовательские
макросы могут использоваться в следующих полях:

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

[comment]: # ({/9d1364cf-f30645e0})

[comment]: # ({7be6d794-d51563d6})
#### Элементы данных / прототипы элементов данных

При настройке [элементов данных](/manual/config/items/item) или [прототипов
элементов данных](/manual/discovery/low_level_discovery/item_prototypes)
пользовательские макросы могут использоваться в следующих полях:

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

[comment]: # ({/7be6d794-d51563d6})

[comment]: # ({04aa381c-747bd0ca})
#### Низкоуровневое обнаружение

При настройке [правил низкоуровневого
обнаружения](/manual/discovery/low_level_discovery#настройка-низкоуровневого-обнаружения)
пользовательские макросы могут использоваться в следующих полях:

|Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^|
|-|------------------------------|----------|
|Параметры ключа|<|да|
|Интервал обновления|<|нет|
|Пользовательские интервалы|<|нет|
|Время ожидания (доступно для [поддерживаемых](/manual/web_interface/frontend_sections/administration/general#тайм-ауты) типов элементов данных)|<|нет|
|Удаление потерянных ресурсов|<|нет|
|Деактивация потерянных ресурсов|<|нет|
|Описание|<|да|
|*SNMP агент*|<|<|
| |SNMP OID|да|
|*SSH агент*|<|<|
| |Имя пользователя|да|
|^|Файл публичного ключа|да|
|^|Файл приватного ключа|да|
|^|Пароль|да|
|^|Выполняемый скрипт|да|
|*TELNET агент*|<|<|
| |Имя пользователя|да|
|^|Пароль|да|
|^|Выполняемый скрипт|да|
|*Zabbix траппер*|<|<|
| |Разрешённые хосты|да|
|*Монитор баз данных*|<|<|
| |Имя пользователя|да|
|^|Пароль|да|
|^|SQL запрос|да|
|*JMX агент*|<|<|
| |JMX endpoint|да|
|*HTTP агент*|<|<|
| |URL^[3](supported_by_location_user#примечания)^|да|
|^|Поля запроса|да|
|^|Тело запроса|да|
|^|Заголовки (имена и значения)|да|
|^|Требуемые коды состояния|да|
|^|Имя пользователя для HTTP аутентификации|да|
|^|Пароль для HTTP аутентификации|да|
|*Фильтры*|<|<|
| |Регулярное выражение|да|
|*Замещения*|<|<|
| |Фильтры: регулярное выражение|да|
|^|Операции: интервал обновления (для прототипов элементов данных)|нет|
|^|Операции: период хранения истории (для прототипов элементов данных)|нет|
|^|Операции: период хранения динамики изменений (для прототипов элементов данных)|нет|

[comment]: # ({/04aa381c-747bd0ca})

[comment]: # ({7c6ab06a-95f2f372})
#### Сетевое обнаружение

При настройке [правил сетевого обнаружения](/manual/discovery/network_discovery/rule)
пользовательские макросы могут использоваться в следующих полях:

|Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^|
|-|------------------------------|----------|
|Интервал обновления|<|нет|
|*SNMP v1, v2*|<|<|
| |SNMP community|да|
|^|SNMP OID|да|
|*SNMP v3*|<|<|
| |Имя контекста|да|
|^|Имя безопасности|да|
|^|Пароль аутентификации|да|
|^|Ключевая фраза безопасности|да|
|^|SNMP OID|да|

[comment]: # ({/7c6ab06a-95f2f372})

[comment]: # ({3962fa7e-575d88fc})
#### Прокси серверы

При настройке [прокси](/manual/distributed_monitoring/proxies#настройка)
серверов пользовательские макросы могут использоваться в следующих полях:

|Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^|
|-|------------------------------|----------|
|*Адрес для активных агентов > Порт* (если прокси принадлежит группе)|<|нет|
|Адрес интерфейса и порт (для пассивных прокси)|<|нет|
|Время ожидания по типам элементов данных|<|нет|

[comment]: # ({/3962fa7e-575d88fc})

[comment]: # ({76ff2b0f-dbeb9eca})
#### Группы прокси

При настройке [групп прокси](/manual/distributed_monitoring/proxies/ha#настройка-групп-прокси)
пользовательские макросы могут использоваться в следующих полях:

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

[comment]: # ({/76ff2b0f-dbeb9eca})

[comment]: # ({d5117b03-32b6aef1})
#### Шаблоны

При настройке [шаблонов](/manual/config/templates/template) пользовательские
макросы могут использоваться в следующих полях:

|Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^|
|-|------------------------------|----------|
|*Теги*^[2](supported_by_location_user#примечания)^|<|<|
| |Имена тегов|да|
|^|Значения тегов|да|

[comment]: # ({/d5117b03-32b6aef1})

[comment]: # ({0d27e496-c78b04ef})
#### Триггеры

При настройке [триггеров](/manual/config/triggers/trigger) пользовательские
макросы могут использоваться в следующих полях:

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

[comment]: # ({/0d27e496-c78b04ef})

[comment]: # ({423f6587-78f1f511})
#### Веб-сценарии

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

|Место|<|Несколько макросов/вперемешку с текстом^[1](supported_by_location_user#примечания)^|
|-|------------------------------|----------|
|Имя|<|да|
|Интервал обновления|<|нет|
|Агент|<|да|
|HTTP прокси|<|да|
|Переменные (только значения)|<|да|
|Заголовки (имена и значения)|<|да|
|*Шаги*|<|<|
| |Имя|да|
|^|URL^[3](supported_by_location_user#примечания)^|да|
|^|Переменные (только значения)|да|
|^|Заголовки (имена и значения)|да|
|^|Время ожидания|нет|
|^|Требуемая строка|да|
|^|Требуемые коды состояния|нет|
|*Аутентификация*|<|<|
| |Пользователь|да|
|^|Пароль|да|
|^|Файл SSL сертификата|да|
|^|Файл SSL ключа|да|
|^|Пароль к SSL ключу|да|
|*Теги*^[2](supported_by_location_user#примечания)^|<|<|
| |Имена тегов|да|
|^|Значения тегов|да|

[comment]: # ({/423f6587-78f1f511})

[comment]: # ({1052c243-efe84e1d})
#### Другие места

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

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

Полный список всех макросов, поддерживаемых в Zabbix, смотрите в разделе
[поддерживаемые макросы](/manual/appendix/macros/supported_by_location).

[comment]: # ({/1052c243-efe84e1d})

[comment]: # ({3f947571-5a370e78})
##### Примечания

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

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

^**3**^ URL-ы, которые содержат [секретные
макросы](/manual/config/macros/user_macros#настройка), работать не будут,
поскольку макросы в них будут раскрыты как «\*\*\*\*\*\*».

[comment]: # ({/3f947571-5a370e78})