• Stars
    star
    15,355
  • Rank 1,878 (Top 0.04 %)
  • Language
    Go
  • License
    MIT License
  • Created over 7 years ago
  • Updated 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Top-like interface for container metrics

ctop

release homebrew macports scoop

Top-like interface for container metrics

ctop provides a concise and condensed overview of real-time metrics for multiple containers:

ctop

as well as a 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:

Debian/Ubuntu

Maintained by a third party

sudo apt-get install ca-certificates curl gnupg lsb-release
curl -fsSL https://azlux.fr/repo.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/azlux-archive-keyring.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/azlux-archive-keyring.gpg] http://packages.azlux.fr/debian \
  $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/azlux.list >/dev/null
sudo apt-get update
sudo apt-get install docker-ctop

Arch

sudo pacman -S ctop

ctop is also available for Arch in the AUR

Linux (Generic)

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

OS X

brew install ctop

or

sudo port install ctop

or

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

Windows

ctop is available in scoop:

scoop install ctop

Docker

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

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 (~/.config/ctop/config on XDG systems, else ~/.ctop).

Config file values 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
-v output version information and exit

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
c Configure columns
S Save current configuration to file
q Quit ctop

Alternatives

See Awesome Docker list for similar tools to work with Docker.

More Repositories

1

grmon

Command line monitoring for goroutines
Go
1,897
star
2

slackcat

CLI utility to post files and command output to slack
Go
1,218
star
3

jstream

Streaming JSON parser for Go
Go
561
star
4

wikitables

Import tables from any Wikipedia article as a dataset in Python
Python
290
star
5

docker-replay

Generate docker commands to rerun existing containers
Python
197
star
6

go-haproxy

Go library for interacting with HAProxy via command socket
Go
124
star
7

slack-progress

A realtime progress bar for Slack
Python
99
star
8

vim-vice

Dark and vibrant colorscheme for vim
Vim Script
95
star
9

tinycron

A very small replacement for cron
Go
84
star
10

go-units

Go library for converting between various units of measurement
Go
81
star
11

tcolors

Commandline color picker and palette builder
Go
51
star
12

xiny

Simple command line tool for unit conversions
Go
42
star
13

statsquid

🐳 Multi-host container stat aggregator and shipper for Docker
Python
36
star
14

haproxy-stats

haproxy-stats is a small Python library for fetching and parsing stats
Python
30
star
15

termui

Golang terminal dashboard (fork of gizak/termui)
Go
16
star
16

vim-jfmt

Automatically pretty-print and indent JSON files
Vim Script
13
star
17

vimcommands

Website for vimcommands.com
HTML
11
star
18

devpi-tools

Small Python library for interacting with devpi servers via web API
Python
10
star
19

somacli

🎡 Commandline SomaFM internet radio player
Shell
9
star
20

acrophone

Easily convert text to phonetic spelling
Go
8
star
21

cliglobe

A simple spinning commandline globe with gradient colors
Go
6
star
22

dsplice

Docker image merge tool
Python
6
star
23

bfstree

Go package providing breadth-first search functions for arbitrary structs
Go
5
star
24

docker-port-scan

Docker image build providing regular port scan reports via a web interface
Shell
5
star
25

color

Color package for Go
Go
5
star
26

uptime

Uptime is a concurrent, distributed URL checker
Python
4
star
27

slackn

Batch Nagios notifications for Slack
Python
3
star
28

haproxy-top

CLI tool for viewing real-time HAProxy metrics across multiple instances
Python
3
star
29

etcd-discovery

Simple container for running your own local etcd discovery service like https://discovery.etcd.io
Shell
3
star
30

dddnsupdate

dddnsupdate is a small CLI utility to dynamically nsupdate a bind server with discovered docker names and IPs
Python
2
star
31

tagshell

Execute ssh commands to multiple hosts in parallel based on arbitary tags
Python
2
star
32

tzdata

Embedded timezone database for Go
Go
2
star
33

dockertop

A top-like monitor for Docker containers written in Python
Python
2
star
34

multicrane

Multicrane - Superbly simple multi-host Docker orchestration via Crane
Python
2
star
35

haproxyview

Simple web interface for aggregating and displaying HAproxy servers and stats.
HTML
1
star
36

redis-scraper

Dump all lists in redis to flat files
Python
1
star
37

gem2deb

docker container to fetch a gem and build it as a deb package.
Shell
1
star
38

safertar

A safer way to extract tar archives using fakeroot and chroot
Shell
1
star
39

dockerfile-npm-lazy

npm_lazy caching npm registry layer in docker container
JavaScript
1
star
40

py2deb

Docker image to build a deb from Python package
Shell
1
star