| # tracing-log |
| |
| [`log`] compatibility for [`tracing`]. |
| |
| [![Crates.io][crates-badge]][crates-url] |
| [![Documentation][docs-badge]][docs-url] |
| [![Documentation (master)][docs-master-badge]][docs-master-url] |
| [![MIT licensed][mit-badge]][mit-url] |
| [![Build Status][azure-badge]][azure-url] |
| [![Discord chat][discord-badge]][discord-url] |
| ![maintenance status][maint-badge] |
| |
| |
| [Documentation][docs-url] | [Chat (discord)][discord-url] |
| |
| |
| [crates-badge]: https://img.shields.io/crates/v/tracing-log.svg |
| [crates-url]: https://crates.io/crates/tracing-log |
| [docs-badge]: https://docs.rs/tracing-log/badge.svg |
| [docs-url]: https://docs.rs/tracing-log |
| [docs-master-badge]: https://img.shields.io/badge/docs-master-blue |
| [docs-master-url]: https://tracing-rs.netlify.com/tracing_log |
| [mit-badge]: https://img.shields.io/badge/license-MIT-blue.svg |
| [mit-url]: LICENSE |
| [azure-badge]: https://dev.azure.com/tracing/tracing/_apis/build/status/tokio-rs.tracing?branchName=master |
| [azure-url]: https://dev.azure.com/tracing/tracing/_build/latest?definitionId=1&branchName=master |
| [discord-badge]: https://img.shields.io/discord/500028886025895936?logo=discord&label=discord&logoColor=white |
| [discord-url]: https://discordapp.com/invite/XdPzyTZ |
| [maint-badge]: https://img.shields.io/badge/maintenance-experimental-blue.svg |
| |
| ## Overview |
| |
| [`tracing`] is a framework for instrumenting Rust programs with context-aware, |
| structured, event-based diagnostic information. This crate provides |
| compatibility layers for using `tracing` alongside the logging facade provided |
| by the [`log`] crate. |
| |
| This crate provides: |
| |
| - [`AsTrace`] and [`AsLog`] traits for converting between `tracing` and `log` types. |
| - [`LogTracer`], a [`log::Log`] implementation that consumes [`log::Record`]s |
| and outputs them as [`tracing::Event`]s. |
| - An [`env_logger`] module, with helpers for using the [`env_logger` crate] |
| with `tracing` (optional, enabled by the `env-logger` feature). |
| |
| [`tracing`]: https://crates.io/crates/tracing |
| [`log`]: https://crates.io/crates/log |
| [`AsTrace`]: https://docs.rs/tracing-log/latest/tracing_log/trait.AsTrace.html |
| [`AsLog`]: https://docs.rs/tracing-log/latest/tracing_log/trait.AsLog.html |
| [`LogTracer`]: https://docs.rs/tracing-log/latest/tracing_log/struct.LogTracer.html |
| [`log::Log`]: https://docs.rs/log/latest/log/trait.Log.html |
| [`log::Record`]: https://docs.rs/log/latest/log/struct.Record.html |
| [`tracing::Subscriber`]: https://docs.rs/tracing/latest/tracing/trait.Subscriber.html |
| [`tracing::Event`]: https://docs.rs/tracing/latest/tracing/struct.Event.html |
| |
| ## License |
| |
| This project is licensed under the [MIT license](LICENSE). |
| |
| ### Contribution |
| |
| Unless you explicitly state otherwise, any contribution intentionally submitted |
| for inclusion in Tracing by you, shall be licensed as MIT, without any additional |
| terms or conditions. |
