"""Логи обычным текстом в stdout: одна строка на событие. Формат строки (перенос — только здесь, в логе строка одна): 2026-09-30T12:00:00.123Z INFO src.http [rid=3f2a...] POST /api/v1/users -> 201 (1.4 ms) `rid` — id запроса из contextvar, тот же, что в заголовке `X-Request-Id` и в теле ошибки; вне запроса (старт, остановка) там `-`. Время — UTC. Логи uvicorn идут через тот же handler и формат: по строкам «Shutting down» и «Finished server process» видно, сколько заняла остановка. """ import logging import time from contextvars import ContextVar from typing import Any # ставит только RequestIdMiddleware request_id_var: ContextVar[str] = ContextVar("request_id", default="-") LOG_FORMAT = "%(asctime)s %(levelname)-7s %(name)s [rid=%(request_id)s] %(message)s" class UtcFormatter(logging.Formatter): """Время записи в UTC с миллисекундами и суффиксом Z.""" converter = time.gmtime default_time_format = "%Y-%m-%dT%H:%M:%S" default_msec_format = "%s.%03dZ" class RequestIdFilter(logging.Filter): """Добавляет в каждую запись поле `request_id` из contextvar.""" def filter(self, record: logging.LogRecord) -> bool: record.request_id = request_id_var.get() return True def get_logger(name: str) -> logging.Logger: """Логгер модуля приложения: `get_logger(__name__)`.""" return logging.getLogger(name) def logging_config(level: str) -> dict[str, Any]: """Конфиг для `uvicorn.run(log_config=...)`. uvicorn применяет его сам через `logging.config.dictConfig` до старта приложения, поэтому второй настройки логирования в коде нет. """ return { "version": 1, "disable_existing_loggers": False, "filters": {"request_id": {"()": RequestIdFilter}}, "formatters": {"text": {"()": UtcFormatter, "fmt": LOG_FORMAT}}, "handlers": { "stdout": { "class": "logging.StreamHandler", "stream": "ext://sys.stdout", "formatter": "text", "filters": ["request_id"], }, }, "loggers": { "src": { "level": level, "handlers": ["stdout"], "propagate": False, }, # uvicorn.error наследует handler от uvicorn: свой дал бы дубли "uvicorn": {"level": "INFO", "handlers": ["stdout"], "propagate": False}, # access-лог пишет RequestIdMiddleware, у uvicorn он выключен "uvicorn.access": {"level": "WARNING", "handlers": [], "propagate": False}, # сервис migrate: строки «Running upgrade ...» тем же форматом "alembic": {"level": "INFO", "handlers": ["stdout"], "propagate": False}, # SQL и его параметры в журнал не идут: только предупреждения "sqlalchemy": {"level": "WARNING"}, }, "root": {"level": "WARNING", "handlers": ["stdout"]}, }