From 424547241b5f71793c0b2beb648cecb6dc25c09c Mon Sep 17 00:00:00 2001 From: Manuel Cillero Date: Sat, 22 Oct 2022 12:43:50 +0200 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20[trace]=20Inicia=20la=20document?= =?UTF-8?q?aci=C3=B3n?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- pagetop/src/trace.rs | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/pagetop/src/trace.rs b/pagetop/src/trace.rs index f2e355ce..2b2f3fb1 100644 --- a/pagetop/src/trace.rs +++ b/pagetop/src/trace.rs @@ -1,2 +1,19 @@ +//! Registro de trazas y eventos de la aplicación. +//! +//! PageTop recopila la información de diagnóstico de la aplicación de manera estructurada y basada +//! en eventos. +//! +//! En sistemas asíncronos, interpretar los mensajes de registro tradicionales (*log*) a menudo +//! resulta complicado. Las tareas individuales se multiplexan para el mismo subproceso y los +//! eventos y mensajes de registro asociados se entremezclan, dificultando el seguimiento de la +//! secuencia lógica. +//! +//! PageTop usa [`tracing`](https://docs.rs/tracing) para permitir a las **aplicaciones** y los +//! **módulos** registrar eventos estructurados con información añadida sobre *temporalidad* y +//! *causalidad*. A diferencia de un mensaje de registro, un intervalo (*span*) tiene una hora de +//! inicio y de finalización, puede entrar y salir del flujo de la ejecución y puede existir dentro +//! de un árbol anidado de intervalos similares. Además, estos intervalos están *estructurados*, con +//! capacidad para grabar tipos de datos y mensajes de texto. + pub use tracing::{debug, error, info, trace, warn}; pub use tracing::{event, span, Level};