Настройка оповещений в Telegram

Для настройки оповещений в Telegram в Grafana необходимо выполнить следующие шаги:

Создать и настроить Telegram-бота.
Подключить Telegram-бота к Grafana.
Настроить точку контакта для отправки оповещений через Telegram.
Добавить созданную точку контакта в политику уведомлений для маршрутизации оповещений.

Настройка Telegram-бота

Для создания и настройки Telegram-бота:

Откройте приложение Telegram на вашем устройстве.
Найдите бота с именем @BotFather.
Отправьте команду /newbot.
Введите название бота, например, SIEM Notifier.
Введите имя пользователя для бота. Имя должно оканчиваться на "bot" или "_bot", например, siemnotifybot.
Сохраните значение токена, предоставленное в ответе.
Создайте групповую беседу или откройте уже существующую в приложении Telegram.
Добавьте созданного бота в эту группу, найдя его по имени пользователя.
Скопируйте идентификатор чата из URL-адреса в адресной строке браузера. Адрес должен выглядеть примерно так: https://web.telegram.org/a/#-4266605675. Идентификатор чата — это последовательность чисел, следующих за символом #. Например, -4266605675.

После настройки Telegram-бота, выполните следующие шаги для его интеграции с Grafana:

Выполните вход в веб-интерфейс Grafana.
Перейдите в Alerting → Contact points.
Нажмите New contact point, чтобы создать новую точку контакта.
Введите имя точки контакта в поле Name.
В списке Contact point type выберите Telegram.
Укажите настройки Telegram:
- BOT API Token — токен Telegram-бота.
- Chat ID — ID чата в Telegram.
В разделе Optional Telegram settings (опционально):
1. Включите опцию Disable resolved message, чтобы не получать сообщения о разрешении оповещения.
2. Включите опцию Include image, чтобы добавить изображение в оповещение.
Нажмите Test для отправки тестового сообщения и проверки работы интеграции.
Нажмите Save contact point, чтобы сохранить настройки.

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

Для добавления точки контакта в политику уведомлений выполните следующие шаги:

Перейдите в Alerting → Notification policies.
Убедитесь, что в выпадающем меню Choose Alertmanager выбран Grafana.
В секции Root policy - default for all alerts нажмите Edit.
В поле Default contact point выберите созданную ранее точку контакта для оповещений через Telegram.
В разделе Group by выберите метки, по которым будут группироваться оповещения (опционально).
Настройте параметры времени в разделе Timing options (опционально):
1. Group wait — время ожидания перед отправкой первого уведомления для новой группы.
2. Group interval — минимальный интервал времени между отправкой уведомлений в группе.
3. Repeat interval — минимальный интервал времени для повторной отправки уведомления, если в группе не было добавлено новых оповещений.
Нажмите Save, чтобы сохранить изменения.

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