Skip to content

Central structured logging with correlation context - #9

Merged
grenkoff merged 1 commit into
mainfrom
feature/logging
Jun 14, 2026
Merged

grenkoff merged 1 commit into
mainfrom
feature/logging

Conversation

@grenkoff

Copy link
Copy Markdown
Owner

Что

Единое логирование (stdlib, без новых зависимостей) для API и воркера.

  • logging_config.configure_logging() — общий entrypoint; текст в dev, JSON в проде (Railway-агрегация); уровень из LOG_LEVEL.
  • Корреляция через contextvars + фильтр: request_id, user_id, import_id, session_id, object_key попадают в каждую строку → трассировка запроса/импорта через API и воркер.
  • API: middleware логирует каждый запрос (метод/путь/статус/мс), ставит x-request-id в ответ и единый лог необработанных исключений; user_id биндится при аутентификации.
  • Worker: configure_logging вместо ad-hoc basicConfig; на каждый джоб биндятся user_id/object_key/import_id.
  • Приглушены шумные логгеры (clickhouse-connect, asynch, minio, redis, httpx, aiohttp).

Было

Воркер логировал базово, API почти немой (ни настройки, ни логов запросов/ошибок), не структурировано, без корреляции, без env-уровня.

Проверено

  • ruff + mypy --strict чисто, pytest 30/30 (вкл. новый test_logging.py).
  • Живьём: dev-текст с request_id, заголовок x-request-id, prod-JSON с request_id/user_id.

@grenkoff
grenkoff merged commit de8ffc7 into main Jun 14, 2026
3 checks passed
@grenkoff
grenkoff deleted the feature/logging branch June 14, 2026 18:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant