Алерты и уведомления

Настройка в кабинете → Настройки проекта. Все каналы используют общий minLevel.

Схема потока данных

Где настраивать

Кабинет → Проект → Настройки проекта. Для каждого проекта — отдельные Telegram, email, webhooks и минимальный уровень алерта (minLevel: error, warning, info).

Создайте бота через @BotFather и получите токен (на сервере DevLogs — env TELEGRAM_BOT_TOKEN).
Узнайте chat id (личный чат или группа) и вставьте в настройках проекта.
Включите уведомления и выберите minLevel.

Email отправляется только для выбранных типов событий (новая issue, регрессия, всплеск) — не при каждом повторе той же ошибки. Лимиты интервала и писем в час настраиваются в кабинете.

Email

Укажите адрес получателя и включите email-уведомления. На сервере должен быть настроен SMTP (AUTH_EMAIL_SERVER, AUTH_EMAIL_FROM в .env).

Поле	Описание
notificationEmail	Адрес для алертов
emailNotifyNewIssue	Письмо при новой группе ошибок
emailNotifyRegression	Письмо, если resolved/ignored issue снова активна
emailNotifyBurst	Письмо при всплеске событий по одной issue (порог — webhookBurstThreshold)
emailNotifyIntervalMinutes	Минимальный интервал между любыми письмами по проекту (по умолчанию 60 мин)
emailNotifyMaxPerHour	Максимум писем в час на проект (по умолчанию 10)
minLevel	Минимальный уровень события для отправки

Webhooks

HTTP POST на ваш URL при событиях issue. Настраиваются в блоке Webhooks настроек проекта.

Событие	Когда
issue.created	Создана новая группа ошибок
issue.resolved	Issue отмечена resolved в кабинете или через REST API

Подпись запроса: заголовок X-DevLogs-Signature: sha256=… (HMAC-SHA256 тела с секретом webhook). Секрет показывается один раз при создании.

Тело webhook

{
  "event": "issue.created",
  "timestamp": "2026-06-07T12:00:00.000Z",
  "project": { "id": "clx…", "name": "Моё приложение" },
  "issue": {
    "id": "clxissue…",
    "type": "TypeError",
    "level": "error",
    "message": "Cannot read …",
    "status": "unresolved",
    "fingerprint": "abc…"
  }
}

Проверка подписи на стороне сервера: HMAC-SHA256 от сырого тела JSON с вашим secret, сравнение с значением после sha256=.

S3 (не алерт)

Блок S3 в настройках — только для source maps, не для событий ingest. Подробнее в документации по source maps.