The Rust OpenTelemetry implementation.
Website | Chat | Documentation
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
See the examples directory for different integration patterns.
In addition to
repository contains several additional crates designed to be used with the
opentelemetry ecosystem. This includes a collection of trace
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:
opentelemetry-httpprovides an interface for injecting and extracting trace information from
opentelemetry-jaegerprovides a pipeline and exporter for sending trace information to
opentelemetry-otlpexporter for sending trace and metric data in the OTLP format to the OpenTelemetry collector.
opentelemetry-prometheusprovides a pipeline and exporter for sending metrics information to
opentelemetry-zipkinprovides a pipeline and exporter for sending trace information to
opentelemetry-datadogprovides additional exporters to
opentelemetry-awsprovides unofficial propagators for AWS X-ray.
opentelemetry-contribprovides additional exporters and propagators that are experimental.
opentelemetry-semantic-conventionsprovides standard names and semantic otel conventions.
opentelemetry-stackdriverprovides an exporter for Google's Cloud Trace (which used to be called StackDriver).
Additionally, there are also several third-party crates which are not
maintained by the
opentelemetry project. These include:
tracing-opentelemetryprovides integration for applications instrumented using the
tracingAPI and ecosystem.
actix-web-opentelemetryprovides integration for the
actix-webweb server and ecosystem.
opentelemetry-application-insightsprovides an unofficial Azure Application Insights exporter.
opentelemetry-tideprovides integration for the
Tideweb server and ecosystem.
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.
See the contributing file.