Scroll to navigation

lxc-top(1) lxc-top(1)

NAME

lxc-top - monitor container statistics

SYNOPSIS


lxc-top
[--help] [--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. lxc-top will display as many containers as can fit in your terminal. Press 'q' to quit. Press one of the sort key letters to sort by that statistic. Pressing a sort key letter a second time reverses the sort order.

OPTIONS

Amount of time in seconds to delay between screen updates. The default is 3 seconds.
Sort the containers by name, cpu use, or memory use. The sortby argument should be one of the letters n,c,b,m,k to sort by name, cpu use, block I/O, memory, or kernel memory use respectively. The default is 'n'.
Reverse the default sort order. By default, names sort in ascending alphabetical order and values sort in descending amounts (ie. largest value first).

EXAMPLE

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).

SEE ALSO

lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-execute(1), lxc-console(1), lxc-monitor(1), lxc-wait(1), lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1), lxc-attach(1), lxc.conf(5)

2024-09-19