Struct InferenceTraceRecorder 

pub struct InferenceTraceRecorder {
    pub events: Vec<TraceEvent>,
    pub spans: Vec<TraceSpan>,
    pub next_span_id: u64,
    pub stats: TraceStats,
    pub max_events: usize,
}

Records and queries a bounded trace of inference execution events.

Fields

events: Vec<TraceEvent>

Recorded events in order of occurrence.

spans: Vec<TraceSpan>

Named spans.

next_span_id: u64

Counter used to hand out monotonically increasing span IDs.

stats: TraceStats

Aggregated statistics.

max_events: usize

Maximum number of events to retain (oldest are dropped when exceeded).

Implementations

impl InferenceTraceRecorder

pub fn new(max_events: usize) -> Self

Create a new recorder with the given event capacity cap.

pub fn record(&mut self, event: TraceEvent)

Append an event, updating statistics.

If the number of events would exceed max_events, the oldest event is removed first (and span indices that referenced it are not adjusted — callers should treat indices as approximate after overflow).

pub fn begin_span(&mut self, label: String) -> u64

Open a new named span and return its ID.

pub fn end_span(&mut self, span_id: u64)

Close the span identified by span_id, recording the current event count as the end boundary.

pub fn events_in_span(&self, span_id: u64) -> &[TraceEvent]

Return the slice of events that fall within the given span.

Returns an empty slice when the span is unknown or not yet closed.

pub fn filter_events( &self, pred: impl Fn(&TraceEvent) -> bool, ) -> Vec<&TraceEvent>

Return all events for which pred returns true.

pub fn rules_fired_in_span(&self, span_id: u64) -> Vec<&TraceEvent>

Return only the RuleFired events that fall inside the given span.

pub fn stats(&self) -> &TraceStats

Borrow the accumulated statistics.

pub fn clear(&mut self)

Reset all recorded data and statistics.

pub fn export_summary(&self) -> String

Produce a one-line human-readable summary of the trace statistics.