ctop – Top-like Interface for Monitoring Docker Containers

If you are managing multiple Docker containers, it can be challenging to keep track of their resource utilization, network connectivity, and overall health. ctop is a command-line monitoring tool that provides a top-like interface for monitoring Docker containers in real-time. It displays an intuitive visual representation of container metrics, including CPU, memory, network, and disk usage.

What is ctop?

ctop is a command-line tool that provides a top-like interface for monitoring Docker containers. It displays an overview of all running containers with real-time CPU and memory usage, container name, image, and ID. The tool allows you to sort and filter containers based on different criteria such as CPU usage or container name, making container management more efficient.

Installing ctop

ctop is an open-source tool available for Linux, macOS, and Windows. You can download the latest version from the GitHub repository.

Installation Steps for Linux

# Download the ctop binary
$ wget https://github.com/bcicen/ctop/releases/download/v0.7.6/ctop-0.7.6-linux-amd64 -O ctop

# Make the binary executable
$ chmod +x ctop

# Move to system PATH
$ sudo mv ctop /usr/local/bin/

# Verify installation
$ ctop -v

Using ctop

When you start ctop, you'll see a live view of your Docker containers with their resource utilization metrics. The interface updates in real-time and provides sorting capabilities.

Basic Usage

$ ctop

This displays a live view of Docker containers, sorted by CPU usage by default. Use arrow keys to navigate between containers.

Sorting Options

Press the corresponding shortcut keys to sort containers by different metrics

• c Sort by CPU usage (default)

• m Sort by memory usage

• n Sort by network traffic

• i Sort by container ID

• s Sort by container status

• p Sort by container PIDs

Filtering Containers

You can filter containers based on name or labels

# Filter by container name
$ ctop -f name=web

# Filter by label
$ ctop -f label=com.example.app=frontend

Viewing Container Details

To view detailed information about a specific container, highlight it using arrow keys and press Enter. The detailed view shows

Container ID: 28c54bfc07f4
Image: alpine:latest
Command: /bin/sh -c sleep 3600
Status: running for 2 hours
Created: 1 day ago
IP: 172.17.0.3
Networks: bridge

CPU:
  Usage: 0.0%
  System: 33s
  User: 1m50s

Memory:
  Usage: 66.26MiB / 3.697GiB
  Percentage: 1.76%

Network:
  Input: 14.57kB
  Output: 2.03kB

Block IO:
  Input: 6.97MB
  Output: 16.4MB

Processes:
  Running: 1
  Total: 1

Press Esc to return to the main interface.

Customizing ctop

ctop provides several customization options to enhance your monitoring experience

• Filtering containers Press f and enter filter criteria to narrow down the container list

• Color schemes Press t to switch between different color themes

• Resource limits Press l to set CPU, memory, and block I/O limits

• Help menu Press ? to view all available keybindings and options

Key Features

Conclusion

ctop is a powerful and intuitive tool for real-time Docker container monitoring. Its top-like interface makes it easy to identify resource-heavy containers, troubleshoot issues, and optimize container performance. With features like sorting, filtering, and detailed container views, ctop is an essential tool for effective Docker container management.