Struct Timeline 

pub struct Timeline { /* private fields */ }

A record of boot phases. See the module documentation.

Implementations

impl Timeline

pub fn new() -> Self

A timeline whose origin is now. Services use Timeline::global; this exists for tests and for embedding a second, independent boot.

pub fn global() -> &'static Self

The process-wide timeline, whose origin is the process’s start time where the platform reports it (Linux) and its first use otherwise.

pub fn origin(&self) -> Origin

What this timeline counts from.

pub fn set_service_name(&self, name: &str)

Name the service in the stderr lines. Without it the lines use OTEL_SERVICE_NAME, then the executable’s name, until Timeline::flush supplies the telemetry service name.

pub fn phase(&self, name: impl Into<Cow<'static, str>>) -> PhaseGuard<'_>

Start timing a phase. The phase is recorded when the guard is finished or, as Outcome::Failed, when it is dropped unfinished.

pub async fn time<F: IntoFuture>( &self, name: impl Into<Cow<'static, str>>, work: F, ) -> F::Output

Time work as one phase. If the future is dropped before completing, the phase is recorded as Outcome::Failed.

pub async fn try_time<T, E, F>( &self, name: impl Into<Cow<'static, str>>, work: F, ) -> Result<T, E>

where F: IntoFuture<Output = Result<T, E>>,

Like Timeline::time, recording Outcome::Failed when work returns Err.

pub fn ready(&self)

Mark boot complete: writes the phase=ready line and ends the boot root span. Only the first call counts.

pub fn flush(&self, provider: &SdkTracerProvider, service_name: &str) -> usize

Connect the timeline to provider: export every buffered phase as a span with its original timestamps under the boot root span, emit a log event for each, and export later phases as they complete.

Idempotent: the first provider wins, and a later call exports nothing and returns 0. Returns the number of phases exported by this call.

pub fn phases(&self) -> Vec<Phase>

Every phase buffered so far, in completion order.

Trait Implementations

impl Default for Timeline

fn default() -> Self

Returns the “default value” for a type.