Документация Grafana Документация GlaberGraph Оповещения Настройка уведомлений Настройка точек контакта Telegram

Настройка Telegram для Alerting

Используйте интеграцию Grafana Alerting — Telegram, чтобы отправлять Telegram уведомления при срабатывании ваших оповещений.

Перед началом

Ограничение Telegram

Сообщения Telegram ограничены 4096 символами UTF-8. Если вы используете parse_mode, отличный от None, усечение может привести к недопустимому сообщению, что вызовет сбой уведомления. Для более длинных сообщений мы рекомендуем использовать альтернативный способ связи.

Telegram bot API token и chat ID

Чтобы интегрировать Grafana с Telegram, вам нужно получить Telegram bot API token и chat ID (ID чата Telegram, где вы хотите получать уведомления об оповещениях). Для выполнения интеграции используйте браузерную версию Telegram.

Настройка вашего Telegram-бота

Создайте Telegram-бота. Вы можете связать этого бота с вашими чатами и выполнять с его помощью разные действия, например получать оповещения из Grafana.

Чтобы настроить бота, выполните следующие шаги.

1. Откройте приложение Telegram на вашем устройстве.
2. Найдите Telegram-бота с именем BotFather.
3. Введите или нажмите /newbot.
4. Выберите имя для бота. Оно должно заканчиваться на bot или _bot. Например, “my_bot”.
5. Скопируйте API token.

Chat ID

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

1. В приложении Telegram откройте группу или создайте новую.

2. Найдите и добавьте бота в группу.

3. Скопируйте chat ID из URL в адресной строке браузера. Он должен выглядеть так: https://web.telegram.org/a/#-4266674385.

   Chat ID — это последовательность цифр после символа #. Например: -4266674385.

Процедура

Чтобы создать вашу интеграцию Telegram в Grafana Alerting, выполните следующие шаги.

1. Перейдите в Alerts & IRM -> Alerting -> Notification configuration, затем выберите вкладку Contact points.

2. Нажмите + Add contact point.

3. Введите имя точки контакта.

4. В списке Integration выберите Telegram.

5. В поле BOT API Token вставьте API token бота.

6. В поле Chat ID вставьте chat ID.

7. Нажмите Test, чтобы проверить работу вашей интеграции.

   ** Только для Grafana Alertmanager.

8. Нажмите Save contact point.

Дальнейшие шаги

Точка контакта Telegram готова принимать уведомления об оповещениях.

Чтобы добавить эту точку контакта к вашему оповещению, выполните следующие шаги.

1. В Grafana перейдите в Alerting > Alert rules.
2. Отредактируйте или создайте новое правило оповещения.
3. Прокрутите вниз до раздела Configure labels and notifications.
4. В разделе Notifications нажмите Select contact point.
5. В выпадающем меню выберите ранее созданную точку контакта.
6. Нажмите Save rule and exit.