Top-like interface for container metrics
Go to file
Bradley Cicenas a87bdce0fe update keybindings in readme 2017-03-15 12:00:40 +10: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 add option for color inversion 2017-03-15 10:02:46 +10:00
logging lower logging, add keybindings to help menu 2017-03-07 11:09:46 +11:00
metrics add pids, IO stat 2017-03-12 02:35:40 +01:00
widgets add keymap, handle wrapper for common keybindings 2017-03-15 08:34:58 +10:00
.gitignore add pids, IO stat 2017-03-12 02:35:40 +01:00
Dockerfile v0.5 2017-03-15 10:08:26 +10:00
LICENSE add LICENSE 2017-03-09 10:41:32 +11:00
README.md update keybindings in readme 2017-03-15 12:00:40 +10:00
VERSION v0.5 2017-03-15 10:08:26 +10:00
circle.yml update circle config 2017-03-15 09:16:04 +10:00
colors.go add option for color inversion 2017-03-15 10:02:46 +10: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
glide.lock vendor dependencies with glide 2017-03-12 10:15:21 +07:00
glide.yaml vendor dependencies with glide 2017-03-12 10:15:21 +07:00
grid.go add keymap, handle wrapper for common keybindings 2017-03-15 08:34:58 +10:00
keys.go add keymap, handle wrapper for common keybindings 2017-03-15 08:34:58 +10:00
main.go remove redundant bool comparisons 2017-03-15 10:06:52 +10:00
menus.go add keymap, handle wrapper for common keybindings 2017-03-15 08:34:58 +10:00
mocksource.go remove sleep from mocksource container creation 2017-03-09 10:26:29 +11:00
sort.go add sort by pid count 2017-03-12 21:11:19 +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.5/ctop-0.5-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.5/ctop-0.5-darwin-amd64
sudo mv ctop /usr/local/bin/
sudo chmod +x /usr/local/bin/ctop

or run via Docker:

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

ctop is also available for Arch in the AUR

Building

To build ctop from source, ensure you have a recent version of glide installed and run:

git clone https://github.com/bcicen/ctop.git $GOPATH/src/github.com/bcicen/ctop && \
cd $GOPATH/src/github.com/bcicen/ctop && \
glide install && \
go build

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

Options

Option Description
-a show active containers only
-f 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
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
q Quit ctop