Skip to content
/ ctop Public
forked from bcicen/ctop

Top-like interface for container metrics

License

Notifications You must be signed in to change notification settings

neo4reo/ctop

 
 

Repository files navigation

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

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

About

Top-like interface for container metrics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 100.0%