Struct HttpTracerProviderBuilder

pub struct HttpTracerProviderBuilder<C: HttpClient + 'static = StdoutClient> { /* private fields */ }

Builder for configuring and initializing a TracerProvider.

This struct provides a fluent interface for configuring various aspects of the OpenTelemetry tracing setup, including the exporter type, propagators, and ID generators.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;
use opentelemetry_sdk::trace::{TracerProvider, Tracer};

let tracer_provider: TracerProvider = HttpTracerProviderBuilder::default()
    .with_stdout_client()
    .enable_fmt_layer(true)
    .with_tracer_name("my-service")
    .with_default_text_map_propagator()
    .with_default_id_generator()
    .enable_global(true)
    .build()?;

Implementations

impl HttpTracerProviderBuilder

pub fn new() -> Self

Creates a new HttpTracerProviderBuilder with default settings.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::new();

pub fn with_stdout_client(self) -> Self

Configures the builder to use a stdout client for exporting traces.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().with_stdout_client();

pub fn enable_fmt_layer(self, enabled: bool) -> Self

Enables or disables the fmt layer for logging.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().enable_fmt_layer(true);

pub fn with_tracer_name(self, tracer_name: impl Into<Cow<'static, str>>) -> Self

Sets the tracer name.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().with_tracer_name("my-service");

pub fn with_text_map_propagator<P>(self, propagator: P) -> Self

where P: TextMapPropagator + Send + Sync + 'static,

Adds a custom text map propagator.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;
use opentelemetry_sdk::propagation::TraceContextPropagator;

let builder = HttpTracerProviderBuilder::default()
    .with_text_map_propagator(TraceContextPropagator::new());

pub fn with_default_text_map_propagator(self) -> Self

Adds the default text map propagator (TraceContextPropagator).

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().with_default_text_map_propagator();

pub fn with_xray_text_map_propagator(self) -> Self

Adds the XRay text map propagator.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().with_xray_text_map_propagator();

pub fn with_id_generator<I>(self, id_generator: I) -> Self

where I: IdGenerator + Send + Sync + 'static,

Sets a custom ID generator.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;
use opentelemetry_sdk::trace::RandomIdGenerator;

let builder = HttpTracerProviderBuilder::default()
    .with_id_generator(RandomIdGenerator::default());

pub fn with_default_id_generator(self) -> Self

Sets the default ID generator (RandomIdGenerator).

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().with_default_id_generator();

pub fn with_xray_id_generator(self) -> Self

Adds the XRay ID generator.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().with_xray_id_generator();

pub fn enable_global(self, set_global: bool) -> Self

Enables or disables global installation of the tracer provider.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().enable_global(true);

pub fn with_simple_exporter(self) -> Self

Configures the builder to use a simple exporter.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().with_simple_exporter();

pub fn with_batch_exporter(self) -> Self

Configures the builder to use a batch exporter.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let builder = HttpTracerProviderBuilder::default().with_batch_exporter();

pub fn build(self) -> Result<TracerProvider, TraceError>

Builds the TracerProvider with the configured settings.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;
use opentelemetry_sdk::trace::{TracerProvider, Tracer};

let tracer_provider: TracerProvider = HttpTracerProviderBuilder::default()
    .with_stdout_client()
    .enable_fmt_layer(true)
    .with_tracer_name("my-service")
    .with_default_text_map_propagator()
    .with_default_id_generator()
    .enable_global(true)
    .build()?;

Trait Implementations

impl<C: Debug + HttpClient + 'static> Debug for HttpTracerProviderBuilder<C>

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

Formats the value using the given formatter.

impl Default for HttpTracerProviderBuilder

Provides a default implementation for HttpTracerProviderBuilder.

This implementation creates a new HttpTracerProviderBuilder with default settings by calling the new() method.

Examples

use lambda_otel_utils::HttpTracerProviderBuilder;

let default_builder = HttpTracerProviderBuilder::default();

fn default() -> Self

Returns the “default value” for a type.