Module

`logging`

Structured logging with request correlation.

Provides request_id propagation via ContextVar and a structured_log helper for JSON-formatted logs with request_id, user_id, path, etc.

Functions

get_request_id 0 str | None ▼

Return the current request ID, or None if outside a request context.

def get_request_id() -> str | None

Returns

str | None

structured_log 7 None ▼

Log a structured JSON message with correlation fields. Merges request_id from …

def structured_log(level: int, message: str, *, request_id: str | None = None, user_id: str | None = None, path: str | None = None, method: str | None = None, **extra: Any) -> None

Log a structured JSON message with correlation fields.

Merges request_id from context if not provided. Use for audit trails and observability pipelines that expect JSON logs.

Parameters

Name	Type	Description
`level`	`int`
`message`	`str`
`request_id`	`str \| None`	Default:`None`
`user_id`	`str \| None`	Default:`None`
`path`	`str \| None`	Default:`None`
`method`	`str \| None`	Default:`None`
`**extra`	`Any`