Для чего нужен раздел
Правило сравнивает показатель с заданным порогом и отправляет уведомление в выбранные каналы. Кнопка проверки запускает правила вручную. Для проверки по расписанию администратору нужно включить ALERTS_AUTORUN_ENABLED в настройках сервера.
Когда использовать
- Когда изменение показателя требует реакции команды.
- После инцидента, если известен показатель, по которому можно заметить повторение проблемы.
- Когда хотите получать уведомления о выходе показателя за согласованный порог.
Первые шаги
- 1Сначала настройте каналы доставки — почта, Slack, Telegram или вебхук — в разделе уведомлений об инцидентах: без них правилу некуда доставлять.
- 2Создайте правило: выберите тип, оператор и порог.
- 3Выберите каналы, которые оно должно уведомлять.
- 4Кнопкой проверки вычислите правила сразу, не дожидаясь расписания.
Настройки
| Настройка | Что делает | Как настроить | Типичная ошибка |
|---|---|---|---|
| Тип оповещения | За чем следит правило: bus factor, падение скорости, узкое место в ревью, пробел в знаниях или снижение качества. | Для каждого правила договоритесь, кто получит сообщение и что проверит после него. | Включить много правил, не определив, кто будет реагировать на сообщения. |
| Оператор и порог | Сравнение, при котором правило срабатывает. | Сравните порог с недавними значениями команды, чтобы обычные колебания не вызывали лишних сообщений. | Задать порог внутри обычного диапазона показателя и получать постоянные повторные уведомления. |
| Каналы доставки | Куда уходит уведомление. | Выберите канал, который читает ответственный за реакцию, и проверьте доставку. | Слать всё в общий канал, где оно конкурирует с уведомлениями о сборках. |
Пример использования
Ситуация: В критичном репозитории bus factor упал до единицы, и заметили это только при передаче дел.
- 1Создайте правило по bus factor с оператором «меньше» и порогом 2.
- 2Направьте его в командный канал, а не в личку.
- 3Кнопкой проверки убедитесь, что правило срабатывает, а при необходимости включите автоматические проверки на сервере.
Что станет понятно: Вы проверили уведомление о низком bus factor и настроили канал, в котором команда его увидит. Регулярные проверки требуют включённого автозапуска.
Частые вопросы
Почему нельзя выбрать канал?
Активных каналов доставки ещё нет. Создайте канал в разделе уведомлений об инцидентах — до этого правилу просто некуда доставлять.
Как часто вычисляются правила?
Кнопка проверки запускает вычисление сразу. Фоновая проверка работает раз в час по умолчанию, если включён ALERTS_AUTORUN_ENABLED; по умолчанию автоматический запуск выключен.
Ничего не сработало, хотя порог пересекли. Почему?
Проверьте, что правило включено, что выбран хотя бы один активный канал и что значение было за порогом именно в момент вычисления, а не между двумя прогонами.
Практические советы
- Начните с одного правила и проверьте его срабатывание и доставку.
- Периодически пересматривайте пороги и получателей. Если сообщение не требует действий, уточните правило или отключите его.