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

Mon, 01 Jan 0001 00:00:00 +0000

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

Шаг 1. Канал доставки
Шаг 2. Правило алертинга
Шаг 3. Политика маршрутизации
Шаг 4. Проверка
Если уведомление не пришло

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

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

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

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

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

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

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

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

Откройте Алерты > Правила, нажмите «Добавить».
Заполните поля:
- Название: Высокая доля ошибок сервиса;
- Группа: например, GENERAL;
- Критичность: WARNING;
- Описание: Доля ошибок сервиса выше 5% в течение 5 минут;
- Выражение:
```
avg(services_errorcallsperc{service="credit-bureau-service"}) by (service, service_id) > 5
```
- for: 5m — алерт сработает, только если условие держится 5 минут.
Нажмите «Создать», затем включите правило (статус включено).
Нажмите «Применить» — изменения вступят в силу в течение ~1 минуты.

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

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

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

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

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

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

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

алерт появится в разделе Алерты > Активные (см. Просмотр алертов и событий);
уведомление придёт в указанный Telegram-чат.

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

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

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

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