Logging API¶

Logging configuration for the OMOP stack.

LoggingConfig ¶

Bases: BaseModel

Logging overrides from the [logging] section of config.toml.

level overrides the verbosity-derived level for all OMOP loggers. loggers applies fine-grained level overrides to specific named loggers (e.g. {"sqlalchemy.engine": "INFO"}).

RedactingFormatter ¶

Bases: Formatter

Logging formatter that redacts sensitive key=value pairs from log messages.

configure_logging ¶

configure_logging(
    config: LoggingConfig | _HasLoggingConfig | None = None,
    *,
    verbosity: int = 0,
    extra_namespaces: list[str] | None = None,
    console: Any = None,
) -> None

Configure Python logging for the OMOP stack.

Safe to call multiple times; re-applying the same arguments is idempotent.

Parameters:

Name	Type	Description	Default
`config`	`LoggingConfig \| _HasLoggingConfig \| None`	A `LoggingConfig` or a `StackConfig` (`logging` block extracted automatically). When `config.level` is set it takes precedence over `verbosity`.	`None`
`verbosity`	`int`	Number of `-v` flags passed by the user. `0` → WARNING, `1` → INFO, `2+` → DEBUG.	`0`
`extra_namespaces`	`list[str] \| None`	Additional logger namespaces to configure alongside `oa_configurator`. Pass your package name here, e.g. `extra_namespaces=["omop_graph"]`.	`None`

get_logger ¶

get_logger(name: str) -> logging.Logger

Return a named logger; single import point for consuming packages.