albumentations.core.tracing


Runtime value objects for observing one composition execution.

TraceOptionsclass

TraceOptions()

Configure one traced composition call with snapshots, timing, retention, and an optional observer, without changing output, random state, or portable policy. Args: snapshot_targets (Sequence[str]): Target names copied into executed-leaf records. include_timing (bool): Whether records include execution time in nanoseconds. observer (Callable[[TraceRecord], None] | None): Synchronous callback invoked for each completed record. collect_records (bool): Whether to retain records in the returned result.

TraceRecordclass

TraceRecord()

Describe a completed composition or leaf visit with a structural path, outcome, detached parameters, snapshots, and optional duration for diagnosis.

TraceResultclass

TraceResult()

Bundle normal public pipeline output with immutable execution records, keeping observation opt-in without changing the ordinary Compose result contract.