Module

_request_id

Request ID generation and propagation.

Each request gets a unique ID for tracing across logs and services. If a trusted proxy sends X-Request-ID, we honour it. Otherwise, we generate a new one. The ID is injected into:

  • The ASGI scope extensions (scope["extensions"]["request_id"])
  • The response headers (X-Request-ID)

Uses UUID4 for uniqueness without coordination between workers.

2Functions

Functions

generate_request_id 0 str ▼
Generate a unique request ID (UUID4 hex, no dashes).
def generate_request_id() -> str
Returns
str
extract_or_generate 2 str ▼
Extract X-Request-ID from headers or generate a new one. If the peer is truste…
def extract_or_generate(headers: tuple[tuple[bytes, bytes], ...], *, trusted: bool) -> str

Extract X-Request-ID from headers or generate a new one.

If the peer is trusted (via proxy headers) and sends X-Request-ID, we use that value. Otherwise, we generate a new UUID4.

Parameters
Name Type Description
headers tuple[tuple[bytes, bytes], ...]

Request headers as (name, value) tuples.
trusted bool

Whether the direct peer is trusted (proxy).
Returns
str