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

sudo apt-get install ca-certificates curl gnupg lsb-release
curl -fsSL https://azlux.fr/repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/azlux-archive-keyring.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/azlux-archive-keyring.gpg] http://packages.azlux.fr/debian \
  $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/azlux.list >/dev/null
sudo apt-get update
sudo apt-get install docker-ctop

Arch

sudo pacman -S ctop

ctop is also available for Arch in the AUR

Linux (Generic)

sudo wget https://github.com/bcicen/ctop/releases/download/v0.7.7/ctop-0.7.7-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/v0.7.7/ctop-0.7.7-darwin-amd64
sudo chmod +x /usr/local/bin/ctop

Windows

ctop is available in scoop:

scoop install 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.