OpenTelemetry AWS

Additional types for exporting OpenTelemetry data to AWS.

Overview

OpenTelemetry is a collection of tools, APIs, and SDKs used to instrument, generate, collect, and export telemetry data (metrics, logs, and traces) for analysis in order to understand your software's performance and behavior. This crate provides additional propagators and exporters for sending telemetry data to AWS's telemetry platform.

Components

Quick Start

Basic setup forwarding Segments to the local X-Ray daemon (requires xray-daemon-client feature):

use opentelemetry_aws::{
    trace::XrayIdGenerator,
    xray_exporter::{XrayExporter, daemon_client::XrayDaemonClient},
};
use opentelemetry_sdk::trace::SdkTracerProvider;
use opentelemetry::global;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Create a client that sends to the X-Ray daemon on localhost:2000 (UDP)
    let daemon_addr = SocketAddr::new(IpAddr::V4(Ipv4Addr::LOCALHOST), 2000);
    let client = XrayDaemonClient::new(daemon_addr)?;

    // Create the exporter
    let exporter = XrayExporter::new(client);

    // Build and register the tracer provider
    let provider = SdkTracerProvider::builder()
        .with_id_generator(XrayIdGenerator::default())
        .with_batch_exporter(exporter)
        .build();

    global::set_tracer_provider(provider);
    Ok(())
}

Feature Flags