mirror of https://github.com/bcicen/ctop.git
2.2 KiB
2.2 KiB
Top-like interface for container metrics
ctop provides a concise and condensed overview of real-time metrics for multiple containers:
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
sudo wget https://github.com/bcicen/ctop/releases/download/v0.5/ctop-0.5-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.5/ctop-0.5-darwin-amd64
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
Build steps can be found here.
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 |