Struct tracing_opentelemetry::OpenTelemetryLayer

pub struct OpenTelemetryLayer<S, T> { /* private fields */ }

An OpenTelemetry propagation layer for use in a project that uses tracing.

Implementations

impl<S, T> OpenTelemetryLayer<S, T> where
    S: Subscriber + for<'span> LookupSpan<'span>,
    T: Tracer + PreSampledTracer + 'static, 

pub fn new(tracer: T) -> Self

Set the Tracer that this layer will use to produce and track OpenTelemetry Spans.

Examples

use tracing_opentelemetry::OpenTelemetryLayer;
use tracing_subscriber::layer::SubscriberExt;
use tracing_subscriber::Registry;

// Create a jaeger exporter pipeline for a `trace_demo` service.
let tracer = opentelemetry_jaeger::new_pipeline()
    .with_service_name("trace_demo")
    .install_simple()
    .expect("Error initializing Jaeger exporter");

// Create a layer with the configured tracer
let otel_layer = OpenTelemetryLayer::new(tracer);

// Use the tracing subscriber `Registry`, or any other subscriber
// that impls `LookupSpan`
let subscriber = Registry::default().with(otel_layer);

pub fn with_tracer<Tracer>(
    self,
    tracer: Tracer
) -> OpenTelemetryLayer<S, Tracer> where
    Tracer: Tracer + PreSampledTracer + 'static, 

Set the Tracer that this layer will use to produce and track OpenTelemetry Spans.

Examples

use tracing_subscriber::layer::SubscriberExt;
use tracing_subscriber::Registry;

// Create a jaeger exporter pipeline for a `trace_demo` service.
let tracer = opentelemetry_jaeger::new_pipeline()
    .with_service_name("trace_demo")
    .install_simple()
    .expect("Error initializing Jaeger exporter");

// Create a layer with the configured tracer
let otel_layer = tracing_opentelemetry::layer().with_tracer(tracer);

// Use the tracing subscriber `Registry`, or any other subscriber
// that impls `LookupSpan`
let subscriber = Registry::default().with(otel_layer);

pub fn with_exception_fields(self, exception_fields: bool) -> Self

Sets whether or not span and event metadata should include OpenTelemetry exception fields such as exception.message and exception.backtrace when an Error value is recorded. If multiple error values are recorded on the same span/event, only the most recently recorded error value will show up under these fields.

These attributes follow the OpenTelemetry semantic conventions for exceptions.

By default, these attributes are not recorded.

pub fn with_exception_field_propagation(
    self,
    exception_field_propagation: bool
) -> Self

Sets whether or not reporting an Error value on an event will propagate the OpenTelemetry exception fields such as exception.message and exception.backtrace to the corresponding span. You do not need to enable with_exception_fields in order to enable this. If multiple error values are recorded on the same span/event, only the most recently recorded error value will show up under these fields.

These attributes follow the OpenTelemetry semantic conventions for exceptions.

By default, these attributes are not propagated to the span.

pub fn with_location(self, location: bool) -> Self

Sets whether or not span and event metadata should include OpenTelemetry attributes with location information, such as the file, module and line number.

These attributes follow the OpenTelemetry semantic conventions for source locations.

By default, locations are enabled.

pub fn with_event_location(self, event_location: bool) -> Self

👎 Deprecated since 0.17.3:

renamed to OpenTelemetrySubscriber::with_location

Sets whether or not span and event metadata should include OpenTelemetry attributes with location information, such as the file, module and line number.

These attributes follow the OpenTelemetry semantic conventions for source locations.

By default, locations are enabled.

pub fn with_tracked_inactivity(self, tracked_inactivity: bool) -> Self

Sets whether or not spans metadata should include the busy time (total time for which it was entered), and idle time (total time the span existed but was not entered).

pub fn with_threads(self, threads: bool) -> Self

Sets whether or not spans record additional attributes for the thread name and thread ID of the thread they were created on, following the OpenTelemetry semantic conventions for threads.

By default, thread attributes are enabled.

Trait Implementations

impl<S> Default for OpenTelemetryLayer<S, NoopTracer> where
    S: Subscriber + for<'span> LookupSpan<'span>, 

fn default() -> Self

Returns the “default value” for a type.

impl<S, T> Layer<S> for OpenTelemetryLayer<S, T> where
    S: Subscriber + for<'span> LookupSpan<'span>,
    T: Tracer + PreSampledTracer + 'static, 

fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, ctx: Context<'_, S>)

Creates an OpenTelemetry Span for the corresponding tracing Span.

fn on_record(&self, id: &Id, values: &Record<'_>, ctx: Context<'_, S>)

Record OpenTelemetry attributes for the given values.

fn on_event(&self, event: &Event<'_>, ctx: Context<'_, S>)

Records OpenTelemetry Event data on event.

Note: an ERROR-level event will also set the OpenTelemetry span status code to Error, signaling that an error has occurred.

fn on_close(&self, id: Id, ctx: Context<'_, S>)

Exports an OpenTelemetry Span on close.

fn on_enter(&self, id: &Id, ctx: Context<'_, S>)

Notifies this layer that a span with the given ID was entered.

fn on_exit(&self, id: &Id, ctx: Context<'_, S>)

Notifies this layer that the span with the given ID was exited.

fn on_follows_from(&self, id: &Id, follows: &Id, ctx: Context<'_, S>)

Notifies this layer that a span with the ID span recorded that it follows from the span with the ID follows.

fn on_layer(&mut self, subscriber: &mut S)

Performs late initialization when attaching a Layer to a Subscriber.

fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest

Registers a new callsite with this layer, returning whether or not the layer is interested in being notified about the callsite, similarly to Subscriber::register_callsite.

fn enabled(&self, metadata: &Metadata<'_>, ctx: Context<'_, S>) -> bool

Returns true if this layer is interested in a span or event with the given metadata in the current Context, similarly to Subscriber::enabled.

fn event_enabled(&self, _event: &Event<'_>, _ctx: Context<'_, S>) -> bool

Called before on_event, to determine if on_event should be called.

fn on_id_change(&self, _old: &Id, _new: &Id, _ctx: Context<'_, S>)

Notifies this layer that a span ID has been cloned, and that the subscriber returned a different ID.

fn and_then<L>(self, layer: L) -> Layered<L, Self, S> where
    L: Layer<S>, 

Composes this layer around the given Layer, returning a Layered struct implementing Layer.

fn with_subscriber(self, inner: S) -> Layered<Self, S, S>

Composes this Layer with the given Subscriber, returning a Layered struct that implements Subscriber.

fn with_filter<F>(self, filter: F) -> Filtered<Self, F, S> where
    F: Filter<S>, 

Combines self with a Filter, returning a Filtered layer.

fn boxed(self) -> Box<dyn Layer<S> + Sync + Send + 'static, Global> where
    Self: 'static + Layer<S> + Send + Sync,
    S: Subscriber, 

Erases the type of this Layer, returning a Boxed dyn Layer trait object.