10 releases (4 breaking)

new 0.10.0 Mar 23, 2025
0.9.0 Feb 11, 2025
0.8.1 Feb 3, 2025
0.8.0 Nov 18, 2024
0.6.8 Jul 16, 2024

#684 in Debugging

Download history 2348/week @ 2024-12-06 2400/week @ 2024-12-13 1718/week @ 2024-12-20 2608/week @ 2024-12-27 7146/week @ 2025-01-03 6280/week @ 2025-01-10 4709/week @ 2025-01-17 13400/week @ 2025-01-24 19208/week @ 2025-01-31 16353/week @ 2025-02-07 12551/week @ 2025-02-14 31302/week @ 2025-02-21 40608/week @ 2025-02-28 46697/week @ 2025-03-07 29838/week @ 2025-03-14 31394/week @ 2025-03-21

155,189 downloads per month

Apache-2.0

190KB
4K SLoC

fastrace-opentelemetry

Documentation Crates.io LICENSE

OpenTelemetry reporter for fastrace.

Dependencies

[dependencies]
fastrace = "0.7"
fastrace-opentelemetry = "0.9"

Setup OpenTelemetry Collector

Start OpenTelemetry Collector with Jaeger and Zipkin receivers:

docker compose -f examples/docker-compose.yaml up

Then, run the synchronous example:

cargo run --example synchronous

Jaeger UI is available on http://127.0.0.1:16686/

Zipkin UI is available on http://127.0.0.1:9411/

Report to OpenTelemetry Collector

use std::borrow::Cow;
use fastrace::collector::Config;
use fastrace::prelude::*;
use fastrace_opentelemetry::OpenTelemetryReporter;
use opentelemetry_otlp::ExportConfig;
use opentelemetry_otlp::Protocol;
use opentelemetry_otlp::SpanExporter;
use opentelemetry_otlp::TonicConfig;
use opentelemetry::trace::SpanKind;
use opentelemetry_sdk::Resource;
use opentelemetry::KeyValue;
use opentelemetry::InstrumentationScope;
use opentelemetry_otlp::WithExportConfig;

// Initialize reporter
let reporter = OpenTelemetryReporter::new(
    SpanExporter::builder()
        .with_tonic()
        .with_endpoint("http://127.0.0.1:4317".to_string())
        .with_protocol(opentelemetry_otlp::Protocol::Grpc)
        .with_timeout(opentelemetry_otlp::OTEL_EXPORTER_OTLP_TIMEOUT_DEFAULT)
        .build()
        .expect("initialize oltp exporter"),
    SpanKind::Server,
    Cow::Owned(
        Resource::builder()
            .with_attributes([KeyValue::new("service.name", "asynchronous")])
            .build()
    ),
    InstrumentationScope::builder("example-crate").with_version(env!("CARGO_PKG_VERSION")).build(),
);
fastrace::set_reporter(reporter, Config::default());

{
    // Start tracing
    let root = Span::root("root", SpanContext::random());
}

fastrace::flush()

Dependencies

~4–10MB
~100K SLoC