Struct SpanBuilder 

pub struct SpanBuilder {
    pub span_kind: Option<SpanKind>,
    pub name: Cow<'static, str>,
    pub start_time: Option<SystemTime>,
    pub attributes: Option<Vec<KeyValue>>,
    pub events: Option<Vec<Event>>,
    pub links: Option<Vec<Link>>,
}

SpanBuilder allows span attributes to be configured before the span has started.

use opentelemetry::{
    global,
    trace::{TracerProvider, SpanBuilder, SpanKind, Tracer},
};

let tracer = global::tracer("example-tracer");

// The builder can be used to create a span directly with the tracer
let _span = tracer.build(SpanBuilder {
    name: "example-span-name".into(),
    span_kind: Some(SpanKind::Server),
    ..Default::default()
});

// Or used with builder pattern
let _span = tracer
    .span_builder("example-span-name")
    .with_kind(SpanKind::Server)
    .start(&tracer);

Fields

span_kind: Option<SpanKind>

Span kind

name: Cow<'static, str>

Span name

start_time: Option<SystemTime>

Span start time

attributes: Option<Vec<KeyValue>>

Span attributes that are provided at the span creation time. More attributes can be added afterwards. Providing duplicate keys will result in multiple attributes with the same key, as there is no de-duplication performed.

events: Option<Vec<Event>>

Span events

links: Option<Vec<Link>>

Span Links

Implementations

impl SpanBuilder

SpanBuilder methods

pub fn from_name<T: Into<Cow<'static, str>>>(name: T) -> Self

Create a new span builder from a span name

pub fn with_kind(self, span_kind: SpanKind) -> Self

Assign span kind

pub fn with_start_time<T: Into<SystemTime>>(self, start_time: T) -> Self

Assign span start time

pub fn with_attributes<I>(self, attributes: I) -> Self

where I: IntoIterator<Item = KeyValue>,

Assign span attributes from an iterable. Providing duplicate keys will result in multiple attributes with the same key, as there is no de-duplication performed.

pub fn with_events(self, events: Vec<Event>) -> Self

Assign events

pub fn with_links(self, links: Vec<Link>) -> Self

Assign links

pub fn start<T: Tracer>(self, tracer: &T) -> T::Span

Builds a span with the given tracer from this configuration.

pub fn start_with_context<T: Tracer>( self, tracer: &T, parent_cx: &Context, ) -> T::Span

Builds a span with the given tracer from this configuration and parent.

Trait Implementations

impl Clone for SpanBuilder

fn clone(&self) -> SpanBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpanBuilder

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

Formats the value using the given formatter.

impl Default for SpanBuilder

fn default() -> SpanBuilder

Returns the “default value” for a type.