TWC Alert Bot — аддон для Kubernetes, который отправляет уведомления о событиях в кластере в Telegram, Discord или Slack. Он отслеживает рестарты подов, ошибки liveness- и readiness-проб, недоступность нод и другие потенциально критичные события. Дополнение поможет быстро реагировать на проблемы и поддерживать стабильность инфраструктуры.
Установка
Перейдите во вкладку «Дополнения» в панели управления кластером и нажмите на карточку аддона «TWC Alert Bot».
Обязательный параметр для работы уведомлений — clusterName. Это произвольное имя кластера, которым будут подписываться уведомления. По умолчанию используется имя кластера.
Параметры для подключения Telegram, Slack или Discord описаны в разделе о настройке уведомлений.
Можно указать, какие неймспейсы отслеживать, с помощью параметра:
Если нужно получать уведомления только из конкретных неймспейсов — укажите их через запятую:
Также можно исключить из наблюдения определенные поды. Для этого используется параметр exceptions. Можно указывать как точные имена подов, так и части имен. Если имя пода совпадает с одной из строк — алерт по нему не придет.
Сами уведомления настраиваются в секции alerts: в манифесте. Доступные варианты:
|
Параметр |
Описание |
|
|
Алерты по рестартам контейнеров в подах |
|
|
Алерты при создании и удалении подов |
|
|
Алерты при создании и удалении деплойментов |
|
|
Алерты при создании и удалении сервисов |
|
|
Алерты по зависшим или ошибочным подам ( |
|
|
Алерты по сбоям |
|
|
Алерты при переходе ноды в состояние |
|
|
Алерты по превышению порогов CPU/Memory на нодах |
|
|
Алерты по прочим Warning-событиям (например, |
После настройки нажмите «Установить».
Проверьте, что установка завершена корректно. Для этого выполните команду
Вы увидите примерно такой вывод:
Настройка уведомлений
Чтобы получать уведомления от бота, подключите один или несколько мессенджеров.
Чтобы бот отправлял уведомления в Telegram, укажите в конфигурации:
Обязательные параметры для работы уведомлений:
telegramBotToken— токен, полученный с помощью бота @BotFather.telegramChatId— ID чата или канала, в который будут отправляться уведомления.clusterName— произвольное имя кластера, которым будут подписываться уведомления.
Получение токена
Токен необходим для управления ботом. Для создания бота перейдите к @BotFather. Создайте нового бота, отправив команду /newbot. Затем укажите имя и юзернейм бота. После этого @BotFather пришлет токен нового бота.
Получение токена в интерфейсе Telegram®
Этот токен необходимо указать в конфигурации дополнения:
Добавьте созданного бота в группу или канал с правом на отправку сообщений.
Получение ID чата
Бот может взаимодействовать с пользователями в канале, группе или личном чате. Чтобы получить нужный chat_id, выполните одно из следующих действий:
- Добавьте бота в группу
- Добавьте бота в канал в качестве администратора
- Откройте личный чат с ботом
После этого отправьте любое сообщение в соответствующий чат (группу, канал или личный).
Затем откройте в браузере ссылку:
Вы увидите JSON с последними сообщениями, полученными ботом. Найдите блок chat.id — он содержит нужный идентификатор:
- Для групп и каналов — значение будет отрицательным.
- Для личных чатов — положительным.
В конфигурации дополнения укажите полученный ID:
По умолчанию также включен параметр:
Благодаря этому параметру бот сразу после установки попытается отправить тестовое сообщение. Если все подключено корректно, вы его увидите.
На этом настройка завершена.