Go to file
2017-03-10 11:55:49 +11:00
_docs trim grid screencap 2017-03-09 12:22:37 +11:00
config use consistent case for ctop name 2017-03-09 10:40:35 +11:00
cwidgets Fixing a typo 2017-03-09 16:16:40 -08:00
logging lower logging, add keybindings to help menu 2017-03-07 11:09:46 +11:00
metrics remove sleep from mocksource container creation 2017-03-09 10:26:29 +11:00
widgets implement Buffer() method for ctop header 2017-03-09 19:33:25 +11:00
colors.go add global default ColorMap 2017-03-08 10:40:03 +11:00
container.go filter Containers in place 2017-03-08 11:26:22 +11:00
cursor.go add pagination support for compact view 2017-03-08 18:45:31 +11:00
debug.go add WidgetUpdater interface to container, replace struct fields with metamap 2017-03-06 19:25:59 +11:00
dockersource.go ensure Loop() is started before feeding refresh chan 2017-03-09 18:39:11 +11:00
grid.go implement Buffer() method for ctop header 2017-03-09 19:33:25 +11:00
LICENSE add LICENSE 2017-03-09 10:41:32 +11:00
main.go use consistent case for ctop name 2017-03-09 10:40:35 +11:00
menus.go use consistent case for ctop name 2017-03-09 10:40:35 +11:00
mocksource.go remove sleep from mocksource container creation 2017-03-09 10:26:29 +11:00
README.md add AUR to README 2017-03-10 09:24:44 +11:00
sort.go filter Containers in place 2017-03-08 11:26:22 +11:00
VERSION v0.4 2017-03-08 22:20:30 +11:00

ctop

#

Top-like interface for container metrics

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

ctop

as well as an expanded view for inspecting a specific container.

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

Install

Fetch the latest release for your platform:

Linux

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

OS X

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

ctop is also available for Arch in the AUR

Usage

ctop requires no arguments and will configure itself using the DOCKER_HOST environment variable

export DOCKER_HOST=tcp://127.0.0.1:4243
ctop

Keybindings

Key Action
a Toggle display of all (running and non-running) containers
f Filter displayed containers
H Toggle ctop header
h Open help dialog
s Select container sort field
r Reverse container sort order
q Quit ctop