first

2026-09-08 07:21:34 -04:00
commit a4b224da8e
169 changed files with 27483 additions and 0 deletions
@@ -0,0 +1,65 @@
+"""Structured JSON logging setup for asf-core.
+
+In production this is consumed by the log collector and forwarded to the
+observability stack. For local dev we keep a human-readable fallback.
+"""
+
+from __future__ import annotations
+
+import logging
+import sys
+from typing import Any
+
+import structlog
+
+from .config import get_settings
+
+
+def setup_logging() -> None:
+    s = get_settings()
+    level: str = s.asf_log_level.upper()
+    is_dev: bool = s.asf_env in {"development", "dev", "local"}
+
+    shared_processors: list[Any] = [
+        structlog.contextvars.merge_contextvars,
+        structlog.stdlib.add_log_level,
+        structlog.stdlib.add_logger_name,
+        structlog.processors.add_log_level,
+        structlog.processors.TimeStamper(fmt="iso", utc=True, key="@timestamp"),
+        structlog.processors.StackInfoRenderer(),
+    ]
+
+    structlog.configure(
+        processors=shared_processors
+        + [
+            structlog.stdlib.ProcessorFormatter.wrap_for_formatter,
+        ],
+        wrapper_class=structlog.stdlib.BoundLogger,
+        logger_factory=structlog.stdlib.LoggerFactory(),
+        cache_logger_on_first_use=True,
+    )
+
+    formatter_renderer: Any = (
+        structlog.dev.ConsoleRenderer()
+        if is_dev
+        else structlog.processors.JSONRenderer(sort_keys=False)
+    )
+
+    formatter = structlog.stdlib.ProcessorFormatter(
+        foreign_pre_chain=shared_processors,
+        processors=[
+            structlog.stdlib.ProcessorFormatter.remove_processors_meta,
+            formatter_renderer,
+        ],
+    )
+
+    handler = logging.StreamHandler(stream=sys.stdout)
+    handler.setFormatter(formatter)
+    root = logging.getLogger()
+    root.handlers.clear()
+    root.addHandler(handler)
+    root.setLevel(getattr(logging, level, logging.INFO))
+
+    # silence noisy third parties
+    for _name in ("uvicorn.access", "httpx", "httpcore"):
+        logging.getLogger(_name).setLevel(logging.WARNING)