StrandsTelemetry

Struct StrandsTelemetry 

Source
pub struct StrandsTelemetry {
    pub resource: OtelResource,
    /* private fields */
}
Expand description

OpenTelemetry configuration and setup for Strands applications.

Automatically initializes a tracer provider with text map propagators. Trace exporters (console, OTLP) can be set up individually using dedicated methods that support method chaining for convenient configuration.

§Examples

Quick setup with method chaining:

StrandsTelemetry::new().setup_console_exporter().setup_otlp_exporter();

Using a custom tracer provider:

StrandsTelemetry::with_tracer_provider(my_provider).setup_console_exporter();

Step-by-step configuration:

let telemetry = StrandsTelemetry::new();
telemetry.setup_console_exporter();
telemetry.setup_otlp_exporter();

To setup global meter provider:

telemetry.setup_meter(true, true); // enable_console, enable_otlp

Fields§

§resource: OtelResource

Implementations§

Source§

impl StrandsTelemetry

Source

pub fn new() -> Self

Create a new StrandsTelemetry instance.

This initializes a new tracer provider and sets it as the global provider.

Source

pub fn with_tracer_provider(tracer_provider: SdkTracerProvider) -> Self

Create a new StrandsTelemetry instance with a pre-configured tracer provider.

Source

pub fn setup_console_exporter(self) -> Self

Set up console exporter for traces (no-op when feature not enabled).

Source

pub fn setup_otlp_exporter(self) -> Self

Set up OTLP exporter for traces (no-op when feature not enabled).

Source

pub fn setup_meter(self, _enable_console: bool, _enable_otlp: bool) -> Self

Set up the meter provider for metrics (no-op when features not enabled).

Source

pub fn is_console_enabled(&self) -> bool

Check if console exporter is enabled.

Source

pub fn is_otlp_enabled(&self) -> bool

Check if OTLP exporter is enabled.

Source

pub fn is_meter_enabled(&self) -> bool

Check if meter is enabled.

Source

pub fn resource(&self) -> &OtelResource

Get the resource.

Source

pub fn tracer_provider(&self) -> Option<&SdkTracerProvider>

Get the tracer provider.

Source

pub fn tracer(&self, name: &'static str) -> Option<Tracer>

Get a tracer from the provider.

Trait Implementations§

Source§

impl Default for StrandsTelemetry

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> FutureExt for T

Source§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
Source§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

Source§

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more