Crate tracing_futures[][src]

Futures compatibility for tracing.

Overview

tracing is a framework for instrumenting Rust programs to collect structured, event-based diagnostic information. This crate provides utilities for using tracing to instrument asynchronous code written using futures and async/await.

The crate provides the following traits:

Compiler support: requires rustc 1.42+

Feature flags

This crate provides a number of feature flags that enable compatibility features with other crates in the asynchronous ecosystem:

The tokio, std-future and std features are enabled by default.

Supported Rust Versions

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

Tracing follows the same compiler support policies as the rest of the Tokio project. 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.45, the minimum supported version will not be increased past 1.42, 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.

Modules

executor

Implementations for Instrumented future executors.

Structs

Instrumented

A future, stream, sink, or executor that has been instrumented with a tracing span.

WithDispatch

A future, stream, sink, or executor that has been instrumented with a tracing subscriber.

Traits

Instrument

Extension trait allowing futures, streams, sinks, and executors to be instrumented with a tracing span.

WithSubscriber

Extension trait allowing futures, streams, and sinks to be instrumented with a tracing Subscriber.