Struct TraceAssembler 

pub struct TraceAssembler { /* private fields */ }

In-memory assembler for one trace.

Construct via TraceAssembler::open. Attach events via TraceAssembler::attach. Seal via TraceAssembler::close.

Implementations

impl TraceAssembler

pub fn open( id: TraceId, trace_type: impl Into<String>, opened_at: DateTime<Utc>, ) -> Self

Open a new trace with the given id, type tag, and open timestamp.

pub fn id(&self) -> TraceId

Trace identifier.

pub fn status(&self) -> TraceStatus

Current status.

pub fn len(&self) -> usize

Number of events attached so far.

pub fn is_empty(&self) -> bool

Whether this trace has zero events attached.

pub fn attach(&mut self, event_id: EventId) -> Result<u64, TraceError>

Attach an event to this trace and return its ordinal.

Ordinals start at 0 and are strictly monotonic. Returns TraceError::Closed if the trace is sealed.

pub fn close(&mut self, closed_at: DateTime<Utc>) -> Result<Trace, TraceError>

Close (seal) the trace.

Returns the persistent Trace row that should be written to the store. Closing is idempotent on repeated calls only in the sense that a second call returns AlreadyClosed; callers must take the Trace from the first successful call.

pub fn snapshot(&self) -> Trace

Snapshot the current state as a Trace row (without sealing).

Useful for dashboards or mid-flight inspection. The returned Trace will reflect whatever status the assembler is currently in.

Trait Implementations

impl Clone for TraceAssembler

fn clone(&self) -> TraceAssembler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TraceAssembler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.