ctop

Top-like interface for container metrics

Programming language: Go

License: MIT License

Tags: Utilities    

Latest version: v0.7.5

README

Top-like interface for container metrics

ctop provides a concise and condensed overview of real-time metrics for multiple containers:

as well as a [single container view][single_view] for inspecting a specific container.

ctop comes with built-in support for Docker and runC; connectors for other container and cluster systems are planned for future releases.

Install

Fetch the latest release for your platform:

Debian/Ubuntu

Maintained by a third party

echo "deb http://packages.azlux.fr/debian/ buster main" | sudo tee /etc/apt/sources.list.d/azlux.list
wget -qO - https://azlux.fr/repo.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install docker-ctop

Arch

ctop is available for Arch in the AUR

Linux (Generic)

sudo wget https://github.com/bcicen/ctop/releases/download/0.7.6/ctop-0.7.6-linux-amd64 -O /usr/local/bin/ctop
sudo chmod +x /usr/local/bin/ctop

OS X

brew install ctop

or

sudo port install ctop

or

sudo curl -Lo /usr/local/bin/ctop https://github.com/bcicen/ctop/releases/download/0.7.6/ctop-0.7.6-darwin-amd64
sudo chmod +x /usr/local/bin/ctop

Docker

docker run --rm -ti \
  --name=ctop \
  --volume /var/run/docker.sock:/var/run/docker.sock:ro \
  quay.io/vektorlab/ctop:latest

Building

Build steps can be found [here][build].

Usage

ctop requires no arguments and uses Docker host variables by default. See [connectors][connectors] for further configuration options.

Config file

While running, use S to save the current filters, sort field, and other options to a default config path (~/.config/ctop/config on XDG systems, else ~/.ctop).

Config file values will be loaded and applied the next time ctop is started.

Options

Option	Description
-a	show active containers only
-f <string>	set an initial filter string
-h	display help dialog
-i	invert default colors
-r	reverse container sort order
-s	select initial container sort field
-v	output version information and exit

Keybindings

Key	Action
<ENTER>	Open container menu
a	Toggle display of all (running and non-running) containers
f	Filter displayed containers (esc to clear when open)
H	Toggle ctop header
h	Open help dialog
s	Select container sort field
r	Reverse container sort order
o	Open single view
l	View container logs (t to toggle timestamp when open)
e	Exec Shell
c	Configure columns
S	Save current configuration to file
q	Quit ctop

Alternatives

See Awesome Docker list for similar tools to work with Docker.