Struct TelemetryConfigBuilder

pub struct TelemetryConfigBuilder<S: State = Empty> { /* private fields */ }

Use builder syntax to set the inputs and finish with build().

Implementations

impl<S: State> TelemetryConfigBuilder<S>

pub fn build(self) -> TelemetryConfig

where S: IsComplete,

Finish building and return the requested object

pub fn enable_fmt_layer( self, value: bool, ) -> TelemetryConfigBuilder<SetEnableFmtLayer<S>>

where S::EnableFmtLayer: IsUnset,

Optional (Some / Option setters). Default: false.

Enable console output for debugging.

When enabled, spans and events will be printed to the console in addition to being exported through the configured span processors. This is useful for debugging but adds overhead and should be disabled in production.

Default: false

pub fn maybe_enable_fmt_layer( self, value: Option<bool>, ) -> TelemetryConfigBuilder<SetEnableFmtLayer<S>>

where S::EnableFmtLayer: IsUnset,

Optional (Some / Option setters). Default: false.

Enable console output for debugging.

When enabled, spans and events will be printed to the console in addition to being exported through the configured span processors. This is useful for debugging but adds overhead and should be disabled in production.

Default: false

pub fn set_global_provider( self, value: bool, ) -> TelemetryConfigBuilder<SetSetGlobalProvider<S>>

where S::SetGlobalProvider: IsUnset,

Optional (Some / Option setters). Default: true.

Set this provider as the global OpenTelemetry provider.

When enabled, the provider will be registered as the global provider for the OpenTelemetry API. This allows using the global tracer API without explicitly passing around the provider.

Default: true

pub fn maybe_set_global_provider( self, value: Option<bool>, ) -> TelemetryConfigBuilder<SetSetGlobalProvider<S>>

where S::SetGlobalProvider: IsUnset,

Optional (Some / Option setters). Default: true.

Set this provider as the global OpenTelemetry provider.

When enabled, the provider will be registered as the global provider for the OpenTelemetry API. This allows using the global tracer API without explicitly passing around the provider.

Default: true

pub fn resource(self, value: Resource) -> TelemetryConfigBuilder<SetResource<S>>

where S::Resource: IsUnset,

Optional (Some / Option setters).

Custom resource attributes for all spans.

If not provided, resource attributes will be automatically detected from the Lambda environment. Custom resources will override any automatically detected attributes with the same keys.

Default: None (auto-detected from Lambda environment)

pub fn maybe_resource( self, value: Option<Resource>, ) -> TelemetryConfigBuilder<SetResource<S>>

where S::Resource: IsUnset,

Optional (Some / Option setters).

Custom resource attributes for all spans.

If not provided, resource attributes will be automatically detected from the Lambda environment. Custom resources will override any automatically detected attributes with the same keys.

Default: None (auto-detected from Lambda environment)

pub fn env_var_name( self, value: String, ) -> TelemetryConfigBuilder<SetEnvVarName<S>>

where S::EnvVarName: IsUnset,

Optional (Some / Option setters).

Environment variable name to use for log level configuration.

This field specifies which environment variable should be used to configure the tracing subscriber’s log level filter. If not specified, the system will first check for RUST_LOG and then fall back to AWS_LAMBDA_LOG_LEVEL.

Default: None (uses RUST_LOG or AWS_LAMBDA_LOG_LEVEL)

pub fn maybe_env_var_name( self, value: Option<String>, ) -> TelemetryConfigBuilder<SetEnvVarName<S>>

where S::EnvVarName: IsUnset,

Optional (Some / Option setters).

Environment variable name to use for log level configuration.

This field specifies which environment variable should be used to configure the tracing subscriber’s log level filter. If not specified, the system will first check for RUST_LOG and then fall back to AWS_LAMBDA_LOG_LEVEL.

Default: None (uses RUST_LOG or AWS_LAMBDA_LOG_LEVEL)

impl<S: State> TelemetryConfigBuilder<S>

Builder methods for adding span processors and other configuration

pub fn with_span_processor<T>(self, processor: T) -> Self

where T: SpanProcessor + 'static,

Add a span processor to the tracer provider.

This method allows adding custom span processors for trace data processing. Multiple processors can be added by calling this method multiple times.

Arguments

• processor - A span processor implementing the SpanProcessor trait

Examples

use lambda_otel_lite::TelemetryConfig;
use opentelemetry_sdk::trace::SimpleSpanProcessor;
use otlp_stdout_span_exporter::OtlpStdoutSpanExporter;

// Only use builder when adding custom processors
let config = TelemetryConfig::builder()
    .with_span_processor(SimpleSpanProcessor::new(
        Box::new(OtlpStdoutSpanExporter::default())
    ))
    .build();

pub fn with_propagator<T>(self, propagator: T) -> Self

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

Add a propagator to the list of propagators.

Multiple propagators can be added and will be combined into a composite propagator. The default propagator is TraceContextPropagator.

Arguments

• propagator - A propagator implementing the TextMapPropagator trait

Examples

use lambda_otel_lite::TelemetryConfig;
use opentelemetry_sdk::propagation::BaggagePropagator;

let config = TelemetryConfig::builder()
    .with_propagator(BaggagePropagator::new())
    .build();