docker-stats 0.3.0

Visualize container stats with beautiful, real-time charts directly in your terminal.
Documentation

📊 ds - A Terminal-Based Docker Stats Viewer

Visualize container metrics with real-time charts directly in your terminal.

[!WARNING] ds is now stable and no longer under active development. It is feature-complete and should function as expected. If you encounter any issues, please open an issue, and pull requests are welcome.

Overview

ds provides real-time monitoring of Docker container statistics, rendering them as charts in the terminal. It serves as a visual alternative to the standard docker stats command, making it easier to analyze resource utilization at a glance.

This project was inspired by the need for a visual statistics tool similar to Docker Desktop's, especially when using lighter container management solutions like OrbStack.

Features

  • Real-Time charting: Visualize CPU, memory, network, and I/O usage with dynamic charts.
  • Customizable Views: Choose between compact and full layouts to control the level of detail.
  • Container Filtering: Display statistics for all containers or specify a subset by name or ID.
  • Rust-Powered: Built with Rust for performance and reliability.

Installation

[!NOTE] ds is available on crates.io as docker-stats.

From crates.io

cargo install docker-stats

From Source

Ensure you have Rust and Cargo installed.

  1. Clone the repository:

    git clone https://github.com/rafaelrcamargo/ds
cd ds

  2. Build and install the binary:

    cargo install --path .

  3. Run the application:

    ds

Usage

The default command displays statistics for all running containers:

ds

To view all available options, run:

ds --help

Examples

Compact View

For a minimal overview of all containers, use the compact flag:

ds -c

Detailed View for Specific Containers

To monitor specific containers with full details, including network and I/O charts, provide their names or IDs:

ds -f 5f03524a8fbe api-1

Known Issues

Slow Startup Time

ds may experience a startup delay while it establishes a connection to the Docker daemon and begins receiving statistics. This behavior is inherent to how docker stats operates and is consistent with the performance of both OrbStack and Docker Desktop.

Network Chart Limitations

The network chart does not display data for containers running in network_mode: host. Metrics will only be populated for containers using the bridge network. This is a known limitation related to how Docker exposes network statistics.

For more context on network_mode: host on macOS, see the discussion in the Docker roadmap.

Contributing

Contributions are welcome! If you have suggestions or find a bug, please open an issue or submit a pull request.

License

This project is licensed under the Apache License 2.0.