Struct TraceHandle 

pub struct TraceHandle { /* private fields */ }

A cheap, cloneable write handle binding one run_id to a RunTraceStore — the single port through which the dispatcher, middlewares (via Engine::trace_handle), server handlers, and any future writer append trace events. Appends are best-effort: a store failure is logged at warn and swallowed, never propagated (fail-open, matching the append_step_entry convention).

Implementations

impl TraceHandle

pub fn new(run_id: RunId, store: Arc<dyn RunTraceStore>) -> Self

Bind run_id to store.

pub fn run_id(&self) -> &RunId

The Run this handle appends into.

pub async fn append( &self, kind: &str, step_ref: Option<&str>, attempt: Option<u32>, payload: Value, )

Best-effort append (see the struct doc). kind should follow the namespaced open-set convention (core.* / mw.* / worker.* / ext.*).

Trait Implementations

impl Clone for TraceHandle

fn clone(&self) -> TraceHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TraceHandle

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

Formats the value using the given formatter.