Теги событий

Обзор

В Zabbix имеется возможность задавать собственные теги событий. Теги можно задавать на уровнях шаблона, узла сети и триггера.

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

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

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

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

Теги событий реализованы парой имя тега и значение. Вы можете использовать только имя или пару имени со значением:

MySQL, Сервис:MySQL, Сервисы, Сервисы:Клиент, Приложения, Приложение:Java, Приоритет:Высокий

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

Сценарии применения

Некоторые сценарии использования этой функции заключаются в следующем:

Маркировка событий в веб-интерфейсе

   * Добавьте теги на уровне триггера;
          * Смотрите как все проблемы триггеров маркируются этими тегами в //Мониторинг// → //Проблемы//.
       - Маркировка всех проблем унаследованных с шаблонов
          * Добавьте тег на уровень шаблона, например 'App=MySQL';
          * Смотрите как эти проблемы узла сети, которые создаются триггерами из этого шаблона, маркируются этими тегами в //Мониторинг// → //Проблемы//.
       - Маркировка всех проблем узла сети
          * Добавьте тег на уровень узла сети, например 'Service=JIRA';
          * Смотрите как все проблемы триггеров узла сети маркируются этими тегами в //Мониторинг// → //Проблемы//
       - Распознавание проблем в файле журнала и раздельное их закрытие
          * Добавьте теги в триггер к журналу, которые будут распознавать события, используя значение извлеченное при помощи макроса ''%%{{%%ITEM.VALUE<N>}.regsub()}''; 
          * В настройках триггера укажите режим формирования множественных проблема событий;
          * В настройках триггера используйте [[:ru/manual/config/event_correlation|корреляцию событий]]: выберите опцию, которая закроет ОК события только в случае совпадения событий и укажите тег поиска совпадений;
          * Просматривайте события о проблемах созданные с тегом и закрытые по отдельности.
       - Использование тегов для фильтрации оповещений
          * Добавьте теги на уровне триггера, чтобы промаркировать события при помощи различных тегов; 
          * Используйте фильтрацию по тегу в условиях действия чтобы получать оповещения только по тем событиям, которые совпадают с данными тега.
       - Использование информации извлеченной из значения элемента данных значением тега
          * Используйте макрос ''%%{{%%ITEM.VALUE<N>}.regsub()}'' в значении тега; 
          * Просматривайте значения тегов в //Мониторинг// → //Проблемы// как извлеченные данные из значения элемента данных.
       - Лучшее распознавание проблем в оповещениях
          * Задайте теги на уровне триггера;
          * Используйте макрос {EVENT.TAGS} в оповщеениях на проблемы; 
          * В итоге более простое распознавание о каких приложениях/сервисах идет речь в оповещении.
       - Упрощение задач настройки при использовании тегов на уровне шаблона
          * Задайте теги на уровне шаблонного триггера; 
          * Просматривайте эти теги у всех триггеров созданных из шаблонных триггеров.
       - Создание триггеров с тегами из низкоуровневого обнаружения (LLD)
          * Задайте теги прототипам триггеров; 
          * Используйте LLD макросы в имени тега или значении;
          * Просматривайте эти теги у всех триггеров созданных из прототипов триггеров.

Настройка

Теги событий задаются в:

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

Теги событий можно задавать для триггеров, триггеров с шаблонов и прототипов триггеров.

Поддержка макросов

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

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

Можно использовать макросы {EVENT.TAGS} и {EVENT.RECOVERY.TAGS} в оповещениях на основе триггеров и они будут раскрыты в разделенный запятыми список тегов события или тегов события восстановления.

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

Макросы {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} и {HOST.ID}
Макросы {INVENTORY.*}
Пользовательские макросы

Извлечение подстроки в тегах триггеров

Поддерживается извлечение подстроки для заполнения имени тега или значения тега при использовании новой функции макросов - применение регулярного выражения к значению полученному при помощи {ITEM.VALUE}, {ITEM.LASTVALUE} макросов, а также макросов низкоуровневого обнаружения. Например:

{{ITEM.VALUE}.regsub(шаблон, вывод)}
       {{ITEM.VALUE}.iregsub(шаблон, вывод)}
       
       {{#LLDМАКРОС}.regsub(шаблон, вывод)}
       {{#LLDМАКРОС}.iregsub(шаблон, вывод)}

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

Смотрите также: Использование функций макросов в макросах низкоуровневого обнаружения для тегирования событий.

Просмотр тегов события

Теги событий, если заданы, можно просмотреть с новыми событиями в:

Мониторинг → Проблемы
Мониторинг → Проблемы → Детали события
Мониторинг → Панель → виджет Проблемы (во всплывающем окне, которое открывается при наведении курсора мыши на имя проблемы)

Отображаются только первые три записи тегов. Если имеется более трех записей тегов, такой факт будет обозначен тремя точками. Если вы проведете курсором мыши над этими тремя точками, во всплывающем окне отобразятся все записи тегов.

Обратите внимание, что на порядок в котором отображаются теги влияет фильтрация тегов и опция Приоритет отображения тегов в фильтре Мониторинг → Проблемы или в виджете панели Проблемы.

Documentation