Обработка правил оповещения

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

Для настройки дополнительной маршрутизации необходимо создать получателей и маршруты. При необходимости добавления интервалов времени, в которые оповещения приходить не будут, задайте временные интервалы и укажите их в маршрутах.

Получатели

Страница “Получатели” представляет собой таблицу с полями:

  • Имя получателя (есть возможность фильтрации по имени)
  • Тип (есть выбор из ограниченного списка: default, webhook, email, telegram).

На странице есть возможность добавить нового получателя или удалить ранее созданный.

Получатель с названием devnull имеет тип default, создается по умолчанию и не может быть удален или изменен. Он блокирует отправку оповещений. При добавлении нового получателя тип default недоступен для выбора.

  • Имя получателя (обязательное поле)
  • Тип получателя: webhook, email, telegram;

В зависимости от выбранного типа получателя набор полей для конфигурации будет разным.

Webhook

  • Имя пользователя (необязательное поле. Используется для авторизации в паре с паролем. Не требуется при использовании Bearer-токена.);
  • Пароль (необязательное поле. Используется для авторизации в паре с именем пользователя. Не требуется при использовании Bearer-токена.);
  • Bearer-токен (необязательное поле. Используется для авторизации. Не требуется при использовании имени пользователя и пароля);
  • URL-прокси;
  • Отправлять решенные: инициирует отправку сообщения о том, что оповещение перестало быть актуальным. По умолчанию: да;
  • Максимальное количество оповещений, отправляемых в одном сообщении webhook: Максимальное количество предупреждений, отправляемых на одно сообщение веб-перехватчика. При значении 0 - включаются все оповещения;
  • URL-адрес (обязательное поле): эндпоинт для отправки HTTP-запросов;
  • Использовать TLS: да/нет (по умолчанию нет); При необходимости настроить безопасное соединение дополнительно необходимо ввести:
  • Имя сервера (обязательное поле);
  • Файл сертификата УЦ (обязательное поле) CAFile Файл сертификата удостоверяющего центра в формате base64;
  • Файл сертификата клиента (обязательное поле) Файл сертификата клиента в формате base64;
  • Файл ключа клиента (обязательное поле) Файл ключа клиента в формате base64;
  • Нужно ли отключить проверку сертификата (по умолчанию нет);

Обратите внимание! Файл сертификата должен содержать:

----BEGIN CERTIFICATE---- и ----END CERTIFICATE----

Telegram

  • Telegram API URL
  • Формат сообщения: Markdown, Markdownv2, HTML (по умолчанию HTML);
  • Токена бота (обязательное поле);
  • Идентификатор чата (обязательное поле);
  • Отправлять решенные: инициирует отправку сообщения о том, что оповещение перестало быть актуальным. По умолчанию: да;
  • Отключить уведомления: сообщения будут приходить без звукового уведомления (по умолчанию нет)
  • Шаблон уведомления в текстовом формате;
  • Использовать TLS: да/нет (по умолчанию нет);
  • Имя пользователя (необязательное поле. Используется для авторизации в паре с паролем. Не требуется при использовании Bearer-токена.);
  • Пароль (необязательное поле. Используется для авторизации в паре с именем пользователя. Не требуется при использовании Bearer-токена.);
  • Bearer-токен (необязательное поле. Используется для авторизации. Не требуется при использовании имени пользователя и пароля); При необходимости настроить безопасное соединение дополнительно необходимо ввести:
  • Имя сервера (обязательное поле);
  • Файл сертификата УЦ (обязательное поле) CAFile Файл сертификата удостоверяющего центра в формате base64;
  • Файл сертификата клиента (обязательное поле) Файл сертификата клиента в формате base64;
  • Файл ключа клиента (обязательное поле) Файл ключа клиента в формате base64;
  • Нужно ли отключить проверку сертификата (по умолчанию нет);

Email

  • Идентификатор авторизации: необходим для SMTP авторизации с использованием PLAIN.
  • Имя пользователя: необходимо для SMTP авторизации с использованием CRAM-MD5, LOGIN или PLAIN. Если авторизация не используется, оставьте поле незаполненным.
  • Пароль: необходим для SMTP авторизации с использованием CRAM-MD5, LOGIN или PLAIN. Если авторизация не используется, оставьте поле незаполненным.
  • Секрет авторизации: необходим для SMTP авторизации с использованием CRAM-MD5. Если авторизация с CRAM-MD5 не используется, оставьте поле незаполненным.
  • E-mail получателя: целевой e-mail-адрес для получения оповещений.
  • Служебные заголовки, состоящие из имени заголовка и тела заголовка;
  • Hostname для идентификации SMTP-сервера;
  • Шаблон уведомления в формате HTML
  • Отправлять решенные: инициирует отправку сообщения о том, что оповещение перестало быть актуальным. По умолчанию: да;
  • SMTP сервер (обязательное поле);

Временные интервалы

На странице временных интервалов вы можете определить интервалы месяцев, дней месяца, дней недели и часовых диапазонов для заглушения отправки оповещений. Эти интервалы используются в конфигурации маршрутов. Интервалы, охватывающие несколько смежных элементов времени, будут объединены в диапазоны. Для выделения можно использовать шифт. Кнопка “Выбрать всё” выбирает все элементы, повторное нажатие снимает выбор. Если в созданной конфигурации не задано ни одного значения, то это равнозначно выбранным всем значениям. Например, если вы указали дни недели, но не выбрали месяцы, то эти дни недели будут равнозначно выбраны в каждом месяце.

Блокировка оповещений

Определите, по каким критериям отправка оповещений должна быть заблокирована. Для этого введите:

  • Ключи лейблов оповещений (equel): ключи самих оповещений, не правил оповещений. Это могут быть: alertname, env, severity, namespace и др.
  • По каким значениям лейблов отправлять оповещения (target_matchers) - целевые лейблы оповещений, при совпадении значений которых, оповещения будут отправлены.
  • Не отправлять при наличии оповещений со значениями целевых лейблов (source_matchers) - оповещения с этими значениями в лейблах внутри группы не будут отправлены по - маршруту, пока есть нерешенные оповещения с целевыми лейблами

Маршруты

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

  • Получатель: выберите получателя из списка получателей. По умолчанию выбран дефолтный получатель.
  • Время ожидания до отправки первичных оповещений по группе: какой временной лаг должен пройти до первоначальной отправки оповещений. Может быть необходим для отбрасывания ложных срабатываний.
  • Время ожидания до отправки обновленных оповещений по группе: какой временной лаг должен пройти до отправки изменений по ранее отправленному оповещению.
  • Время ожидания до повторной отправки оповещений по группе: какой временной лаг должен пройти до повторной отправки ранее отправленных оповещений.
  • Совпадающие лейблы оповещений маршрутизации: выбрать лейблы для отправки по маршруту
  • Ключи совпадающих лейблов оповещений для группировки: по каким ключам сгруппировать оповещения среди выбранных в совпадающих лейблах.
  • Интервалы блокировки оповещения: выберите из ранее созданных интервалов, когда нужно приостанавливать отправку оповещений по маршруту.

Подмаршруты конфигурируют более детальную маршрутизацию оповещений среди групп, выбранных в корневом маршруте. В подмаршруте необходимо определить, требуется ли продолжить обработку оповещений одной группы в других подмаршрутах. Группа определяется в корневом маршруте.