Registro en Rust: mejores prácticas para principiantes

Registro en aplicaciones Rust: mejores prácticas para principiantes

El registro es uno de los aspectos más importantes del desarrollo de cualquier aplicación. Ayuda a rastrear errores, analizar el rendimiento y comprender el comportamiento del sistema en producción. En el ecosistema de Rust, existen varias bibliotecas potentes para el registro que permiten configurar de forma flexible la salida de mensajes. En este artículo, analizaremos las mejores prácticas de registro en Rust para principiantes, comenzando con conceptos básicos y terminando con ejemplos de código reales.

¿Por qué es importante el registro en Rust?

Rust es un lenguaje de programación de sistemas que se utiliza a menudo para crear aplicaciones de alta carga y críticas. En tales sistemas, cada error puede tener consecuencias graves. El registro permite:

\n
• Detectar errores — incluso si la aplicación no falla, los logs ayudarán a entender qué salió mal.
\n
• Monitorear el rendimiento — mida el tiempo de ejecución de las funciones y encuentre cuellos de botella.
\n
• Depurar escenarios complejos — en aplicaciones multiproceso, los logs son indispensables para comprender el orden de ejecución.
\n
• Garantizar la transparencia — en producción podrá ver lo que sucede con la aplicación en tiempo real.
\n

En Rust, la biblioteca estándar no incluye un registrador incorporado, pero la comunidad ha creado excelentes crates (bibliotecas) para esta tarea. Veremos los dos más populares: log + env_logger y tracing.

Comenzando con el crate log y env_logger

La forma más sencilla de agregar registro a una aplicación Rust es usar la combinación de los crates log y env_logger. log proporciona macros abstractas para el registro, mientras que env_logger proporciona una implementación concreta que se configura a través de variables de entorno.

Agregue las dependencias en Cargo.toml:

[dependencies]\nlog = "0.4"\nenv_logger = "0.10"

Ahora un ejemplo simple:

use log::{info, warn, error, debug};\n\nfn main() {\n    env_logger::init();\n\n    info!("Aplicación iniciada");\n    debug!("Modo de depuración activo");\n    warn!("Esto es una advertencia");\n    error!("Ocurrió un error: {}", "código desconocido");\n}

Por defecto, env_logger solo muestra mensajes de nivel error y superiores. Para ver todos los niveles, establezca la variable de entorno RUST_LOG:

RUST_LOG=debug cargo run

Verá mensajes de todos los niveles: error, warn, info, debug y trace. También puede filtrar por módulos:

RUST_LOG=my_crate=info cargo run

Esto mostrará solo info y superiores para el crate my_crate.

Registro avanzado con tracing

Para aplicaciones más complejas (servidores web, sistemas asíncronos), se recomienda usar el crate tracing. Admite registro estructurado, spans y eventos, lo que es especialmente útil para rastrear cadenas de llamadas en código asíncrono.

Agregue las dependencias:

[dependencies]\ntracing = "0.1"\ntracing-subscriber = "0.3"

Ejemplo usando spans:

use tracing::{info, error, span, Level};\nuse tracing_subscriber;\n\nfn main() {\n    tracing_subscriber::fmt::init();\n\n    let outer_span = span!(Level::INFO, "outer", work_id = 42);\n    let _enter = outer_span.enter();\n\n    info!("Iniciando trabajo");\n    process_data();\n    info!("Trabajo completado");\n}\n\nfn process_data() {\n    let inner_span = span!(Level::DEBUG, "process_data", data_id = 100);\n    let _enter = inner_span.enter();\n\n    // Simulación de error\n    if true {\n        error!("Error al procesar datos: ID {}", 100);\n    }\n}