Error Alert Bot

Профессиональная система мониторинга логов с мгновенными уведомлениями в Telegram.

Технологический стек

Выберите ваш сценарий

👤 Я пользователь - хочу мониторить свои логи

→ Быстрый старт за 2 минуты

🛠️ Я разработчик - хочу развернуть свою систему

→ Установка на свой сервер

---

ДЛЯ ПОЛЬЗОВАТЕЛЕЙ: Быстрый старт

Начать за 2 минуты

1. Найдите бота в Telegram
   @ErrorAlertBot

2. Получите API ключ Откройте диалог с ботом и отправьте команды:

   /start - начать работу с ботом  
   /create_api_key - создать уникальный API ключ
   

   Сохраните полученный ключ - он покажется только один раз!

3. Скачайте агент для вашей операционной системы
   Для Linux (большинство серверов):

   wget -O error-alert-agent https://github.com/Vladik22611/error-alert-bot/releases/latest/download/error-alert-agent-linux-amd64
   chmod +x error-alert-agent

   Для Windows:

   • Скачайте файл error-alert-agent-windows-amd64.exe из раздела Releases
   • Запустите его из командной строки

   Для macOS:

   # Apple Silicon (M1/M2/M3)
    wget -O error-alert-agent https://github.com/Vladik22611/error-alert-bot/releases/latest/download/error-alert-agent-darwin-arm64
    chmod +x error-alert-agent
    
    # Intel Mac
    wget -O error-alert-agent https://github.com/Vladik22611/error-alert-bot/releases/latest/download/error-alert-agent-darwin-amd64
    chmod +x error-alert-agent

4. Запустите мониторинг ваших логов

   ./error-alert-agent \
    --log-file=/var/log/your-application.log \ # путь до вашего log файла
    --api-key=ВАШ_КОПИРОВАННЫЙ_API_КЛЮЧ \
    --server=http://46.16.12.138:8080

5. Включите уведомления в боте
   Вернитесь в Telegram и отправьте:

   /monitor
   

✅ Всё готово! Теперь при появлении ошибок в логах вы будете получать мгновенные уведомления в Telegram.

Полный список команд бота

Отправьте боту /help чтобы увидеть все доступные команды

🛠️ Решение проблем

Агент не запускается?

• Проверьте правильность API ключа
• Убедитесь что сервер доступен
• Проверьте права доступа к файлу логов

Не приходят уведомления?

• Убедитесь что отправили /monitor в боте
• Проверьте что в логах есть ошибки, соответствующие фильтрам
• Используйте /status для проверки состояния мониторинга

Нужно изменить фильтры?

• Используйте /set_filter чтобы настроить регулярные выражения для поиска ошибок, или /examples чтобы посмотреть готовые примеры.

🛠️ ДЛЯ РАЗРАБОТЧИКОВ: Установка на свой сервер

Требования

• Docker & Docker Compose
• PostgreSQL 15+
• Telegram Bot Token от @BotFather

Быстрая установка

# 1. Клонируйте репозиторий
git clone https://github.com/Vladik22611/error-alert-bot.git
cd error-alert-bot

# 2. Настройте окружение
cp .env.example .env
nano .env  # Отредактируйте настройки

# 3. Запустите сервисы
docker compose up -d

# 4. Проверьте работу
docker compose ps
curl http://localhost:8080/health

CI/CD Pipeline

При пуше в main ветку автоматически:

• Форматирование кода и линтинг
• Запуск тестов
• Сборка Docker образов
• Деплой на сервер

📞 Поддержка

• Баги и issues: GitHub Issues
• Обсуждения: GitHub Discussions

⭐ Если проект полезен - поставьте звезду на GitHub!

Error Alert Bot - профессиональный мониторинг для ваших приложений!

Лицензия

Этот проект распространяется под MIT License - смотрите файл LICENSE для деталей.

Автор

Grechkin Vladislav