bcicen/ctop
Top-like interface for container metrics
repo name | bcicen/ctop |
repo link | https://github.com/bcicen/ctop |
homepage | https://ctop.sh |
language | Go |
size (curr.) | 3265 kB |
stars (curr.) | 9531 |
created | 2016-12-27 |
license | MIT License |
Top-like interface for container metrics
ctop
provides a concise and condensed overview of real-time metrics for multiple containers:
as well as an single container 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.7.3/ctop-0.7.3-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.7.3/ctop-0.7.3-darwin-amd64
sudo chmod +x /usr/local/bin/ctop
Docker
docker run --rm -ti \
--name=ctop \
--volume /var/run/docker.sock:/var/run/docker.sock:ro \
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.
Config file
While running, use S
to save the current filters, sort field, and other options to a default config path. These settings will be loaded and applied the next time ctop
is started.
Options
Option | Description |
---|---|
-a |
show active containers only |
-f <string> |
set an initial filter string |
-h |
display help dialog |
-i |
invert default colors |
-r |
reverse container sort order |
-s |
select initial container sort field |
-scale-cpu |
show cpu as % of system total |
-v |
output version information and exit |
-shell |
specify shell (default: sh) |
Keybindings
Key | Action |
---|---|
<enter> |
Open container menu |
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 |
o |
Open single view |
l |
View container logs (t to toggle timestamp when open) |
e |
Exec Shell |
S |
Save current configuration to file |
q |
Quit ctop |