Struct RequestTracer 

pub struct RequestTracer { /* private fields */ }

Builds and emits one record per actual transport attempt (see module docs for the record rule). Owned by a single request; not shared.

Implementations

impl RequestTracer

pub fn begin( ctx: &TraceContext, correlation: Option<RequestCorrelation>, model: QualifiedModelId, transport: TransportKind, endpoint: EndpointMeta, structure: RequestStructure, ) -> Option<Self>

Begin tracing one request. Returns None when the context is disabled or the structural identity is unrepresentable (counted as a degraded record — never an error).

pub fn request_id(&self) -> &TraceId

The shared request ID for correlating this request’s records.

pub fn correlation_ids(&self) -> (&TraceId, &TraceId, &TraceId)

pub fn attempt_failed( &mut self, clock: AttemptClock, class: RetryClass, delay: Duration, http_status: Option<u16>, provider_request_id: Option<TraceId>, code: &str, )

Record a failed attempt that WILL be retried: emits this attempt’s record (typed ProviderFailed terminal), then appends the retry to the shared history and advances the attempt ordinal.

pub fn finish( self, clock: AttemptClock, http_status: Option<u16>, provider_request_id: Option<TraceId>, stop_reason: Option<StopReason>, usage: Option<UsageMeta>, terminal: TurnOutcome, )

Emit the final record for this request’s last attempt.

pub fn failed_terminal(&self, code: &str) -> TurnOutcome

A typed terminal for an attempt that failed: the correlation ID is the trace request ID — never a raw error string.