backend/shared/tracing.py

70 lines
2.5 KiB
Python

"""Request tracing: session_id (one visit) + trace_id (one operation) via contextvars.
Middleware reads X-Session-ID (generated by the client per visit) and X-User-Id,
mints a trace_id per request, and echoes both back as response headers so the
frontend can correlate its own action log with the backend tracelog.
"""
from __future__ import annotations
import time
import uuid
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.requests import Request
from shared.logger import get_logger, session_var, trace_var, user_var
log = get_logger("danagble.trace")
SESSION_HEADER = "X-Session-ID"
TRACE_HEADER = "X-Trace-ID"
USER_HEADER = "X-User-Id"
def new_id(n: int = 16) -> str:
return uuid.uuid4().hex[:n]
def get_trace_context() -> dict:
return {"session_id": session_var.get(), "trace_id": trace_var.get(),
"user_id": user_var.get()}
def _user_from_token(request) -> str | None:
"""Attribute the trace to the JWT owner without a DB hit."""
try:
from src.core.security import decode_token
auth = request.headers.get("authorization", "")
if not auth.lower().startswith("bearer "):
return None
payload = decode_token(auth.split(" ", 1)[1])
return (payload or {}).get("sub")
except Exception:
return None
class TraceMiddleware(BaseHTTPMiddleware):
async def dispatch(self, request: Request, call_next):
session_id = request.headers.get(SESSION_HEADER, "") or new_id()
trace_id = new_id()
user_id = request.headers.get(USER_HEADER, "") or _user_from_token(request) or "anonymous"
tok_s, tok_t, tok_u = (session_var.set(session_id), trace_var.set(trace_id),
user_var.set(user_id))
start = time.perf_counter()
response = None
try:
response = await call_next(request)
response.headers[SESSION_HEADER] = session_id
response.headers[TRACE_HEADER] = trace_id
return response
except Exception:
log.error("request failed method=%s path=%s", request.method, request.url.path)
raise
finally:
elapsed_ms = (time.perf_counter() - start) * 1000
log.info("request method=%s path=%s status=%s ms=%.1f",
request.method, request.url.path,
response.status_code if response is not None else "err",
elapsed_ms)
session_var.reset(tok_s)
trace_var.reset(tok_t)
user_var.reset(tok_u)