Package: ctop
A command line / text based Linux Containers monitoring tool that works just like you expect.In a hurry?curl-sSlhttps://raw.githubusercontent.com/yadutaf/ctop/master/cgroup_top.py>/opt/ctop&&python/opt/ctopIntroductionctopwill help you see what’s going on at the container level. Basically,
containers are a logical group of processes isolated using kernel’s cgroups and
namespaces. Recently, they have been made popular by Docker and they are also
heavily used under the hood by systemd and a load of container tools like lxc,
rocket, lmctfy and many others.Under the hood, ctop will collect all metrics it can from cgroups in realtime
and render them to instantly give you an overview of the global system health.It currently collects metrics related to cpu, memory and block IO usage as well
as metadata such as owning user (mostly for systemd based containers), uptime
and attempts to guess the container managing technology behind.When the container technology has been successfully guessed, additional features
are exposed like attaching to container (basically, it opens a shell in the
container context) and stopping it.ctopauthor uses it on production system to quicky detect biggest memory
users in low memory situations.Featurescollect cpu, pids, memory and blkio metricscollect metadata like task count, owning user, container technologysort by any columnfilter by container type (docker, lxc, systemd, …)optionally display logical/tree viewoptionally fold/unfold sub cgroup treeoptionally follow selected cgroup/containeroptionnaly pause the refresh (typically, to select text)detects Docker, LXC, unprivileged LXC, OpenVZ and systemd based containerssupports advanced features for Docker, LXC and OpenVZ based containersopen a shell/attach to supported container types for further diagnosestop/kill/chekpointing supported container typesclick to sort / reverseclick to select cgroupno external dependencies beyond Python >= 2.6 or Python >= 3.0InstallationAs a monitoring tool,ctoptries to be as dicrete as possible. Nonetheless
it still has some expectations. It will need at least Python 2.6 with builtin
curses support to run. This is usually found with Debian 6 and newer.This said, the recommended installation method relies on pippipinstallctopctopIf using pip is not an option, which is often the case on production systems,
you may also directly grab the self-contained source file directly from github
and run it in place. All you’ll need is Python 2.6 (Debian Squeeze):wgethttps://raw.githubusercontent.com/yadutaf/ctop/master/cgroup_top.py-Octopchmod+xctop./ctopAlternatively, if you are a Boot2docker user, you may install a Dockerized
version of ctop instead. Please note that this is experimental. You have to
have a docker binary inside your container to control / attach to your
containers from ctop using this method:dockerpullyadutaf/ctopdockerrun--volume=/sys/fs/cgroup:/sys/fs/cgroup:ro--volume=/var/run/docker.sock:/var/run/docker.sock-it--rmyadutaf/ctop# Optionally, to resolve uids to usernames, add '--volume /etc/passwd:/etc/passwd:ro'Usage:Command line:Monitor local cgroups as used by Docker, LXC, SystemD, ...

Usage:
  ctop [--tree] [--refresh=<seconds>] [--columns=<columns>] [--sort-col=<sort-col>] [--follow=<name>] [--fold=<cgroup>, ...] [--type=<container type>, ...]
  ctop (-h | --help)

Options:
  --tree                 Show tree view by default.
  --fold=<name>          Start with <name> cgroup path folded
  --follow=<name>        Follow/highlight cgroup at path.
  --type=TYPE            Only show containers of this type
  --refresh=<seconds>    Refresh display every <seconds> [default: 1].
  --columns=<columns>    List of optional columns to display. Always includes 'name'. [default: owner,processes,memory,cpu-sys,cpu-user,blkio,cpu-time].
  --sort-col=<sort-col>  Select column to sort by initially. Can be changed dynamically. [default: cpu-user]
  -h --help              Show this screen.Control:presspto toggle/pause the refresh and select text.pressfto let selected line follow / stay on the same container. Default: Don’t follow.pressqorCtrl+Cto quit.pressF5to toggle tree/list view. Default: list view.press↑and↓to navigate between containers.press+or-to toggle child cgroup foldingclick on title line to select sort column / reverse sort order.click on any container line to select it.Additionally, for supported container types (Currently Docker, LXC and OpenVZ):pressato attach to console output.presseto open a shell in the container context. Aka ‘enter’ container.presssto stop the container (SIGTERM).presskto kill the container (SIGKILL).presscto checkpointing the container(OpenVZ only now - run ‘vzctl chkpnt CTID’)Requirementspython >=2.6 or python >=3.0, with builtin curses supportLicenceMIT