Top-like interface for container metrics
Go to file
Bradley Cicenas 617b1b2863 omit runc connector from darwin build 2017-06-14 10:11:40 -03:00
_docs Create connectors.md 2017-06-14 09:32:48 -03:00
config Toggle debug mode via env var 2017-03-19 15:10:03 +10:00
connector omit runc connector from darwin build 2017-06-14 10:11:40 -03:00
container move container sort to struct method 2017-06-12 10:40:52 -03:00
cwidgets add created meta field to expanded view 2017-06-10 10:46:54 -03:00
logging add option to log debug messages to unix or tcp socket 2017-05-31 10:45:48 -04:00
metrics refactor collectors into subpackage 2017-06-12 11:12:03 -03: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 update circleci to build image from source 2017-03-19 16:14:56 +10:00
Dockerfile_build include Makefile instructions for building image from source 2017-03-19 15:10:03 +10:00
LICENSE add LICENSE 2017-03-09 10:41:32 +11:00
Makefile add pidcount,io to mock collector 2017-06-13 17:25:58 -03:00
README.md add badges back 2017-06-14 09:30:03 -03:00
VERSION v0.6.0 2017-06-12 11:16:03 -03:00
circle.yml remove arbitrary branch deploy commands 2017-06-12 11:25:02 -03:00
colors.go add option for color inversion 2017-03-15 10:02:46 +10:00
cursor.go omit runc connector from darwin build 2017-06-14 10:11:40 -03:00
debug.go restructure container,connectors in subpackage 2017-06-08 11:51:02 -03:00
glide.lock update glide deps 2017-06-09 18:11:59 -03:00
glide.yaml update glide deps 2017-06-09 18:11:59 -03:00
grid.go disable timed display refresh while scrolling 2017-06-12 10:52:45 -03:00
keys.go include <escape> in exit keygroup 2017-06-08 09:47:30 -03:00
main.go omit runc connector from darwin build 2017-06-14 10:11:40 -03:00
menus.go restructure container,connectors in subpackage 2017-06-08 11:51:02 -03:00

README.md

ctop

release homebrew

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 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:

Linux

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

OS X

brew install ctop

or

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

Docker

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

ctop is also available for Arch in the AUR

Building

Build steps can be found here.

Usage

ctop requires no arguments and uses Docker host variables by default. See connectors for further configuration options.

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