[comment]: # ({12728bfa-12728bfa})
# 6. Тегирование 

[comment]: # ({/12728bfa-12728bfa})

[comment]: # ({46ecb366-700f39aa})
#### Обзор

Теги состоят из имени тега и значения тега.
При тегировании объектов можете использовать только имя или пару имени вместе со значением (например, `mysql`, `jira`, `target:mysql`, `service:jira` и т. д.).

Теги можно определить для различных объектов:

-   шаблоны
-   узлы сети
-   элементы данных
-   веб-сценарии
-   триггеры
-   услуги
-   элементы данных и триггеры из шаблонов
-  прототипы узлов сети, элементов данных и триггеров

::: noteclassic
Ознакомьтесь с официальными руководствами Zabbix для [общих рекомендаций \[en\]](https://www.zabbix.com/documentation/guidelines/en/thosts/configuration/templates#tag-name-and-value-format) по определению тегов, а также конкретными рекомендациями для [шаблонов \[en\]](https://www.zabbix.com/documentation/guidelines/en/thosts/configuration/templates#tags), [элементов данных \[en\]](https://www.zabbix.com/documentation/guidelines/en/thosts/configuration/template_items#tags),[триггеров \[en\]](https://www.zabbix.com/documentation/guidelines/en/thosts/configuration/template_triggers#trigger-tags) и [правил низкоуровневого обнаружения \[en\]](https://www.zabbix.com/documentation/guidelines/en/thosts/configuration/discovery_rules#tags).
:::

Теги предназначены для нескольких целей, в основном, для маркировки событий. Когда объект помечен тегом, любое новое событие, относящееся к помеченному объекту, унаследует его теги. Например:

-   для помеченных тегами шаблонов — любые проблемы узла сети (созданные триггерами из этого шаблона) унаследуют теги шаблона
-   для помеченных тегами узлов сети — любая проблема узла сети унаследует теги узла сети
-   для помеченных тегами элементов данных и веб-сценариев — любые проблемы по этому элементу данных или веб-сценарию унаследуют теги элемента данных или веб-сценария
-   для помеченных тегами триггеров — любая проблема, созданная этим триггером, унаследует теги триггера

Событие о проблеме наследует все теги со всей цепочки объектов — шаблонов, узлов сети, элементов данных, веб-сценариев, триггеров.
Идентичные комбинации `тег:значение` (после раскрытия макросов) объединяются в одну, что позволяет избегать дублирования.

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

-   [корреляция событий](/manual/config/event_correlation) может быть настроена на основе тегов событий;
-   [условия действия](/manual/config/notifications/action/conditions) могут быть настроены на основе тегов событий;
-   проблемы элементов данных могут быть сгруппированы на основе тегов событий;
-   теги проблем можно использовать для сопоставления проблем с [услугами](/manual/it_services/service_tree#теги-проблем).

Объект можно пометить тегами с одинаковыми именами, но разными значениями (например, `component:memory` и `component:storage`).
Аналогично, у объекта может быть тег без значения и тот же тег со значением (например, `database` и `database:postgresql`).
Такие теги не считаются дубликатами.

[comment]: # ({/46ecb366-700f39aa})

[comment]: # ({8abf52d8-1a2fe757})
#### Сценарии применения

Некоторые распространённые сценарии использования тегов:

1. Маркировка событий триггеров:
    -   Задайте тег на уровне триггера (например: `scope:performance`).
    -   Проблемы, созданные этим триггером, будут иметь тег триггера.

2. Маркировка проблем, унаследованных от шаблона:
    -   Задайте тег на уровне шаблона (например: `target:mysql`).
    -   Проблемы узлов сети, созданные триггерами из этого шаблона, будут иметь тег шаблона.

3. Маркировка проблем узла сети:
    -   Задайте тег на уровне узла сети (например: `service:Jira`).
    -   Проблемы, созданные триггерами этого узла сети, будут иметь тег узла сети.

4. Фильтрация связанных элементов данных:
    -   Задайте тег на уровне элемента данных (например: `component:cpu`).
    -   В разделе *Мониторинг* → [*Последние данные*](/manual/web_interface/frontend_sections/monitoring/latest_data#использование-фильтра) элементы данных могут быть отфильтрованы по тегу `component:cpu`.

5. Использование информации, извлечённой из значения элемента данных, в качестве значения тега:
    -   Задайте тег с макросом в качестве значения тега (например: `tag-name:{{ITEM.VALUE<N>}.regsub()}` ).
    -   В разделе *Мониторинг* → [*Проблемы*](/manual/web_interface/frontend_sections/monitoring/problems) проблемы будут иметь тег со значением, раскрытым в данные, извлечённые из значения элемента данных.

6. Идентификация проблем в файле журнала и закрытие их по отдельности:
    -   Задайте тег на уровне триггера для триггера [элемента данных файла журнала](/manual/config/items/itemtypes/zabbix_agent/log_items), который будет извлекать значения из значения элемента данных при помощи макроса (например: `{{ITEM.VALUE<N>}.regsub()}` ).
    -   В [настройках триггера](/manual/config/triggers/trigger#настройка) используйте [корреляцию событий](/manual/config/event_correlation):
        -   для параметра *Режим генерации событий ПРОБЛЕМА* выберите значение «Множественный»;
        -   для параметра *ОК событие закрывает* выберите значение «Все проблемы если значения тегов совпадают»;
        -   выберите тег для поиска совпадений.
    -   Проблемы, создаваемые трриггером элемента данных файла журнала, будут иметь тег триггера и будут закрываться по отдельности.

7. Фильтрация оповещений:
    -   Задайте теги на уровне триггеров (например: `scope:security` для триггер1 и `scope:availability` для триггер2).
    -   Используйте фильтрацию тегов в [условиях действий](/manual/config/notifications/action/conditions), чтобы получать оповещения только по тем событиям, которые соответствуют данным в тегах.

8. Идентификации проблем в оповещениях:
    -   Задайте теги на уровне триггера.
    -   Используйте макрос [{EVENT.TAGS}](/manual/appendix/macros/supported_by_location#события) в оповещении на проблемы.
    -   Оповещение на проблему будет содержать теги триггера, что упрощает идентификацию того, к какому приложению/сервису относится оповещение.

9. Упрощение задач настройки с использованием тегов на уровне шаблонов:
    -   Задайте тег для триггера на уровне шаблона.
    -   Триггеры, создаваемые из триггера этого шаблона, будут иметь его тег.

10. Создание триггеров с тегами из низкоуровневого обнаружения (LLD):
    -   Задайте теги для прототипа триггеров с макросом LLD в имени или значении тега (например: `scope:{#FSNAME}`).
    -   Триггеры, создаваемые из прототипа триггеров, будут иметь его тег.

11. Сопоставление услуг, используя теги услуг:
    -   Задайте [теги услуг](/manual/it_services/service_tree#теги-услуг).
    -   Настройте [действия на услуги](/manual/config/notifications/action) для услуг с соответствующими тегами.
    -   Кроме того, используйте теги услуг, чтобы связать услуги с [SLA](/manual/it_services/sla#настройка) для вычислений SLA.

12. Связывание услуг с проблемами, используя теги проблем:
    -   Задайте [тег проблемы](/manual/it_services/service_tree#теги-проблем) в [настройках услуг](/manual/it_services/service_tree#настройка-услуги), (например: `target:mysql`).
    -   Проблемы с соответствующим тегом будут автоматически соотнесены с этой услугой, а состояние услуги будет меняться в зависимости от настроенных правил расчёта состояния услуги. 

13. Подавление проблем, когда узел сети находится в режиме обслуживания:
    -   Задайте теги в *[настройках периода обслуживания](/manual/maintenance#настройка)*.
    -   Проблемы с заданными тегами будут подавлены.

14. Предоставление доступа группам пользователей:
    -   Укажите теги в [настройках группы пользователей](/manual/config/users_and_usergroups/usergroup#настройка).
    -   Пользователи в этой группе пользователей смогут просматривать только проблемы с заданными тегами.

[comment]: # ({/8abf52d8-1a2fe757})

[comment]: # ({4d9e4976-4793fc2c})
#### Настройка

Теги можно указать на отдельной вкладке, например, в [настройках триггера](/manual/config/triggers/trigger#настройка):

![](../../../assets/en/manual/config/tags_trigger.png){width="600"}

[comment]: # ({/4d9e4976-4793fc2c})

[comment]: # ({6506e720-aace9fc0})
#### Поддержка макросов

[Встроенные](/manual/appendix/macros/supported_by_location) и [пользовательские](/manual/config/macros/user_macros) макросы в тегах раскрываются во время события. До наступления события эти макросы отображаются в веб-интерфейсе Zabbix нераскрытыми.

[Макросы низкоуровневого обнаружения (LLD)](/manual/config/macros/lld_macros) раскрываются во время процесса обнаружения.

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

-   Встроенные макросы {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} и {HOST.ID}
-   Встроенные макросы {INVENTORY.\*} (для ссылки на значения инвентарных данных с одного или нескольких узлов сети в выражении триггера)
-   Пользовательские макросы и пользовательские макросы с контекстом (контекст может включать макросы низкоуровневого обнаружения)
-   Макросы низкоуровневого обнаружения (только в тегах прототипов триггеров)

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

-   Встроенные макросы {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} и {HOST.ID}
-   Встроенные макросы {INVENTORY.\*}
-   Пользовательские макросы
-   Макросы низкоуровневого обнаружения (только в тегах к прототипам узлов сети и элементов данных)

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

-   Встроенные макросы {EVENT.TAGS} и {EVENT.RECOVERY.TAGS} (эти макросы раскрываются в разделённый запятой список тегов событий или тегов событий о восстановлении)
-   Встроенные макросы {EVENT.TAGSJSON} и {EVENT.RECOVERY.TAGSJSON} (эти макросы раскрываются в JSON массив, содержащий [объекты](/manual/api/reference/event/object#тег-события) тегов событий или объекты тегов событий о восстановлении)

[comment]: # ({/6506e720-aace9fc0})

[comment]: # ({fc90f746-20ae36ff})
##### Извлечение подстроки в тегах к триггерам

Поддерживается извлечение подстроки для заполнения имени тега или значения тега при использовании [функции](/manual/config/macros/macro_functions) макросов.
Функция применяет регулярное выражение к значению, полученному [поддерживаемым](#поддержка-макросов) макросом. Например:

    {{ITEM.VALUE}.regsub(шаблон, вывод)}
    {{ITEM.VALUE}.iregsub(шаблон, вывод)}

    {{#LLDMACRO}.regsub(шаблон, вывод)}
    {{#LLDMACRO}.iregsub(шаблон, вывод)}

Имя тега и значение будут обрезаны до 255 символов, если их длина превысит 255 символов после раскрытия макросов.

Смотрите также: Использование функций макросов в [макросах низкоуровневого обнаружения](/manual/config/macros/lld_macros#использование-функций-макросов) для маркировки событий.

[comment]: # ({/fc90f746-20ae36ff})

[comment]: # ({4bdd15b8-048b2b9c})
#### Просмотр тегов событий

Маркировку, если задана, можно увидеть вместе с новыми событиями в:

-   *Мониторинг* → [*Проблемы*](/manual/web_interface/frontend_sections/monitoring/problems)
-   *Мониторинг* → *Проблемы* → [*Детали события*](/manual/web_interface/frontend_sections/monitoring/problems#просмотр-деталей)
-   *Панели* → [виджет *Проблемы*](/manual/web_interface/frontend_sections/dashboards/widgets/problems)

Порядок и количество отображаемых тегов определяется опциями *Приоритет отображения тегов (Tag display priority)*  и *Отображать теги (Show tags)* в разделе *Мониторинг* → *Проблемы* либо виджете панели *Проблемы*.
Обратите внимание, что можно отобразить максимум три тега; если тегов больше, то при наведении указателя мыши на многоточие все теги отобразятся во всплывающем окне.

![](../../../assets/en/manual/config/triggers/event_tags_view.png){width="600"}

[comment]: # ({/4bdd15b8-048b2b9c})