Files
mtusi2026lab3/src/log.py
T

82 lines
3.4 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Логи обычным текстом в 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"]},
}