82 lines
3.4 KiB
Python
82 lines
3.4 KiB
Python
"""Логи обычным текстом в 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"]},
|
||
}
|