Skip to content

Commit c25822c

Browse files
Fan Yuakpm00
Fan Yu
authored and
akpm00
committed
docs: update delaytop documentation for new interactive features
This commit updates the delaytop documentation to reflect the newly added features: 1) Added comprehensive description of interactive keyboard controls 2) Documented all available sort fields 3) Added examples for advanced usage scenarios 4) Included PSI availability note Link: https://lkml.kernel.org/r/20250907001457696qAqUGGkV1VfEO6OkVMovW@zte.com.cn Signed-off-by: Fan Yu <fan.yu9@zte.com.cn> Reviewed-by: xu xin <xu.xin16@zte.com.cn> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
1 parent 0c10f9c commit c25822c

1 file changed

Lines changed: 58 additions & 33 deletions

File tree

‎Documentation/accounting/delay-accounting.rst‎

Lines changed: 58 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -134,47 +134,72 @@ The above command can be used with -v to get more debug information.
134134

135135
After the system starts, use `delaytop` to get the system-wide delay information,
136136
which includes system-wide PSI information and Top-N high-latency tasks.
137+
Note: PSI support requires `CONFIG_PSI=y` and `psi=1` for full functionality.
137138

138-
`delaytop` supports sorting by CPU latency in descending order by default,
139-
displays the top 20 high-latency tasks by default, and refreshes the latency
140-
data every 2 seconds by default.
139+
`delaytop` is an interactive tool for monitoring system pressure and task delays.
140+
It supports multiple sorting options, display modes, and real-time keyboard controls.
141141

142-
Get PSI information and Top-N tasks delay, since system boot::
142+
Basic usage with default settings (sorts by CPU delay, shows top 20 tasks, refreshes every 2 seconds)::
143143

144144
bash# ./delaytop
145-
System Pressure Information: (avg10/avg60/avg300/total)
146-
CPU some: 0.0%/ 0.0%/ 0.0%/ 345(ms)
145+
System Pressure Information: (avg10/avg60vg300/total)
146+
CPU some: 0.0%/ 0.0%/ 0.0%/ 106137(ms)
147147
CPU full: 0.0%/ 0.0%/ 0.0%/ 0(ms)
148148
Memory full: 0.0%/ 0.0%/ 0.0%/ 0(ms)
149149
Memory some: 0.0%/ 0.0%/ 0.0%/ 0(ms)
150-
IO full: 0.0%/ 0.0%/ 0.0%/ 65(ms)
151-
IO some: 0.0%/ 0.0%/ 0.0%/ 79(ms)
150+
IO full: 0.0%/ 0.0%/ 0.0%/ 2240(ms)
151+
IO some: 0.0%/ 0.0%/ 0.0%/ 2783(ms)
152152
IRQ full: 0.0%/ 0.0%/ 0.0%/ 0(ms)
153-
Top 20 processes (sorted by CPU delay):
154-
PID TGID COMMAND CPU(ms) IO(ms) SWAP(ms) RCL(ms) THR(ms) CMP(ms) WP(ms) IRQ(ms)
155-
----------------------------------------------------------------------------------------------
156-
161 161 zombie_memcg_re 1.40 0.00 0.00 0.00 0.00 0.00 0.00 0.00
157-
130 130 blkcg_punt_bio 1.37 0.00 0.00 0.00 0.00 0.00 0.00 0.00
158-
444 444 scsi_tmf_0 0.73 0.00 0.00 0.00 0.00 0.00 0.00 0.00
159-
1280 1280 rsyslogd 0.53 0.04 0.00 0.00 0.00 0.00 0.00 0.00
160-
12 12 ksoftirqd/0 0.47 0.00 0.00 0.00 0.00 0.00 0.00 0.00
161-
1277 1277 nbd-server 0.44 0.00 0.00 0.00 0.00 0.00 0.00 0.00
162-
308 308 kworker/2:2-sys 0.41 0.00 0.00 0.00 0.00 0.00 0.00 0.00
163-
55 55 netns 0.36 0.00 0.00 0.00 0.00 0.00 0.00 0.00
164-
1187 1187 acpid 0.31 0.03 0.00 0.00 0.00 0.00 0.00 0.00
165-
6184 6184 kworker/1:2-sys 0.24 0.00 0.00 0.00 0.00 0.00 0.00 0.00
166-
186 186 kaluad 0.24 0.00 0.00 0.00 0.00 0.00 0.00 0.00
167-
18 18 ksoftirqd/1 0.24 0.00 0.00 0.00 0.00 0.00 0.00 0.00
168-
185 185 kmpath_rdacd 0.23 0.00 0.00 0.00 0.00 0.00 0.00 0.00
169-
190 190 kstrp 0.23 0.00 0.00 0.00 0.00 0.00 0.00 0.00
170-
2759 2759 agetty 0.20 0.03 0.00 0.00 0.00 0.00 0.00 0.00
171-
1190 1190 kworker/0:3-sys 0.19 0.00 0.00 0.00 0.00 0.00 0.00 0.00
172-
1272 1272 sshd 0.15 0.04 0.00 0.00 0.00 0.00 0.00 0.00
173-
1156 1156 license 0.15 0.11 0.00 0.00 0.00 0.00 0.00 0.00
174-
134 134 md 0.13 0.00 0.00 0.00 0.00 0.00 0.00 0.00
175-
6142 6142 kworker/3:2-xfs 0.13 0.00 0.00 0.00 0.00 0.00 0.00 0.00
176-
177-
Dynamic interactive interface of delaytop::
153+
[o]sort [M]memverbose [q]quit
154+
Top 20 processes (sorted by cpu delay):
155+
PID TGID COMMAND CPU(ms) IO(ms) IRQ(ms) MEM(ms)
156+
------------------------------------------------------------------------
157+
110 110 kworker/15:0H-s 27.91 0.00 0.00 0.00
158+
57 57 cpuhp/7 3.18 0.00 0.00 0.00
159+
99 99 cpuhp/14 2.97 0.00 0.00 0.00
160+
51 51 cpuhp/6 0.90 0.00 0.00 0.00
161+
44 44 kworker/4:0H-sy 0.80 0.00 0.00 0.00
162+
60 60 ksoftirqd/7 0.74 0.00 0.00 0.00
163+
76 76 idle_inject/10 0.31 0.00 0.00 0.00
164+
100 100 idle_inject/14 0.30 0.00 0.00 0.00
165+
1309 1309 systemsettings 0.29 0.00 0.00 0.00
166+
45 45 cpuhp/5 0.22 0.00 0.00 0.00
167+
63 63 cpuhp/8 0.20 0.00 0.00 0.00
168+
87 87 cpuhp/12 0.18 0.00 0.00 0.00
169+
93 93 cpuhp/13 0.17 0.00 0.00 0.00
170+
1265 1265 acpid 0.17 0.00 0.00 0.00
171+
1552 1552 sshd 0.17 0.00 0.00 0.00
172+
2584 2584 sddm-helper 0.16 0.00 0.00 0.00
173+
1284 1284 rtkit-daemon 0.15 0.00 0.00 0.00
174+
1326 1326 nde-netfilter 0.14 0.00 0.00 0.00
175+
27 27 cpuhp/2 0.13 0.00 0.00 0.00
176+
631 631 kworker/11:2-rc 0.11 0.00 0.00 0.00
177+
178+
Interactive keyboard controls during runtime::
179+
180+
o - Select sort field (CPU, IO, IRQ, Memory, etc.)
181+
M - Toggle display mode (Default/Memory Verbose)
182+
q - Quit
183+
184+
Available sort fields(use -s/--sort or interactive command)::
185+
186+
cpu(c) - CPU delay
187+
blkio(i) - I/O delay
188+
irq(q) - IRQ delay
189+
mem(m) - Total memory delay
190+
swapin(s) - Swapin delay (memory verbose mode only)
191+
freepages(r) - Freepages reclaim delay (memory verbose mode only)
192+
thrashing(t) - Thrashing delay (memory verbose mode only)
193+
compact(p) - Compaction delay (memory verbose mode only)
194+
wpcopy(w) - Write page copy delay (memory verbose mode only)
195+
196+
Advanced usage examples::
197+
198+
# ./delaytop -s blkio
199+
Sorted by IO delay
200+
201+
# ./delaytop -s mem -M
202+
Sorted by memory delay in memory verbose mode
178203

179204
# ./delaytop -p pid
180205
Print delayacct stats

0 commit comments

Comments
 (0)