{"id":13499517,"url":"https://github.com/open-telemetry/opentelemetry-rust","last_synced_at":"2025-05-13T16:04:25.126Z","repository":{"id":37335294,"uuid":"221058575","full_name":"open-telemetry/opentelemetry-rust","owner":"open-telemetry","description":"The Rust OpenTelemetry implementation","archived":false,"fork":false,"pushed_at":"2025-04-29T17:49:49.000Z","size":8490,"stargazers_count":2150,"open_issues_count":251,"forks_count":516,"subscribers_count":28,"default_branch":"main","last_synced_at":"2025-04-30T12:23:03.939Z","etag":null,"topics":["jaeger","logging","metrics","opentelemetry","prometheus","tracing","zipkin"],"latest_commit_sha":null,"homepage":"https://opentelemetry.io","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/open-telemetry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-11T19:53:32.000Z","updated_at":"2025-04-30T07:48:02.000Z","dependencies_parsed_at":"2023-10-30T05:23:11.569Z","dependency_job_id":"a036abf5-5d64-40a2-839e-3420cbd53c04","html_url":"https://github.com/open-telemetry/opentelemetry-rust","commit_stats":{"total_commits":1393,"total_committers":218,"mean_commits":6.389908256880734,"dds":0.8320172290021537,"last_synced_commit":"967dc9305582aa22097ec6c81cfa2e84a4ea436c"},"previous_names":[],"tags_count":221,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-rust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-rust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-rust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-telemetry%2Fopentelemetry-rust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/open-telemetry","download_url":"https://codeload.github.com/open-telemetry/opentelemetry-rust/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252590509,"owners_count":21772934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jaeger","logging","metrics","opentelemetry","prometheus","tracing","zipkin"],"created_at":"2024-07-31T22:00:33.982Z","updated_at":"2025-05-05T22:47:02.775Z","avatar_url":"https://github.com/open-telemetry.png","language":"Rust","readme":"# OpenTelemetry Rust\n\nThe Rust [OpenTelemetry](https://opentelemetry.io/) implementation.\n\n[![Crates.io: opentelemetry](https://img.shields.io/crates/v/opentelemetry.svg)](https://crates.io/crates/opentelemetry)\n[![LICENSE](https://img.shields.io/crates/l/opentelemetry)](./LICENSE)\n[![GitHub Actions CI](https://github.com/open-telemetry/opentelemetry-rust/workflows/CI/badge.svg)](https://github.com/open-telemetry/opentelemetry-rust/actions?query=workflow%3ACI+branch%3Amain)\n[![Documentation](https://docs.rs/opentelemetry/badge.svg)](https://docs.rs/opentelemetry)\n[![codecov](https://codecov.io/gh/open-telemetry/opentelemetry-rust/branch/main/graph/badge.svg)](https://codecov.io/gh/open-telemetry/opentelemetry-rust)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/open-telemetry/opentelemetry-rust/badge)](https://scorecard.dev/viewer/?uri=github.com/open-telemetry/opentelemetry-rust)\n[![Slack](https://img.shields.io/badge/slack-@cncf/otel/rust-brightgreen.svg?logo=slack)](https://cloud-native.slack.com/archives/C03GDP0H023)\n\n## Overview\n\nOpenTelemetry is a collection of tools, APIs, and SDKs used to instrument,\ngenerate, collect, and export telemetry data (metrics, logs, and traces) for\nanalysis in order to understand your software's performance and behavior. You\ncan export and analyze them using [Prometheus], [Jaeger], and other\nobservability tools.\n\n*[Supported Rust Versions](#supported-rust-versions)*\n\n[Prometheus]: https://prometheus.io\n[Jaeger]: https://www.jaegertracing.io\n\n## Project Status\n\nThe table below summarizes the overall status of each component. Some components\ninclude unstable features, which are documented in their respective crate\ndocumentation.\n\n| Signal/Component      | Overall Status     |\n| --------------------  | ------------------ |\n| Context               | Beta               |\n| Baggage               | RC                 |\n| Propagators           | Beta               |\n| Logs-API              | Stable*            |\n| Logs-SDK              | Stable              |\n| Logs-OTLP Exporter    | RC                 |\n| Logs-Appender-Tracing | Stable             |\n| Metrics-API           | Stable             |\n| Metrics-SDK           | RC                 |\n| Metrics-OTLP Exporter | RC                 |\n| Traces-API            | Beta               |\n| Traces-SDK            | Beta               |\n| Traces-OTLP Exporter  | Beta               |\n\n*OpenTelemetry Rust is not introducing a new end user callable Logging API.\nInstead, it provides [Logs Bridge\nAPI](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/logs/api.md),\nthat allows one to write log appenders that can bridge existing logging\nlibraries to the OpenTelemetry log data model. The following log appenders are\navailable:\n\n* [opentelemetry-appender-log](opentelemetry-appender-log/README.md)\n* [opentelemetry-appender-tracing](opentelemetry-appender-tracing/README.md)\n\nIf you already use the logging APIs from above, continue to use them, and use\nthe appenders above to bridge the logs to OpenTelemetry. If you are using a\nlibrary not listed here, feel free to contribute a new appender for the same.\n\nIf you are starting fresh, we recommend using\n[tracing](https://github.com/tokio-rs/tracing) as your logging API. It supports\nstructured logging and is actively maintained. `OpenTelemetry` itself uses\n`tracing` for its internal logging.\n\nProject versioning information and stability guarantees can be found\n[here](VERSIONING.md).\n\n## Getting Started\n\nIf you are new to OpenTelemetry, start with the [Stdout\nExample](./opentelemetry-stdout/examples/basic.rs). This example demonstrates\nhow to use OpenTelemetry for logs, metrics, and traces, and display\ntelemetry data on your console.\n\nFor those using OTLP, the recommended OpenTelemetry Exporter for production\nscenarios, refer to the [OTLP Example -\nHTTP](./opentelemetry-otlp/examples/basic-otlp-http/README.md) and the [OTLP\nExample - gRPC](./opentelemetry-otlp/examples/basic-otlp/README.md).\n\nAdditional examples for various integration patterns can be found in the\n[examples](./examples) directory.\n\n## Overview of crates\n\nThe following crates are maintained in this repo:\n\n* [`opentelemetry`] This is the OpenTelemetry API crate, and is the crate\n  required to instrument libraries and applications. It contains Context API,\n  Baggage API, Propagators API, Logging Bridge API, Metrics API, and Tracing\n  API.\n* [`opentelemetry-sdk`] This is the OpenTelemetry SDK crate, and contains the\n  official OpenTelemetry SDK implementation. It contains Logging SDK, Metrics\n  SDK, and Tracing SDK. It also contains propagator implementations.\n* [`opentelemetry-otlp`] - exporter to send telemetry (logs, metrics and traces)\n  in the [OTLP\n  format](https://github.com/open-telemetry/opentelemetry-specification/tree/main/specification/protocol)\n  to an endpoint accepting OTLP. This could be the [OTel\n  Collector](https://github.com/open-telemetry/opentelemetry-collector),\n  telemetry backends like [Jaeger](https://www.jaegertracing.io/),\n  [Prometheus](https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver)\n  or [vendor specific endpoints](https://opentelemetry.io/ecosystem/vendors/).\n* [`opentelemetry-stdout`] exporter for sending logs, metrics and traces to\n  stdout, for learning/debugging purposes.  \n* [`opentelemetry-http`] This crate contains utility functions to help with\n  exporting telemetry, propagation, over [`http`].\n* [`opentelemetry-appender-log`] This crate provides logging appender to route\n  logs emitted using the [log](https://docs.rs/log/latest/log/) crate to\n  opentelemetry.\n* [`opentelemetry-appender-tracing`] This crate provides logging appender to\n  route logs emitted using the [tracing](https://crates.io/crates/tracing) crate\n  to opentelemetry.  \n* [`opentelemetry-jaeger-propagator`] provides context propagation using [jaeger\n  propagation\n  format](https://www.jaegertracing.io/docs/1.18/client-libraries/#propagation-format).\n* [`opentelemetry-prometheus`] provides a pipeline and exporter for sending\n  metrics to [`Prometheus`].\n* [`opentelemetry-semantic-conventions`] provides standard names and semantic\n  otel conventions.\n* [`opentelemetry-zipkin`] provides a pipeline and exporter for sending traces\n  to [`Zipkin`].\n\nIn addition, there are several other useful crates in the [OTel Rust Contrib\nrepo](https://github.com/open-telemetry/opentelemetry-rust-contrib). A lot of\ncrates maintained outside OpenTelemetry owned repos can be found in the\n[OpenTelemetry\nRegistry](https://opentelemetry.io/ecosystem/registry/?language=rust).\n\n[`opentelemetry`]: https://crates.io/crates/opentelemetry\n[`opentelemetry-sdk`]: https://crates.io/crates/opentelemetry-sdk\n[`opentelemetry-appender-log`]: https://crates.io/crates/opentelemetry-appender-log\n[`opentelemetry-appender-tracing`]: https://crates.io/crates/opentelemetry-appender-tracing\n[`opentelemetry-http`]: https://crates.io/crates/opentelemetry-http\n[`opentelemetry-otlp`]: https://crates.io/crates/opentelemetry-otlp\n[`opentelemetry-stdout`]: https://crates.io/crates/opentelemetry-stdout\n[`opentelemetry-jaeger-propagator`]: https://crates.io/crates/opentelemetry-jaeger-propagator\n[`opentelemetry-prometheus`]: https://crates.io/crates/opentelemetry-prometheus\n[`Prometheus`]: https://prometheus.io\n[`opentelemetry-zipkin`]: https://crates.io/crates/opentelemetry-zipkin\n[`Zipkin`]: https://zipkin.io\n[`opentelemetry-semantic-conventions`]: https://crates.io/crates/opentelemetry-semantic-conventions\n[`http`]: https://crates.io/crates/http\n\n## Supported Rust Versions\n\nOpenTelemetry is built against the latest stable release. The minimum supported\nversion is 1.75. The current OpenTelemetry version is not guaranteed to build\non Rust versions earlier than the minimum supported version.\n\nThe current stable Rust compiler and the three most recent minor versions\nbefore it will always be supported. For example, if the current stable compiler\nversion is 1.49, the minimum supported version will not be increased past 1.46,\nthree minor versions prior. Increasing the minimum supported compiler version\nis not considered a semver breaking change as long as doing so complies with\nthis policy.\n\n## Contributing\n\nSee the [contributing file](CONTRIBUTING.md).\n\nThe Rust special interest group (SIG) meets weekly on Tuesdays at 9 AM Pacific\nTime. The meeting is subject to change depending on contributors' availability.\nCheck the [OpenTelemetry community\ncalendar](https://github.com/open-telemetry/community?tab=readme-ov-file#calendar)\nfor specific dates and for Zoom meeting links. \"OTel Rust SIG\" is the name of\nmeeting for this group.\n\nMeeting notes are available as a public [Google\ndoc](https://docs.google.com/document/d/12upOzNk8c3SFTjsL6IRohCWMgzLKoknSCOOdMakbWo4/edit).\nIf you have trouble accessing the doc, please get in touch on\n[Slack](https://cloud-native.slack.com/archives/C03GDP0H023).\n\nThe meeting is open for all to join. We invite everyone to join our meeting,\nregardless of your experience level. Whether you're a seasoned OpenTelemetry\ndeveloper, just starting your journey, or simply curious about the work we do,\nyou're more than welcome to participate!\n\n## Approvers and Maintainers\n\n### Maintainers\n\n* [Cijo Thomas](https://github.com/cijothomas), Microsoft\n* [Harold Dost](https://github.com/hdost)\n* [Lalit Kumar Bhasin](https://github.com/lalitb), Microsoft\n* [Utkarsh Umesan Pillai](https://github.com/utpilla), Microsoft\n* [Zhongyang Wu](https://github.com/TommyCpp)\n\n### Approvers\n\n* [Anton Grübel](https://github.com/gruebel), Baz\n* [Björn Antonsson](https://github.com/bantonsson), Datadog\n* [Shaun Cox](https://github.com/shaun-cox), Microsoft\n* [Scott Gerring](https://github.com/scottgerring), Datadog\n\n### Emeritus\n\n* [Dirkjan Ochtman](https://github.com/djc)\n* [Jan Kühle](https://github.com/frigus02)\n* [Julian Tescher](https://github.com/jtescher)\n* [Isobel Redelmeier](https://github.com/iredelmeier)\n* [Mike Goldsmith](https://github.com/MikeGoldsmith)\n\n### Thanks to all the people who have contributed\n\n[![contributors](https://contributors-img.web.app/image?repo=open-telemetry/opentelemetry-rust)](https://github.com/open-telemetry/opentelemetry-rust/graphs/contributors)\n","funding_links":[],"categories":["Rust","Applications","\u003ca name=\"Rust\"\u003e\u003c/a\u003eRust","Uncategorized"],"sub_categories":["Observability","Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-telemetry%2Fopentelemetry-rust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopen-telemetry%2Fopentelemetry-rust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-telemetry%2Fopentelemetry-rust/lists"}