Skip to content

lasagnastack.logging_config

lasagnastack.logging_config

configure_logging 

configure_logging(level: str = 'INFO') -> None

Configure structlog for the process.

Reads LOG_FORMAT from the environment: set to "json" for machine-parseable output (useful in CI or when shipping logs to an aggregator). Any other value (or absent) produces human-readable ConsoleRenderer output.

Parameters:

Name Type Description Default
level str

Minimum log level string, e.g. "INFO" or "DEBUG".

 'INFO'
Source code in src/lasagnastack/logging_config.py 
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
def configure_logging(level: str = "INFO") -> None:
    """Configure structlog for the process.

    Reads ``LOG_FORMAT`` from the environment: set to ``"json"`` for
    machine-parseable output (useful in CI or when shipping logs to an
    aggregator). Any other value (or absent) produces human-readable
    ``ConsoleRenderer`` output.

    Args:
        level: Minimum log level string, e.g. ``"INFO"`` or ``"DEBUG"``.
    """
    use_json = os.getenv("LOG_FORMAT", "").lower() == "json"
    renderer: structlog.types.Processor = (
        structlog.processors.JSONRenderer()
        if use_json
        else structlog.dev.ConsoleRenderer(colors=True, sort_keys=False)
    )
    structlog.configure(
        processors=[
            structlog.contextvars.merge_contextvars,
            structlog.processors.add_log_level,
            structlog.processors.TimeStamper(fmt="%Y-%m-%d %H:%M:%S"),
            _prioritise_fields,
            renderer,
        ],
        wrapper_class=structlog.make_filtering_bound_logger(
            logging.getLevelName(level)
        ),
        context_class=dict,
        logger_factory=structlog.PrintLoggerFactory(),
        cache_logger_on_first_use=True,
    )