ctop README

The project's README from github.com/bcicen/ctop. As one markdown file: README.md.

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.

ctop (bcicen/ctop)

Searching Database…

17.8K ·GitHub
Ctop
Что это такое?ctop — это инструмент для терминала, который в реальном времени показывает обзор метрик всех запущенных контейнеров в стиле top, а также подробный вид одного контейнера.
Это приложение с графическим интерфейсом или инструмент для терминала?Это приложение с текстовым интерфейсом (TUI), которое запускается из командной строки, а не программа с графическим интерфейсом (GUI).
Как установить и запустить?Скачайте готовый бинарный файл для вашей платформы (Debian/Ubuntu, Arch AUR, обычный Linux, macOS через Homebrew/MacPorts, Windows через scoop или Docker), затем просто запустите ctop без аргументов.
Нужно ли установить Docker, чтобы это работало?Да, ctop по умолчанию подключается к вашему хосту Docker и имеет встроенную поддержку Docker и runC.
Поддерживает ли он другие системы контейнеров, кроме Docker и runC?Пока нет — подключение к другим системам контейнеров и кластеров запланировано только для будущих релизов.
Какие платформы поддерживаются?Бинарные файлы и пакеты доступны для Linux (Debian/Ubuntu, Arch, обычный), macOS (Homebrew/MacPorts) и Windows (scoop), а также есть образ Docker.
Как настроить вид ctop?Нажмите «S» во время работы, чтобы сохранить текущие фильтры, поле сортировки и другие параметры отображения в файл конфигурации (~/.config/ctop/config в системах с XDG, иначе ~/.ctop). Он загрузится снова при следующем запуске.
Можно ли фильтровать или сортировать список контейнеров?Да, нажмите «f», чтобы отфильтровать отображаемые контейнеры, и «s», чтобы выбрать поле сортировки, а «r» — чтобы изменить порядок на обратный. Флаги командной строки -f и -s задают эти параметры и при запуске.
Можно ли работать с контейнером напрямую из ctop?Да: клавиша Enter открывает меню контейнера, «l» показывает логи (с переключением отображения временных меток), а «e» позволяет выполнить оболочку внутри контейнера.
Есть ли вид одного контейнера с подробной информацией?Да, нажатие «o» открывает вид одного контейнера для подробного просмотра метрик конкретного контейнера.
What are similar projects?k9s, telegraf, sampler, witr, bottom, glances, lazydocker, nodelume
Which topics is it in?commandline, system-monitor, infrastructure, containers, tui, sysadmin, observability, golang, dashboard, monitoring, command-line, devops
Creator
bcicen
Size
3.5 MB
Stars
17.8K
Updated
CommitAug 01Releasev0.7.7Mar 22
Age
9y
Commits · 90 Days