backend/shared/logger.py

49 lines
1.9 KiB
Python

"""Central logger: JSON lines carrying session/trace/user context.
Context comes from contextvars (set by shared.tracing per request), so any
service can log and the line is automatically attributable to the user session.
Read with: jq / docker logs. Cold archive: ship JSONL to R2 per day.
"""
from __future__ import annotations
import contextvars
import json
import logging
import sys
from datetime import datetime, timezone
session_var: contextvars.ContextVar[str] = contextvars.ContextVar("danable.session_id", default="")
trace_var: contextvars.ContextVar[str] = contextvars.ContextVar("danable.trace_id", default="")
user_var: contextvars.ContextVar[str] = contextvars.ContextVar("danable.user_id", default="anonymous")
_configured = False
class JsonFormatter(logging.Formatter):
def format(self, record: logging.LogRecord) -> str:
payload = {
"ts": datetime.now(timezone.utc).isoformat(),
"level": record.levelname,
"name": record.name,
"session_id": getattr(record, "session_id", None) or session_var.get() or None,
"trace_id": getattr(record, "trace_id", None) or trace_var.get() or None,
"user_id": getattr(record, "user_id", None) or user_var.get() or None,
"msg": record.getMessage(),
}
if record.exc_info:
payload["exc"] = self.formatException(record.exc_info)
return json.dumps(payload, ensure_ascii=False)
def get_logger(name: str = "danable") -> logging.Logger:
global _configured
if not _configured:
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(JsonFormatter())
root = logging.getLogger("danable")
root.handlers.clear()
root.addHandler(handler)
root.setLevel(logging.INFO)
root.propagate = False
_configured = True
return logging.getLogger(name)