session_context

Module

Execution-context-local session selection and W3C baggage propagation.

_SessionSelection

Marker type for execution-local session selection state.

SplunkAOSessionPropagator

Preserve the configured propagator while normalizing session baggage.

clear_session_context

def clear_session_context() -> None

Explicitly suppress local, inbound, and compatibility session selection.

explicit_session_id

def explicit_session_id(selection: SessionSelection) -> tuple[bool, str | None]

Return whether a saved selection is explicit and its session value.

extract_session_context

def extract_session_context(carrier: Any,
                            context: Context | None=None,
                            getter: textmap.Getter[Any]=textmap.default_getter) -> Context

Extract configured trace context and normalize session baggage.

get_effective_session_id

def get_effective_session_id(logger_session_id: str | None=None,
                             context: Context | None=None) -> str | None

Resolve the execution-local, inbound, or compatibility session ID.

get_session_selection

def get_session_selection() -> SessionSelection

Return the raw execution-local selection for nested-context restoration.

inject_session_context

def inject_session_context(carrier: Any,
                           context: Context | None=None,
                           setter: textmap.Setter[Any]=textmap.default_setter) -> None

Inject configured trace context and normalized session baggage.

install_session_propagator

def install_session_propagator() -> None

Wrap the process-global propagator with the session-aware adapter. The current propagator remains the delegate. Replacing the global propagator later also removes this adapter until this function is called again.

restore_session_selection

def restore_session_selection(selection: SessionSelection) -> None

Restore a previously captured execution-local selection.

set_session_context

def set_session_context(session_id: str | None) -> None

Set or reset the explicit session selection for this execution context. Passing None retains the historical reset behavior: inbound baggage and the logger compatibility field may be consulted again. Use

Overview

Python SDK

API

Module

_SessionSelection

SplunkAOSessionPropagator

clear_session_context

explicit_session_id

extract_session_context

get_effective_session_id

get_session_selection

inject_session_context

install_session_propagator

restore_session_selection

set_session_context

​Module

​_SessionSelection

​SplunkAOSessionPropagator

​clear_session_context

​explicit_session_id

​extract_session_context

​get_effective_session_id

​get_session_selection

​inject_session_context

​install_session_propagator

​restore_session_selection

​set_session_context

Module

_SessionSelection

SplunkAOSessionPropagator

clear_session_context

explicit_session_id

extract_session_context

get_effective_session_id

get_session_selection

inject_session_context

install_session_propagator

restore_session_selection

set_session_context