NAME
systemd-cgtop - Show top control groups by their resource usage
SYNOPSIS
systemd-cgtop [OPTIONS...] [GROUP]
DESCRIPTION
systemd-cgtop shows the top control groups of the local Linux control group hierarchy, ordered by their CPU, memory, or disk I/O load. The display is refreshed in regular intervals (by default every 1s), similar in style to top(1). If a control group path is specified, shows only the services of the specified control group.
If systemd-cgtop is not connected to a tty, no column headers are printed and the default is to only run one iteration. The --iterations= argument, if given, is honored. This mode is suitable for scripting.
Resource usage is only accounted for control groups with the appropriate controllers turned on: "cpu" controller for CPU usage, "memory" controller for memory usage, and "io" controller for disk I/O consumption. If resource monitoring for these resources is required, it is recommended to add the CPUAccounting=1, MemoryAccounting=1 and IOAccounting=1 settings in the unit files in question. See systemd.resource-control(5) for details.
The CPU load value can be between 0 and 100 times the number of processors the system has. For example, if the system has 8 processors, the CPU load value is going to be between 0% and 800%. The number of processors can be found in "/proc/cpuinfo".
To emphasize: unless "CPUAccounting=1", "MemoryAccounting=1", and "IOAccounting=1" are enabled for the services in question, no resource accounting will be available for system services and the data shown by systemd-cgtop will be incomplete.
OPTIONS
The following options are understood:
-p, --order=path
-t, --order=tasks
-c, --order=cpu
-m, --order=memory
-i, --order=io
-b, --batch
Added in version 188.
-r, --raw
Added in version 221.
--cpu=percentage, --cpu=time
Added in version 226.
-P
Added in version 227.
-k
Added in version 226.
--recursive=
Added in version 226.
-n, --iterations=
Added in version 188.
-1
Added in version 238.
-d, --delay=
--depth=
-MMACHINE, --machine=MACHINE
Added in version 227.
-h, --help
--version
KEYS
systemd-cgtop is an interactive tool and may be controlled via user input using the following keys:
h
Space
Added in version 226.
q
p, t, c, m, i
%
Added in version 201.
+, -
P
Added in version 227.
k
Added in version 226.
r
Added in version 226.
EXIT STATUS
On success, 0 is returned, a non-zero failure code otherwise.
SEE ALSO
systemd(1), systemctl(1), systemd-cgls(1), systemd.resource-control(5), top(1)