"""Structured logging setup for backend services.""" import json import logging from datetime import datetime from typing import Any, Dict class JsonFormatter(logging.Formatter): def format(self, record: logging.LogRecord) -> str: payload: Dict[str, Any] = { "ts": datetime.utcnow().isoformat(), "level": record.levelname, "logger": record.name, "msg": record.getMessage(), } if record.exc_info: payload["exc"] = self.formatException(record.exc_info) return json.dumps(payload, ensure_ascii=False) def setup_logging(level: str = "INFO"): """Configure root logger with JSON formatting.""" root = logging.getLogger() if root.handlers: return # Respect existing config root.setLevel(level.upper()) handler = logging.StreamHandler() handler.setFormatter(JsonFormatter()) root.addHandler(handler)