Monitoramento de aplicações Rust: biblioteca tracing |…

O que é `tracing`?

tracing é um poderoso framework para logging estruturado, profiling e monitoramento de aplicações em Rust. Diferente de loggers simples (como log), o tracing permite criar spans (span) hierárquicos e eventos (event) com contexto, o que é ideal para rastrear requisições, transações e operações assíncronas.

Por que o monitoramento é necessário em Rust?

As aplicações Rust são frequentemente usadas em sistemas de alta carga, onde a performance e a estabilidade são críticas. Sem monitoramento, você não conseguirá:

Rastrear requisições lentas
Encontrar vazamentos de memória ou panics
Entender por que um microsserviço caiu

O tracing resolve esse problema fornecendo ferramentas para coleta de métricas, tracing e logging em uma API unificada.

Instalação

Adicione ao Cargo.toml:

[dependencies]tracing = "0.1"tracing-subscriber = "0.3"tracing-appender = "0.2"

Para monitoramento avançado (OpenTelemetry), use tracing-opentelemetry.

Principais funcionalidades

Spans (spans) — intervalos de tempo com contexto (ex.: processamento de uma requisição HTTP).
Eventos (events) — pontos no tempo (ex.: um erro ou aviso).
Campos estruturados — passagem de dados no formato key=value.
Suporte assíncrono — funcionamento correto com tokio/async-std.
Exportação para OpenTelemetry — integração com Jaeger, Prometheus, Grafana.

Exemplo de código em Rust

use tracing::{info, error, span, Level};use tracing_subscriber;

fn main() {    // Inicialização do logger    tracing_subscriber::fmt()        .with_env_filter("my_app=info")        .init();

    // Criação de um span (ex.: para uma requisição HTTP)    let root = span!(Level::INFO, "request", method = "GET", path = "/api/users");    let _guard = root.enter();

    // Logging com contexto    info!(user_id = 42, "Processando requisição");        // Erro com campos    error!(        error_code = 500,        message = "Erro interno do servidor",        "Erro ao obter dados"    );

    // Saída automática do span quando _guard é descartado}