Top-like interface for container metrics
Go to file
Bradley Cicenas 3ca94b50cd add LICENSE 2017-03-09 10:41:32 +11:00
_docs use consistent case for ctop name 2017-03-09 10:40:35 +11:00
config use consistent case for ctop name 2017-03-09 10:40:35 +11:00
cwidgets fix panic on row removal 2017-03-08 22:19:43 +11: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 use consistent case for ctop name 2017-03-09 10:40:35 +11:00
LICENSE add LICENSE 2017-03-09 10:41:32 +11:00
README.md use consistent case for ctop name 2017-03-09 10:40:35 +11:00
VERSION v0.4 2017-03-08 22:20:30 +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 filter Containers in place 2017-03-08 11:26:22 +11:00
grid.go add pagination support for compact view 2017-03-08 18:45:31 +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
sort.go filter Containers in place 2017-03-08 11:26:22 +11:00

README.md

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

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