Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

Теги события

Обзор

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

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

MySQL, Service:MySQL, Services, Services:Customer, Applications, Application:Java, Priority:High 

Примеры использования

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

  1. Определить проблемы в файле журнала и закрыть их отдельно:
    • Определите теги в триггере журнала, которые будут определять события, используя макрос {{ITEM.VALUE<N>}.regsub()} для извлечения значений;
    • В конфигурации триггера есть режим генерации нескольких проблемных событий;
    • В конфигурации триггера используйте корреляцию событий: выберите опцию, чтобы событие OK закрывало только совпадающие события, и выберите тег для сопоставления;
    • Просматривайте проблемные события, созданные с помощью тега и закрытые по отдельности.
  2. Использовать теги для фильтрации уведомлений:
    • Определите теги на уровне триггера, чтобы пометить события различными тегами;
    • Используйте фильтрацию тегов в условиях действия, чтобы получать уведомления только о событиях, соответствующих данным тега.
  3. Смотреть информацию о тегах событий в веб-интерфейсе:
    • Определите теги на уровне триггера, чтобы пометить события различными тегами;
    • Смотрите эту информацию в МониторингПроблемы.
  4. Использовать информацию, извлеченную из значения элемента, в качестве значения тега:
    • Используйте макрос [](/ITEM.VALUE<N>}.regsub()} в поле значения тега; * Смотрите значения тегов в //Мониторинг// → //Проблемы// как извлеченные данные из значения элемента.

      • Точнее выявлять проблемы в уведомлениях/
        • Определите теги на уровне триггера;
        • Используйте макрос {EVENT.TAGS} в уведомлениях о проблемах;
        • Таким образом проще определить, к какому приложению/услуге относится уведомление.
      • Упростить задачи настройки с помощью тегов на уровне шаблона/
        • Определить теги на уровне запуска шаблона;
        • Просмотрите эти теги на всех триггерах, созданных из триггеров шаблонов.
      • Создать триггеры с тегами низкоуровневого обнаружения/
        • Определите теги на прототипах триггеров;
        • Используйте макросы LLD в имени или значении тега;
        • Теги будут использованы на всех триггерах, созданных из прототипов триггеров.

      === Настройка ===

      Теги событий определяются в конфигурации триггера. Теги событий могут быть определены для триггеров, триггеров шаблонов и прототипов триггеров.

      {{../../../../../assets/en/manual/config/triggers/event_tags.png)

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

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

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

Извлечение подстроки поддерживается для заполнения имени тега или значения тега, используя функцию макросов regsub чтобы применить регулярное выражение к значению, полученному макросом {ITEM.VALUE}.

{{ITEM.VALUE}.regsub(pattern, output)}
       {{ITEM.VALUE}.iregsub(pattern, output)}

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

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

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

  • МониторингПроблемы
  • МониторингПроблемыДетали события

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

Viewing event tags

Event tags, if defined, can be seen with new events in:

  • MonitoringProblems
  • MonitoringProblemsEvent details
  • MonitoringDashboardProblems widget (in popup window that opens when rolling the mouse over problem name|

Only the first three tag entries are displayed. If there are more than three tag entries, it is indicated by three dots. If you roll your mouse over these three dots, all tag entries are displayed in a pop-up window.

Note that the order in which tags are displayed is affected by tag filtering and the Tag display priority option in the filter of MonitoringProblems or the Problems dashboard widget.