Telegram-алерты
Flaree отправляет уведомления об инцидентах в Telegram — обычно сообщение приходит за 1–2 секунды после смены статуса компонента. Каналы уведомлений: Telegram, Email и Webhook.
Предварительные требования
- Работающий агент и хотя бы одна проверка (см. быстрый старт).
- Telegram-бот. Создайте его через
@BotFatherкомандой/newbotи сохраните токен бота. - Бот добавлен в целевой чат или канал. Для каналов боту нужны права на отправку сообщений.
warning
Токен бота — секрет. Не публикуйте его в репозиториях и логах; при утечке перевыпустите через @BotFather → /revoke.
Настройка в дашборде
- Откройте Integrations → Telegram.
- Вставьте токен бота.
- Выберите чат из списка. Если чата нет — отправьте в него любое сообщение, чтобы бот его «увидел», и обновите список.
- Сохраните и нажмите Send test — в чат придёт тестовое сообщение.
Тестовый инцидент
Проверьте цепочку целиком: остановите проверяемый сервис или создайте тестовый инцидент в разделе Incidents. Когда проверка провалится, Flaree откроет инцидент и отправит уведомление.
В сообщении будет:
- имя компонента и новый статус;
- время начала инцидента;
- какая проверка провалилась и с какой ошибкой;
- ссылка на инцидент в дашборде.
При закрытии инцидента придёт отдельное сообщение о восстановлении.
подсказка
Чтобы дежурных не будило каждое мигание, настройте Flap-Guard и Cooldown в правилах компонента — уведомление уйдёт только после подтверждённой смены статуса.
Troubleshooting
- Сообщения не приходят. Убедитесь, что бот всё ещё в чате: администратор мог его удалить. Проверьте, что тестовое сообщение из дашборда доходит.
- Бот не видит чат. У ботов ограничен доступ к истории групп. Отправьте в группу команду с упоминанием бота или отключите privacy mode через
@BotFather→/setprivacy→Disable. - В канал не пишет. Боту нужна роль администратора канала с правом «Post messages».
- Уведомлений нет, хотя инцидент открыт. Проверьте, что интеграция привязана к нужному workspace и не отключена.
Дальше
- Быстрый старт: Docker Compose — если агент ещё не установлен.
- Концепция: правила и инциденты — когда открывается инцидент.