Каналы уведомлений

Канал — это место, куда правило алерта присылает уведомление. Каналы создаются один раз и потом подключаются к любым правилам. Вкладка: Автоматизация → Каналы.

Вкладка «Каналы» с кнопкой добавления канала доставки

Добавить канал — форма с типом канала, названием и полями, которые зависят от типа.

Типы каналов

Поле	Что вводить
Токен бота	Токен, который выдаёт @BotFather.
Chat ID	ID личного чата или группы, например `-1001234567890`.

Как узнать Chat ID: напишите боту @userinfobot или вызовите getUpdates у своего бота после первого сообщения в чат. Бот должен быть добавлен в группу, иначе сообщения не придут.

Slack

Поле Webhook URL — адрес Incoming Webhook. Создайте его в настройках приложения Slack и вставьте сюда.

Email

Поле Email — адрес, куда придёт письмо. Тема письма: Alert: <название правила>.

Вебхук

Поле URL — адрес вашего сервера. Секрет подписи система генерирует сама при создании канала. Он показывается один раз в диалоге создания, с кнопкой копирования. Сохраните его сразу. Позже секрет не показывается: если он потерян, создайте канал заново.

Запрос на ваш URL:

POST, Content-Type: application/json;
заголовки X-Webhook-Event: alert_fired и X-Webhook-Signature;
тело {"event":"alert_fired","data":{...}}, где data — объект с параметрами срабатывания: правило, метрика, значение, выборка, разрез, действие и время.

Подпись — HMAC-SHA256 от сырого тела запроса вашим секретом, в hex. Это та же схема, что у исходящих вебхуков: считайте подпись по сырому телу, а не по пересобранному JSON.

Что видно в списке

Список показывает тип, название, chat ID для Telegram, email или URL для вебхука и статус. Секреты (токен бота, Slack URL, секрет вебхука) хранятся зашифрованными и в списке не отображаются.

Каналы нельзя редактировать и нельзя проверить кнопкой «отправить тест». Если канал нужно поменять, удалите и создайте заново.

Доставка

Уведомления ставятся в очередь и отправляются фоновым процессом каждую минуту.
Таймаут запроса — 5 секунд.
Если доставка не удалась, повторные попытки через 1, 5 и 15 минут. Всего до 4 попыток.

Как проверить, что канал работает

Создайте канал.
Создайте правило с мягким порогом, которое точно сработает, например «клики больше 0 за 1 час», минимальный размер выборки 1, cooldown 5 минут.
Подождите до 5 минут: проверка правил идёт каждые 5 минут.
Удалите тестовое правило.

Права

Создавать и удалять каналы могут владелец, администратор и редактор. Наблюдатель их не меняет.

API

/api/v1/alerts/channels — только с сессией (JWT). Ключи API сюда не допускаются.