From 7860a9c661c11377018508484b3f313a1b70fb0e Mon Sep 17 00:00:00 2001 From: Quinn <57224050+QnnOkabayashi@users.noreply.github.com> Date: Thu, 17 Feb 2022 14:14:53 -0500 Subject: [PATCH] docs: add `tracing-forest` to "Related Crates" section (#1935) ## Motivation This PR adds [`tracing-forest`](https://crates.io/crates/tracing-forest) to the list of related crates. `tracing-forest` provides contextual coherence when writing logs, and is being used by projects like [Kanidm](https://github.com/kanidm/kanidm/). ## Solution I added it to the documentation in `lib.rs` and in the README. Am I missing anything else? --- README.md | 3 +++ tracing/src/lib.rs | 3 +++ 2 files changed, 6 insertions(+) diff --git a/README.md b/README.md index be5e7b00d6..b90b900bb7 100644 --- a/README.md +++ b/README.md @@ -401,6 +401,8 @@ are not maintained by the `tokio` project. These include: - [`tracing-elastic-apm`] provides a layer for reporting traces to [Elastic APM]. - [`tracing-etw`] provides a layer for emitting Windows [ETW] events. - [`sentry-tracing`] provides a layer for reporting events and traces to [Sentry]. +- [`tracing-forest`] provides a subscriber that preserves contextual coherence by + grouping together logs from the same spans during writing. (if you're the maintainer of a `tracing` ecosystem crate not in this list, please let us know!) @@ -435,6 +437,7 @@ please let us know!) [ETW]: https://docs.microsoft.com/en-us/windows/win32/etw/about-event-tracing [`sentry-tracing`]: https://crates.io/crates/sentry-tracing [Sentry]: https://sentry.io/welcome/ +[`tracing-forest`]: https://crates.io/crates/tracing-forest **Note:** that some of the ecosystem crates are currently unreleased and undergoing active development. They may be less stable than `tracing` and diff --git a/tracing/src/lib.rs b/tracing/src/lib.rs index adc3ce6fc3..3fdbe63a07 100644 --- a/tracing/src/lib.rs +++ b/tracing/src/lib.rs @@ -803,6 +803,8 @@ //! - [`tracing-fluent-assertions`] provides a fluent assertions-style testing //! framework for validating the behavior of `tracing` spans. //! - [`sentry-tracing`] provides a layer for reporting events and traces to [Sentry]. +//! - [`tracing-forest`] provides a subscriber that preserves contextual coherence by +//! grouping together logs from the same spans during writing. //! //! If you're the maintainer of a `tracing` ecosystem crate not listed above, //! please let us know! We'd love to add your project to the list! @@ -836,6 +838,7 @@ //! [`tracing-fluent-assertions`]: https://crates.io/crates/tracing-fluent-assertions //! [`sentry-tracing`]: https://crates.io/crates/sentry-tracing //! [Sentry]: https://sentry.io/welcome/ +//! [`tracing-forest`]: https://crates.io/crates/tracing-forest //! //!
//!