Уведомления в Telegram, MAX и на почту

Наблюдатель присылает алерты в Telegram, в мессенджер MAX и на почту: сайт перестал отвечать, контейнер упал по нехватке памяти, диск сервера заполняется, сервис стал отвечать медленнее обычного. Каналы настраиваются один раз на весь проект и работают для всех его стеков и серверов.

В статье — как подключить каждый канал по шагам, как оставить в канале только важное и что проверить, если уведомления о падении сервера в Telegram не приходят.

#Как устроены уведомления

Уведомление проходит два шага:

1. Правило проекта замечает проблему и пишет событие в ленту стека или сервера с уровнем «Ошибка», «Предупреждение», «Инфо» или «Успех». Какие правила уже есть и как добавить свои — в статье правила уведомлений.
2. Канал решает, отправлять ли событие: канал должен быть включён, уровень события — отмечен в канале, а само событие — пройти фильтр канала, если он задан.

Правило без канала только пишет в ленту событий. Канал без подходящих правил молчит.

Каналы настраиваются в проекте: откройте проект, нажмите «Управление» и перейдите на вкладку «Уведомления». Вкладка доступна владельцу и участникам с ролью «Редактор». В проекте может быть по одному каналу каждого вида: один чат Telegram, один чат MAX и один список адресов почты.

Важно. Каналы общие для всех стеков проекта. Если уведомления staging или локального стенда не должны попадать в рабочий чат, вынесите их в отдельный проект — см. мониторинг при локальной разработке.

#Как настроить алерты в Telegram

Наблюдатель пишет в Telegram от имени вашего бота. Общего бота платформы для Telegram нет: без токена бота сообщения не отправятся.

#Шаг 1. Создайте бота

1. Откройте в Telegram @BotFather и отправьте команду /newbot.
2. Задайте имя и username бота, например shop_alerts_bot.
3. BotFather пришлёт токен вида 1234567890:AA…. Скопируйте его.

#Шаг 2. Узнайте chat id

Уведомления можно присылать в личный чат с ботом или в группу команды.

• Личный чат. Найдите бота в Telegram и нажмите «Start» — без этого бот не сможет вам написать.
• Группа. Добавьте бота в группу и отправьте в группе любое сообщение, например /start@shop_alerts_bot.

Затем откройте в браузере адрес ниже, подставив свой токен:

https://api.telegram.org/bot<токен>/getUpdates

В ответе найдите "chat":{"id": …}. У личного чата это положительное число, у групп — отрицательное, часто начинается с -100. Если ответ пустой, отправьте боту или в группу ещё одно сообщение и обновите страницу.

#Шаг 3. Заполните канал в кабинете

1. В проекте откройте «Управление» → «Уведомления».
2. В карточке «Telegram» включите переключатель.
3. В поле «Токен бота» вставьте токен от BotFather.
4. В поле «Чат или группа» укажите числовой chat id.
5. В блоке «О чём сообщать» отметьте нужные уровни (подробнее — ниже).
6. Нажмите «Сохранить» внизу вкладки.
7. Нажмите «Проверить отправку». В чат придёт проверочное сообщение, а в кабинете появится надпись «Проверочное сообщение отправлено.»

Токен хранится в зашифрованном виде и после сохранения больше не показывается: в поле видны точки. Заменить токен — кнопка «Изменить», удалить — «Сбросить».

Совет. «Проверить отправку» берёт chat id из поля, а токен — из сохранённых настроек. Поэтому сначала сохраните токен, а потом проверяйте.

#Как подключить MAX

Канал MAX устроен так же, как Telegram: сообщения отправляет бот, а вы указываете, в какой чат.

1. Создайте бота на платформе MAX для разработчиков и получите его токен.
2. Добавьте бота в чат, куда должны приходить уведомления, и узнайте id этого чата.
3. В проекте откройте «Управление» → «Уведомления», включите карточку «MAX».
4. Вставьте токен в поле «Токен бота», а id чата — в поле «Чат».
5. Отметьте уровни в блоке «О чём сообщать» и нажмите «Сохранить».
6. Нажмите «Проверить отправку» — в чат MAX придёт проверочное сообщение.

В MAX уведомления приходят обычным текстом, без форматирования, с тем же содержанием, что и в Telegram.

#Как настроить уведомления на почту

1. В проекте откройте «Управление» → «Уведомления», включите карточку «Email».
2. В поле «Адреса получателей» перечислите адреса через запятую: ops@example.com, cto@example.com.
3. Отметьте уровни в блоке «О чём сообщать» и нажмите «Сохранить».

Свой почтовый сервер настраивать не нужно: письма уходят с почты сервиса. Тема письма — заголовок события, например «Сайт недоступен» или «Превышен порог». Кнопки проверочного письма у почты нет — проверить канал можно только на реальном событии.

#Что приходит в уведомлении

Каждое сообщение начинается со значка уровня и заголовка события. Дальше идут стек, объект (проверка сайта, контейнер, сервер, хранилище S3, метрика), текст события и время в UTC. Пример уведомления в Telegram:

🛑 Контейнер: OOM

📦 Стек: prod
🐳 Контейнер: worker

💬 Контейнер OOM (worker)

ℹ️ Детали
exit_code=137; restart_count=2

🕐 2026-11-04 12:46:10 UTC

Значки уровней: 🛑 — ошибка, ⚠️ — предупреждение, ✅ — успех и восстановление, ℹ️ — информация. Для ошибок приложения в сообщение добавляются тип исключения, описание и фрагмент стека вызовов. Уведомления о нарушении цели сервиса и падениях сайтов приходят сразу с блоком «🔎 Причина» — вероятной причиной и цепочкой от симптома к ней. Подробнее — в статье аномалии и поиск причины.

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

#Сводки: когда сбой задел многое сразу

Один сбой часто тянет за собой десяток событий: упала база — следом сервисы, проверки сайтов, контейнеры. Чтобы чат не превращался в ленту, Наблюдатель группирует уведомления:

• «Ещё события». Первое уведомление о проблеме в стеке приходит сразу. Всё, что случилось в том же стеке за следующие 30 секунд, приходит одним сообщением «Ещё события» со списком. Если события идут и дальше, сводка приходит каждые 30 секунд.
• «Сводка уведомлений». Если в канал за минуту ушло больше 10 сообщений по всем стекам, дальше канал получает одну сводку в минуту, пока поток не утихнет: пока не пройдёт минута без новых событий.
• Источники метрик. Если в стеке разом перестали отвечать или снова заработали несколько источников метрик, приходит одно сообщение со списком.

В ленте событий стека при этом видно каждое событие по отдельности. Если вы ждали отдельного сообщения, а его нет, поищите событие в последней сводке.

#Уровни: о чём сообщать

В каждом канале есть четыре флажка уровней. Значения для нового канала:

Чтобы канал руководителя получал только аварии, оставьте в нём один уровень «Ошибка». Чтобы приходили и сообщения о том, что порог снова в норме, включите «Инфо».

Уровень события задаёт правило — поле «Уровень в ленте» в его настройках. Поэтому тишины по мелочам можно добиться и с другой стороны: поставить правилу уровень «Инфо», и оно останется только в ленте событий.

#Фильтр канала: только нужные события

Под уровнями есть блок «Расширенный фильтр». Если в нём ничего не отмечено, канал пропускает все события отмеченных уровней — рядом написано «любые события». Отметьте только нужное:

• «Откуда событие» — «Проверки сайтов», «Контейнеры и поды», «Серверы», «S3-хранилища», «Метрики приложения», «Сервисы (по трассам)», «Служебные»;
• «Что произошло» — конкретные события: «Сайт недоступен», «Контейнер: OOM», «Под в CrashLoopBackOff», «Превышен порог», «Цель сервиса нарушена», «Аномалия сервиса» и другие.

Событие должно пройти и уровни, и фильтр. Пример: дежурный чат Telegram только про сайты и падения контейнеров — отметьте «Проверки сайтов» и «Контейнеры и поды». Вернуть всё как было — «Сбросить — сообщать обо всём».

Совет. Если надоедает одна и та же ошибка приложения, не прячьте её фильтром канала — отключите уведомления по ней на странице ошибки. Подробнее — в статье про ошибки приложения.

#Почему не приходят уведомления

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

1. Канал выключен или не сохранён. Переключатель карточки должен стоять во «Вкл», а после правок нужно нажать «Сохранить».
2. Нет токена бота. При проверке появляется ошибка «укажите токен бота Telegram в настройках проекта». Вставьте токен и сохраните.
3. Неверный chat id или бот не в чате. Ошибка с текстом chat not found значит, что бота нет в этом чате или id указан неверно. В личном чате нажмите «Start», в группу бота нужно добавить.
4. Бот заблокирован или удалён из группы. Ошибка Forbidden — разблокируйте бота или добавьте его в группу снова.
5. Неверный токен. Ошибка Unauthorized — токен устарел или скопирован не полностью. Возьмите актуальный у BotFather и замените через «Изменить».
6. Уровень не отмечен. Например, «Порог в норме» и «Сервис вернулся к норме» имеют уровень «Инфо», а он по умолчанию выключен.
7. Событие отсекает фильтр. Раскройте «Расширенный фильтр»: если там «есть ограничения», убедитесь, что нужный тип события отмечен.
8. Правило выключено или его нет. Откройте вкладку «Правила»: часть типовых правил — диск, CPU, память — выключена, пока вы их не включите. Подробнее — в статье правила уведомлений.
9. Событие пришло в сводке. Если до него в том же стеке уже было уведомление, оно придёт в сообщении «Ещё события» или «Сводка уведомлений», а не отдельно.
10. Событие повторное. Пока состояние не изменилось, новое уведомление не приходит. А аномалия, которая повторилась 5 раз за сутки, считается нормой, и уведомления по ней прекращаются, пока она не станет реже.

Проверить, было ли событие вообще, можно в ленте событий стека или сервера — см. события и инциденты. Если событие в ленте есть, а сообщения нет, дело в канале. Если события нет, дело в правиле.

#Настройка через ИИ-ассистента

ИИ-ассистент видит каналы проекта и правила. Он может включить или выключить канал, поменять уровни и фильтр и отправить проверочное сообщение в Telegram или MAX. Токены ботов ассистент не принимает и не показывает: их вводят только в кабинете. Подробнее — в статье ИИ-ассистент по MCP.

#Что дальше

• Правила уведомлений — какие правила уже есть и как добавить свои.
• Аномалии и поиск причины — уведомления без порогов и с причиной сбоя.
• Проверки сайтов — когда сайт считается недоступным или медленным.
• Участники и роли — кто может настраивать уведомления.