How to Use Tracing for Async Debugging in Rust

Use the tracing crate with the #[tracing::instrument] attribute to automatically log entry, exit, and arguments for async functions. Add the dependency to your Cargo.toml and annotate your async function to capture execution flow.

[dependencies]
tracing = "0.1"

use tracing::instrument;

#[instrument(level = "debug")]
async fn my_async_task() {
    // Tracing automatically logs when this function starts and ends
    tokio::time::sleep(tokio::time::Duration::from_millis(100)).await;
}

Run your application with RUST_LOG=debug cargo run to see the trace output in the console.

Tracing acts like a GPS for your code, recording exactly when functions start, stop, and what data they process. It is essential for async debugging because it helps you see where tasks get stuck or fail without cluttering your code with manual print statements. Think of it as a black box recorder that logs the journey of every request through your application.