Struct TelemetryConfig

pub struct TelemetryConfig {
    pub enable_fmt_layer: bool,
    pub set_global_provider: bool,
    pub resource: Option<Resource>,
    pub env_var_name: Option<String>,
    /* private fields */
}

Configuration for OpenTelemetry initialization.

Provides configuration options for telemetry setup. Use TelemetryConfig::default() for standard Lambda configuration, or the builder pattern for customization.

Fields

• enable_fmt_layer - Enable console output for debugging (default: false)
• set_global_provider - Set as global tracer provider (default: true)
• resource - Custom resource attributes (default: auto-detected from Lambda)
• env_var_name - Environment variable name for log level configuration

Examples

Basic usage with default configuration:

use lambda_otel_lite::telemetry::TelemetryConfig;

let config = TelemetryConfig::default();

Custom configuration with resource attributes:

use lambda_otel_lite::telemetry::TelemetryConfig;
use opentelemetry::KeyValue;
use opentelemetry_sdk::Resource;

let config = TelemetryConfig::builder()
    .resource(Resource::builder()
        .with_attributes(vec![KeyValue::new("version", "1.0.0")])
        .build())
    .build();

Custom configuration with logging options:

use lambda_otel_lite::telemetry::TelemetryConfig;

let config = TelemetryConfig::builder()
    .enable_fmt_layer(true)  // Enable console output for debugging
    .env_var_name("MY_CUSTOM_LOG_LEVEL".to_string())  // Custom env var for log level
    .build();

Fields

enable_fmt_layer: bool

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

set_global_provider: bool

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

resource: Option<Resource>

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)

env_var_name: Option<String>

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)

Implementations

impl TelemetryConfig

pub fn builder() -> TelemetryConfigBuilder

Create an instance of TelemetryConfig using the builder syntax

Trait Implementations

impl Debug for TelemetryConfig

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

Formats the value using the given formatter.

impl Default for TelemetryConfig

fn default() -> Self

Returns the “default value” for a type.