lxc-top (1) - Linux Manuals

lxc-top: monitor container statistics

NAME

lxc-top - monitor container statistics

SYNOPSIS

lxc-top [--help] [--max count] [--delay delay] [--sort sortby] [--reverse]

DESCRIPTION

lxc-top displays container statistics. The output is updated every delay seconds, and is ordered according to the sortby value given. Specifying count will limit the number of containers displayed, otherwise lxc-top will display as many containers as can fit in your terminal.

OPTIONS

[-m, --max count]

Limit the number of containers displayed to count.

[-d, --delay delay]

Amount of time in seconds to delay between screen updates. This can be specified as less than a second by giving a rational number, for example 0.5 for a half second delay. The default is 3 seconds.

[-s, --sort sortby]

Sort the containers by name, cpu use, or memory use. The sortby argument should be one of the letters n,c,d,m,k to sort by name, cpu use, disk I/O, memory, or kernel memory use respectively. The default is 'n'.

[-r, --reverse]

Reverse the default sort order. By default, names sort in ascending alphabetical order and values sort in descending amounts (ie. largest value first).

EXAMPLE

lxc-top --delay 1 --sort m

Display containers, updating every second, sorted by memory use.

NOTES

For performance reasons the kernel does not account kernel memory use unless a kernel memory limit is set. If a limit is not set, lxc-top will display kernel memory use as 0. If no containers are being accounted, the KMem column will not be displayed. A limit can be set by specifying

      lxc.cgroup.memory.kmem.limit_in_bytes = number
      

in your container configuration file, see lxc.conf(5).

AUTHOR

Dwight Engen <dwight.engen [at] oracle.com>