"""
Structured logging configuration using structlog.
Provides consistent, production-grade logging with JSON or console output.
"""
import logging
import sys
from typing import Any
import structlog
from structlog.types import Processor
from combined_mcp_server.config import get_settings
def configure_logging() -> None:
"""Configure structured logging based on settings."""
settings = get_settings()
# Determine processors based on format
shared_processors: list[Processor] = [
structlog.contextvars.merge_contextvars,
structlog.stdlib.add_log_level,
structlog.stdlib.add_logger_name,
structlog.stdlib.PositionalArgumentsFormatter(),
structlog.processors.TimeStamper(fmt="iso"),
structlog.processors.StackInfoRenderer(),
structlog.processors.UnicodeDecoder(),
]
if settings.logging.format == "json":
# JSON format for production
processors: list[Processor] = [
*shared_processors,
structlog.processors.format_exc_info,
structlog.processors.JSONRenderer(),
]
formatter = structlog.stdlib.ProcessorFormatter(
processor=structlog.processors.JSONRenderer(),
foreign_pre_chain=shared_processors,
)
else:
# Console format for development
processors = [
*shared_processors,
structlog.dev.ConsoleRenderer(colors=True),
]
formatter = structlog.stdlib.ProcessorFormatter(
processor=structlog.dev.ConsoleRenderer(colors=True),
foreign_pre_chain=shared_processors,
)
# Configure structlog
structlog.configure(
processors=processors,
context_class=dict,
logger_factory=structlog.stdlib.LoggerFactory(),
wrapper_class=structlog.stdlib.BoundLogger,
cache_logger_on_first_use=True,
)
# Configure standard library logging
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(formatter)
root_logger = logging.getLogger()
root_logger.handlers = [handler]
root_logger.setLevel(getattr(logging, settings.logging.level))
# Reduce noise from third-party libraries
logging.getLogger("boto3").setLevel(logging.WARNING)
logging.getLogger("botocore").setLevel(logging.WARNING)
logging.getLogger("urllib3").setLevel(logging.WARNING)
def get_logger(name: str | None = None, **context: Any) -> structlog.stdlib.BoundLogger:
"""
Get a structured logger instance.
Args:
name: Logger name (typically __name__)
**context: Additional context to bind to all log messages
Returns:
Bound structured logger
"""
logger = structlog.get_logger(name)
if context:
logger = logger.bind(**context)
return logger
