tokio-rs/console
Console
Tokio Console is a diagnostic tool for monitoring and debugging asynchronous tasks and resources within a Tokio runtime. It consists of a telemetry server that streams real-time runtime diagnostics and task states from an application to a remote client, accompanied by an interactive command-line interface dashboard for visualizing execution patterns.
The project identifies runtime anomalies such as tasks that never yield, self-waking tasks, or oversized futures. It analyzes task performance through polling and scheduling timing histograms and percentiles to locate bottlenecks or stalled operations.
The toolset covers resource monitoring by listing synchronization primitives and I/O resources to track their lifecycles. It enables resource contention debugging by identifying which asynchronous tasks are waiting on specific resources to resolve blocks.
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.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
