bottohelp/LOGGING_SOURCES.md

# Источники логов в проекте telegram_bot

## 1. Основной файл логов (bot.log)
- **Расположение**: `telegram_bot/bot.log`
- **Конфигурация**: Настроен в `config.py` в секции LOG_CONFIG
- **Формат**: JSON (структурированные логи)
- **Обработчики**: Файловый обработчик с ротацией (до 5 файлов по 10MB)
- **Уровень логирования**: INFO по умолчанию
- **Описание**: Основной файл для хранения всех логов приложения, включая ошибки, предупреждения и информационные сообщения

## 2. Консольный вывод (stdout)
- **Расположение**: Консоль терминала при запуске
- **Источники**:
  - `core/application.py` - базовая настройка логирования с форматом '%(asctime)s - %(name)s - %(levelname)s - %(filename)s:%(lineno)d - %(funcName)s() - %(message)s'
  - `scheduler.py` - логи планировщика
  - `run_production.py` - логи продакшена с двойным выводом (файл + консоль)
  - `prometheus_server.py` - логи сервера метрик
- **Описание**: Логи выводятся в реальном времени во время работы бота

## 3. CI/CD логи (GitHub Actions)
- **Расположение**: `.github/workflows/ci.yml`
- **Содержимое**:
  - Вывод команд pytest при тестировании (`python -m pytest telegram_bot/test_utils/ -v --tb=short`)
  - Вывод интеграционных тестов (`python -m pytest telegram_bot/test_integration/ -v --tb=short`)
  - Логи компиляции Python (`python -m py_compile`)
  - Вывод performance тестов с измерением времени выполнения
- **Описание**: Логи автоматического тестирования и сборки в GitHub Actions

## 4. Логи в базе данных
- **Расположение**: Таблица в базе данных (через ErrorRepository)
- **Источники**:
  - `handlers/user_handlers.py` - логирование ошибок в базу данных
  - `core/exceptions.py` - системные ошибки
- **Описание**: Критические ошибки сохраняются в базу данных для последующего анализа

## 5. Sentry интеграция
- **Конфигурация**: Настроен в `core/monitoring.py`
- **Уровень**: ERROR и выше
- **Включение**: Через LOG_CONFIG["enable_sentry"] = False по умолчанию
- **Описание**: Дистанционная система логирования ошибок для мониторинга production

## 6. Прометей метрики
- **Расположение**: `prometheus_server.py`
- **Порт**: 8000 по умолчанию
- **Метрики**: Статус бота, счетчики ошибок, время выполнения команд, активные пользователи
- **Описание**: Метрики производительности и здоровья системы

## 7. Логи тестов
- **Расположение**: Различные тестовые файлы (test_*.py)
- **Источники**:
  - `test_monitoring_integration.py` - тесты логирования
  - `test_error_system.py` - тестирование системы ошибок
  - `test_moderation.py` - логи модерации
  - `simple_test.py`, `final_test.py` - интеграционные тесты
- **Описание**: Логи выполнения автоматических тестов с подробным выводом результатов

## 8. Специализированные логи сервисов
- **UserService**: Детальное логирование операций с пользователями (debug уровень)
- **PaymentProvider**: Логи платежных операций (Stripe, YooKassa, SBP)
- **GameService**: Логи игровых сессий
- **NotificationService**: Логи отправки уведомлений с повторными попытками
- **TriggerService**: Логи автоматизации
- **DonationService**: Логи платежей и донатов
- **Middleware**: Логи валидации, авторизации и метрик

## 9. Логи мониторинга и алертов
- **Расположение**: `core/alerts.py`, `core/monitoring.py`
- **Типы**: Системные алерты, метрики производительности
- **Обработчики**: Telegram уведомления, email, webhooks
- **Описание**: Логи системы мониторинга и оповещений

## 10. Логи ротации и архивации
- **Расположение**: `logs/` директория (в продакшене)
- **Формат**: Автоматическая ротация логов с backup_count = 5
- **Описание**: Архивные логи для долгосрочного хранения

---

## Исправленные ошибки логирования

### Дата исправления: 2025-10-29

#### 1. Синтаксическая ошибка в `core/application.py`
- **Ошибка**: Отсутствовало тело функции `_handle_command_fallback`
- **Исправление**: Добавлено полное тело метода с обработкой исключений и fallback логики
- **Статус**: ✅ Исправлено

#### 2. Ошибка импорта в `core/single_instance.py`
- **Ошибка**: Модуль `fcntl` недоступен на Windows
- **Исправление**: Добавлен условный импорт с проверкой доступности модуля
- **Статус**: ✅ Исправлено

#### 3. Ошибка async/await в `services/user_service.py`
- **Ошибка**: Синхронный метод `get_by_id` вызывался с `await`
- **Исправление**: Использован правильный асинхронный метод `get_by_id_async`
- **Статус**: ✅ Исправлено

#### 4. Синхронный вызов в `handlers/user_handlers.py`
- **Ошибка**: Метод `get_or_create_user` вызывался синхронно в асинхронном контексте
- **Исправление**: Добавлен оператор `await`
- **Статус**: ✅ Исправлено

#### 5. Дублирующийся код в `handlers/user_handlers.py`
- **Ошибка**: Дублирование вызова в методе `_handle_donate`
- **Исправление**: Добавлен оператор `return` для предотвращения дублирования
- **Статус**: ✅ Исправлено

#### 6. Ошибки таймаута в `handlers/base_handler.py`
- **Ошибка**: Необработанные таймауты Telegram API и устаревшие callback queries
- **Исправление**: Добавлена специальная обработка для ошибок таймаута и устаревших queries
- **Статус**: ✅ Исправлено

#### 7. Ошибки в middleware
- **Ошибка**: Необработанные устаревшие queries в `core/middleware.py`
- **Исправление**: Добавлена специальная обработка для устаревших callback queries
- **Статус**: ✅ Исправлено

### Результаты работ
- Все файлы компилируются без синтаксических ошибок
- Система логирования работает корректно
- Бот устойчив к сетевым таймаутам и устаревшим callback queries
- Улучшена обработка ошибок в middleware и обработчиках