Struct Runtime 

pub struct Runtime { /* private fields */ }

Shared telemetry runtime.

Share one runtime across crate boundaries so metric registration, span collection, and export setup are owned once per service. Register metric groups during construction, then keep updating the returned metric handles directly on hot paths.

Implementations

impl Runtime

pub fn new(config: RuntimeConfig) -> Arc<Self>

Create a runtime wrapped in Arc for parent/child sharing.

pub fn config(&self) -> &RuntimeConfig

Return this runtime’s configuration.

pub fn span_collector(&self) -> &Arc<SpanCollector>

Return the shared span collector owned by this runtime.

Clone this once when wiring exporters. Hot-path span creation should use start_span or keep this borrowed through the shared runtime rather than cloning an Arc per operation.

pub fn start_span( &self, name: impl Into<Cow<'static, str>>, kind: SpanKind, ) -> Span

Create a new root span with a fresh trace ID.

This forwards to the runtime’s shared SpanCollector, keeping the collector service shared across crate boundaries.

pub fn start_span_from_traceparent( &self, traceparent: Option<&str>, name: impl Into<Cow<'static, str>>, kind: SpanKind, ) -> Span

Create a root span from an incoming W3C traceparent header.

This forwards to the runtime’s shared SpanCollector.

pub fn flush_local_spans(&self)

Flush spans recorded on the current thread into the shared collector.

pub fn drain_spans_into(&self, buf: &mut Vec<CompletedSpan>)

Drain completed spans from the shared collector into buf.

pub fn register_metrics<M>( &self, scope: MetricScope, metrics: M, ) -> RegisteredMetrics<M>

where M: ExportMetrics + Send + Sync + 'static,

Register a metric group and return direct handles to it.

Registry work happens here. Recording should use the returned RegisteredMetrics value, or handles pre-resolved inside metrics.

pub fn visit_metrics<V>(&self, visitor: &mut V)

where V: MetricVisitor,

Visit all registered metric groups as structured cumulative metrics.

pub fn visit_metrics_for_scope<V>(&self, scope: &MetricScope, visitor: &mut V)

where V: MetricVisitor,

Visit registered metric groups that match scope.

pub fn registered_metrics_len(&self) -> usize

Return the number of registered metric groups.

pub fn scopes(&self) -> Vec<MetricScope>

Return the registered metric scopes.