"""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("danagble.session_id", default="") trace_var: contextvars.ContextVar[str] = contextvars.ContextVar("danagble.trace_id", default="") user_var: contextvars.ContextVar[str] = contextvars.ContextVar("danagble.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 = "danagble") -> logging.Logger: global _configured if not _configured: handler = logging.StreamHandler(sys.stdout) handler.setFormatter(JsonFormatter()) root = logging.getLogger("danagble") root.handlers.clear() root.addHandler(handler) root.setLevel(logging.INFO) root.propagate = False _configured = True return logging.getLogger(name)