Быстрый старт: первое оповещение

Сквозной пример настройки оповещения в Proto Observability Platform: создать канал доставки, правило и политику маршрутизации и получить первое уведомление в Telegram.
Tags:

На этой странице:

Этот сценарий показывает, как с нуля получить оповещение в Telegram при росте доли ошибок сервиса. Он связывает три сущности алертинга воедино; подробное описание каждого поля — в руководстве Настройка оповещений.

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

Шаг 1. Канал доставки

Сначала создадим канал — адрес доставки уведомлений.

  1. Откройте Алерты > Каналы, нажмите «Добавить».
  2. Укажите Название (например, Telegram дежурной смены) и Тип — Telegram.
  3. Заполните Токен бота и Telegram ID (идентификатор чата).
  4. Сохраните канал.

Подробнее о полях и других типах каналов (email, webhook) — Настройка оповещений → Создание канала.

Шаг 2. Правило алертинга

Теперь зададим условие срабатывания.

  1. Откройте Алерты > Правила, нажмите «Добавить».
  2. Заполните поля:

    • Название: Высокая доля ошибок сервиса;

    • Группа: например, GENERAL;

    • Критичность: WARNING;

    • Описание: Доля ошибок сервиса выше 5% в течение 5 минут;

    • Выражение:

      avg(services_errorcallsperc{service="credit-bureau-service"}) by (service, service_id) > 5

    • for: 5m — алерт сработает, только если условие держится 5 минут.

  3. Нажмите «Создать», затем включите правило (статус включено).
  4. Нажмите «Применить» — изменения вступят в силу в течение ~1 минуты.

Замените credit-bureau-service на имя своего сервиса. Список доступных метрик и синтаксис выражений — Метрики и выражения для правил; описание полей формы — Настройка оповещений → Создание правила.

Шаг 3. Политика маршрутизации

Свяжем сработавший алерт с каналом из шага 1.

  1. Откройте Алерты > Политики, нажмите «Добавить».
  2. В Лейблах группировки оставьте, например, alertname и service.
  3. В Каналах оповещения выберите канал Telegram дежурной смены.
  4. Добавьте матчер: ключ severity, оператор =, значение WARNING — политика будет ловить алерты этой критичности.
  5. Задайте Порядок (например, 1) и сохраните.
  6. Нажмите «Применить».

Подробнее — Настройка оповещений → Создание политики.

Шаг 4. Проверка

Когда доля ошибок сервиса превысит 5% дольше 5 минут:

История сработавших алертов доступна в Алерты > История.

Если уведомление не пришло

Проверьте по порядку:

  • нажата ли «Применить» после изменения правил и политик;
  • правило в статусе включено, а не отключено;
  • алерт уже в статусе firing, а не pending (условие должно продержаться время из поля for);
  • лейблы алерта совпадают с матчерами политики (в примере — severity = WARNING);
  • реквизиты канала верны (токен бота, Telegram ID).

Полный разбор причин и формат уведомлений — Диагностика и формат уведомлений.