Struct TelemetryConfigBuilder

pub struct TelemetryConfigBuilder { /* private fields */ }

Builder for configuring OpenTelemetry telemetry initialization.

This builder provides a fluent interface for customizing telemetry configuration:

• Custom resources for additional attributes
• Custom span processors for different export strategies
• Custom library name for instrumentation
• Control over formatting layer for logs

Environment Variables

Several environment variables affect the configuration:

• OTEL_SERVICE_NAME: Service name for spans
• AWS_LAMBDA_FUNCTION_NAME: Fallback service name
• OTEL_RESOURCE_ATTRIBUTES: Additional resource attributes
• LAMBDA_SPAN_PROCESSOR_QUEUE_SIZE: Span buffer size
• OTLP_STDOUT_SPAN_EXPORTER_COMPRESSION_LEVEL: Export compression
• LAMBDA_TRACING_ENABLE_FMT_LAYER: Enable formatting layer (default: false)

Example

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

let config = TelemetryConfigBuilder::default()
    .with_library_name("my-lambda")
    .with_fmt_layer(true)
    .with_span_processor(SimpleSpanProcessor::new(
        Box::new(OtlpStdoutSpanExporter::default())
    ))
    .build();

Implementations

impl TelemetryConfigBuilder

pub fn with_resource(self, resource: Resource) -> Self

Add a custom resource to the tracer provider.

If not set, the default Lambda resource will be used, which includes:

• AWS Lambda environment attributes (region, function name, etc.)
• OTEL_SERVICE_NAME or AWS_LAMBDA_FUNCTION_NAME as service.name
• Any attributes from OTEL_RESOURCE_ATTRIBUTES environment variable

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

where T: SpanProcessor + 'static,

Add a span processor to the tracer provider.

Note: Adding any processor will disable the default Lambda processor pipeline. If you need multiple processors, call this method multiple times.

Example

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

let config = TelemetryConfigBuilder::default()
    .with_span_processor(SimpleSpanProcessor::new(Box::new(OtlpStdoutSpanExporter::default())))
    .build();

pub fn with_library_name<S>(self, name: S) -> Self

where S: Into<Cow<'static, str>>,

Set a custom library name for the tracer.

If not set, defaults to the package name (“lambda-otel-lite”). This value is used as the library.name attribute in spans.

pub fn with_fmt_layer(self, enable: bool) -> Self

Enable or disable the formatting layer for logs.

When enabled, trace data will also appear in application logs. Defaults to false if not set, can be overridden by LAMBDA_TRACING_ENABLE_FMT_LAYER.

pub fn build(self) -> TelemetryConfig

Build the final telemetry configuration.

If no resource was set, uses the default Lambda resource. If no processors were added, uses the default Lambda processor pipeline. If fmt_layer not set, checks LAMBDA_TRACING_ENABLE_FMT_LAYER environment variable.

Trait Implementations

impl Default for TelemetryConfigBuilder

fn default() -> TelemetryConfigBuilder

Returns the “default value” for a type.