Skip to content

nlcamp/opentelemetry-rust

This branch is 1253 commits behind open-telemetry/opentelemetry-rust:main.

Folders and files

NameName
Last commit message
Last commit date
Feb 13, 2021
Oct 27, 2020
Feb 13, 2021
Feb 9, 2021
Feb 9, 2021
Feb 14, 2021
Jan 25, 2021
Feb 14, 2021
Feb 14, 2021
Jan 25, 2021
Jan 25, 2021
Feb 14, 2021
Feb 10, 2021
Jan 5, 2021
Oct 18, 2020
Aug 12, 2020
Nov 3, 2020
Dec 7, 2020
Feb 13, 2021
Dec 2, 2019
Jan 25, 2021
Jan 21, 2021
Oct 18, 2020

Repository files navigation

OpenTelemetry — An observability framework for cloud-native software.

OpenTelemetry Rust

The Rust OpenTelemetry implementation.

Crates.io: opentelemetry Documentation LICENSE GitHub Actions CI Gitter chat

Website | Chat | Documentation

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. You can export and analyze them using Prometheus, Jaeger, and other observability tools.

Compiler support: requires rustc 1.46+

Getting Started

use opentelemetry::{sdk::export::trace::stdout, trace::Tracer};

fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync + 'static>> {
    // Create a new instrumentation pipeline
    // Note: uninstalling the tracer happens when the _uninstall
    // variable is dropped. Assigning it to _ will immediately
    // drop it and uninstall the tracer
    let (tracer, _uninstall) = stdout::new_pipeline().install();

    tracer.in_span("doing_work", |cx| {
        // Traced app logic here...
    });

    Ok(())
}

See the examples directory for different integration patterns.

Ecosystem

Related Crates

In addition to opentelemetry, the open-telemetry/opentelemetry-rust repository contains several additional crates designed to be used with the opentelemetry ecosystem. This includes a collection of trace SpanExporter and metrics pull and push controller implementations, as well as utility and adapter crates to assist in propagating state and instrumenting applications.

In particular, the following crates are likely to be of interest:

Additionally, there are also several third-party crates which are not maintained by the opentelemetry project. These include:

If you're the maintainer of an opentelemetry ecosystem crate not listed above, please let us know! We'd love to add your project to the list!

Supported Rust Versions

OpenTelemetry is built against the latest stable release. The minimum supported version is 1.46. The current OpenTelemetry version is not guaranteed to build on Rust versions earlier than the minimum supported version.

The current stable Rust compiler and the three most recent minor versions before it will always be supported. For example, if the current stable compiler version is 1.49, the minimum supported version will not be increased past 1.46, three minor versions prior. Increasing the minimum supported compiler version is not considered a semver breaking change as long as doing so complies with this policy.

Contributing

See the contributing file.

About

OpenTelemetry API and SDK for Rust

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 99.7%
  • Shell 0.3%