tokio-rs/console
Console
Tokio Console es una herramienta de diagnóstico para monitorear y depurar tareas y recursos asíncronos dentro de un runtime de Tokio. Consiste en un servidor de telemetría que transmite diagnósticos de runtime en tiempo real y estados de tareas desde una aplicación a un cliente remoto, acompañado de un dashboard de interfaz de línea de comandos interactivo para visualizar patrones de ejecución.
El proyecto identifica anomalías en el runtime, como tareas que nunca ceden (yield), tareas que se auto-despiertan o futures sobredimensionados. Analiza el rendimiento de las tareas mediante histogramas y percentiles de tiempo de polling y programación para localizar cuellos de botella o operaciones estancadas.
El conjunto de herramientas cubre el monitoreo de recursos listando primitivas de sincronización y recursos de E/S para rastrear sus ciclos de vida. Permite la depuración de contención de recursos identificando qué tareas asíncronas están esperando recursos específicos para resolver bloqueos.
Features
- Runtime Diagnostics - Provides comprehensive tools for inspecting the internal state and task scheduling of a running Rust runtime.
- gRPC Data Streaming - Uses gRPC for high-performance streaming of runtime diagnostic data from the instrumented process to a remote client.
- Async Dependency Mapping - Maps the relationship between asynchronous tasks and synchronization primitives to detect runtime contention.
- Real-time Telemetry Streams - Implements a system for broadcasting live runtime diagnostics and task states over persistent gRPC streams.
- Async Resource Contention - Identifies which asynchronous tasks are blocking on specific resources to resolve deadlocks and synchronization delays.
- Runtime Instrumentation - Injects hooks into the asynchronous runtime to gather real-time polling durations and task states.
- Async Execution Debugging - Provides specialized diagnostics to identify blocking calls and execution flow issues in asynchronous Rust code.
- Async Primitive Monitoring - Lists and monitors synchronization primitives and I/O resources to track their lifecycle.
- Resource Contention Debugging - Identifies which asynchronous tasks are waiting on a specific resource to resolve runtime blocks.
- Runtime Telemetry - Exposes real-time runtime diagnostics and task states via a wire format for external analysis and monitoring.
- Task Monitoring - Tracks poll frequency and execution timing of asynchronous tasks to identify performance bottlenecks.
- Async Task Analyzers - Analyzes poll durations and scheduling bottlenecks to identify hangs and performance issues in async code.
- Remote Device Diagnostics - Streams real-time telemetry and execution data from a running process to a remote client for analysis.
- Client-Server Architecture - Implements a decoupled architecture where a telemetry server manages runtime state and a remote client provides the visualization interface.
- Anomaly Detection - Automatically identifies problematic runtime patterns such as tasks that never yield or self-waking tasks.
- Interactive Monitoring Visualizations - Offers an interactive CLI dashboard to visualize the state of instrumented asynchronous tasks.
- Performance Analysis - Interprets timing histograms and percentiles for polling durations to evaluate asynchronous task efficiency.
- Performance Histograms - Generates timing histograms and percentiles of task poll durations to identify scheduling bottlenecks.
- CLI Dashboards - Provides a data-rich interactive command-line interface for visualizing the internal state of a running process.
