Отправка сообщений в Telegram из Konso Observability

bolt

TL;DR

check_circleРезультат: алерт Konso Observability отправляет сообщение в Telegram-канал при срабатывании
check_circleНужно: Telegram-аккаунт для создания бота, доступ к Konso Dispatch и Observability
check_circleВремя на настройку: 15–20 минут
check_circleШаги: создать бота → получить chat ID → добавить провайдер в Dispatch → подключить к алерту → протестировать
check_circleПосле настройки смена канала или бота не требует изменений в коде приложения

Что вы настроите

В конце этого туториала алерт Konso Observability будет автоматически отправлять Telegram-сообщение при каждом срабатывании — с именем алерта, временем и ссылкой на детали. Для этого потребуется: создать Telegram-бота, добавить его в Konso Dispatch как провайдера и привязать провайдера к алерту.

Создайте Telegram-бота через BotFather

Откройте Telegram и найдите бота @BotFather. Отправьте команду /newbot, введите имя бота (например, «Konso Alerts») и username (должен заканчиваться на bot, например konso_alerts_bot). BotFather выдаст токен вида 1234567890:ABCdefGHIjklMNOpqrSTUvwxyz — сохраните его, он понадобится на шаге 3. [Скриншот: диалог с BotFather, выделен токен бота]

Получите Chat ID канала или группы

Добавьте созданного бота в Telegram-канал или группу, куда должны приходить уведомления. Для каналов дайте боту права администратора. Чтобы узнать Chat ID, отправьте любое сообщение в канал/группу, затем откройте в браузере: https://api.telegram.org/bot/getUpdates В ответе найдите поле chat.id — это числовое значение, например -1001234567890. Для каналов ID обычно отрицательный и начинается с -100. [Скриншот: ответ getUpdates с выделенным полем chat.id]

Добавьте Telegram-провайдер в Konso Dispatch

Перейдите в Konso → Utility → Messaging → Providers. Нажмите Add. В форме выберите Type = Telegram и заполните: - Provider Name: например «Telegram Alerts Bot» - Bot Token: токен от BotFather - Chat ID: значение из шага 2 - Отметьте Active Нажмите Save. Провайдер появится в списке. [Скриншот: форма добавления провайдера с заполненными полями Type=Telegram, Bot Token и Chat ID] [Скриншот: новый провайдер в списке со статусом Active]

Откройте алерт в Konso Observability

Перейдите в раздел Observability → Alerts. Откройте существующий алерт или создайте новый кнопкой Add. Если создаёте новый — настройте условие алерта: выберите метрику или уровень логов, задайте порог и временное окно. [Скриншот: список алертов в Konso Observability] [Скриншот: форма настройки условия нового алерта]

Подключите Telegram-провайдер к алерту

В настройках алерта найдите раздел Delivery Providers (или Notifications). Нажмите Add Provider и выберите созданного на шаге 3 Telegram-провайдера. Опционально настройте шаблон сообщения — можно использовать переменные: {{alertName}}, {{triggeredAt}}, {{value}}. Сохраните алерт кнопкой Save. [Скриншот: раздел Delivery Providers в настройках алерта с выбранным Telegram-провайдером]

Протестируйте уведомление

Нажмите кнопку Test (если доступна) или дождитесь реального срабатывания алерта. Проверьте Telegram-канал — уведомление должно прийти в течение нескольких секунд. Если сообщение не пришло — проверьте: - Бот добавлен в канал и имеет права на отправку сообщений - Chat ID указан корректно (для каналов — со знаком минус) - Провайдер отмечен как Active [Скриншот: пришедшее Telegram-сообщение с данными алерта]

lightbulb

Следующий шаг

Настройте шаблон сообщения алерта с переменными — добавьте имя сервиса, ссылку на логи и значение метрики. Так дежурный инженер получит всё необходимое прямо в Telegram, без перехода в интерфейс Konso.

Полезные материалы

Подробнее о возможностях Dispatch и маршрутизации сообщений:

check_circleЧто такое Konso Dispatch — /kb/guides/what-is-konso-dispatch
check_circleПравила маршрутизации Dispatch — /kb/guides/dispatch-routing-rules
check_circleШаблоны сообщений в Konso Dispatch — /kb/guides/dispatch-message-templates

Готово — алерты идут в Telegram

Подключите Konso и настройте уведомления для вашего проекта за 15 минут

Начать бесплатно arrow_forward

Частые вопросы

Можно ли отправлять алерты в личный чат Telegram, а не в канал? expand_more

Да. Отправьте боту любое сообщение в личку, затем вызовите getUpdates — в ответе будет chat.id вашего личного чата (положительное число). Используйте его как Chat ID в настройках провайдера.

Несколько алертов могут использовать одного провайдера? expand_more

Да, один Telegram-провайдер можно подключить к любому количеству алертов. Все они будут отправлять сообщения в один канал. Для разных каналов создайте отдельные провайдеры.

Как изменить канал, не трогая настройки алерта? expand_more

Отредактируйте провайдера в Dispatch (Providers → Edit) — обновите Chat ID. Все алерты, использующие этого провайдера, автоматически начнут отправлять сообщения в новый канал без изменений в самих алертах.

Что делать, если сообщения не приходят? expand_more

Проверьте три вещи: 1) бот добавлен в канал и имеет права администратора, 2) Chat ID указан правильно — для каналов он отрицательный и начинается с -100, 3) провайдер отмечен как Active в Dispatch. Для отладки вызовите getUpdates вручную с токеном бота.