"""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)