Top-like interface for container metrics
Go to file
Bradley Cicenas b28beed3ee v0.4.1 2017-03-10 20:20:00 +11:00
_docs trim grid screencap 2017-03-09 12:22:37 +11:00
config add support for TLS via NewClientFromEnv(), remove dockerHost config param 2017-03-10 12:01:13 +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
Dockerfile use latest parsed version in dockerfile 2017-03-10 19:51:31 +11:00
LICENSE add LICENSE 2017-03-09 10:41:32 +11:00
README.md v0.4.1 2017-03-10 20:20:00 +11:00
VERSION v0.4.1 2017-03-10 20:20:00 +11:00
circle.yml add circleci config for docker build 2017-03-10 19:45:04 +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 fixes out of bounds error on filtered selection #7 2017-03-10 12:01:13 +11:00
debug.go add WidgetUpdater interface to container, replace struct fields with metamap 2017-03-06 19:25:59 +11:00
dockersource.go add lock to container map in dockersource 2017-03-10 20:10:39 +11:00
grid.go fixes out of bounds error on filtered selection #7 2017-03-10 12:01:13 +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.1/ctop-0.4.1-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.1/ctop-0.4.1-darwin-amd64
sudo mv ctop /usr/local/bin/
sudo chmod +x /usr/local/bin/ctop

or run via Docker:

docker run -ti -v /var/run/docker.sock:/var/run/docker.sock quay.io/vektorlab/ctop:latest

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