drhider/History/code-fixes/2026-08-20-logging.md

2026-08-20 — Максимальное логирование (v0.0.51)

Проблема

SSE рвётся на проде (пару минут), обработка при этом продолжается (воркер жив). Логов в поде не было — приложение не писало в stdout, нельзя было диагностировать обрыв (внешний шлюз vs генератор).

Решение

1. site/app.py — setup_logging():
   • уровень из env LOG_LEVEL (DEBUG/INFO/WARNING), default INFO
   • logging.basicConfig(..., stream=sys.stderr, force=True) — в stdout/stderr пода
   • формат с таймстампом; уровни для логгеров drhider/app/routes/session
   • LOG_LEVEL задаётся через env-переменные приложения на платформе
2. site/routes/api_bp.py — подробные логи:
   • upload: каждый файл (имя, размер), итог, ошибки
   • process_stream: start, worker start/done (время, токены, zip_len), каждое событие progress (start/done) с idx/name/elapsed, disconnect на heartbeat/progress/complete/error (с причиной), result/complete, error event
3. VERSION поднята до 0.0.51

Проверка (локально, DEBUG)

Upload 1 файла + SSE: видны все события от upload до complete. LLM NER failed: Illegal header value b'Bearer ' — ожидаемо без ключа (локально).

Как читать логи пода после деплоя

kubectl logs -n 20a75175-a58c-49cb-b8fa-e86367b1a8dc <pod> --tail=500 --timestamps

• Если process_stream: disconnect on progress — клиент/шлюз оборвал.
• Если worker дошёл до complete, а клиент не получил — рвёт шлюз/браузер.
• Если worker: exception — ошибка обработки.