Skip to content

Commit 5dce590

Browse files
Daniel Bristot de Oliveirarostedt
Daniel Bristot de Oliveira
authored and
rostedt
committed
rtla: Add rtla timerlat hist documentation
Man page for rtla timerlat hist mode. Link: https://lkml.kernel.org/r/4a184003fdb81e23be3fe5ec882b1c89d5a95458.1639158831.git.bristot@kernel.org Cc: Tao Zhou <tao.zhou@linux.dev> Cc: Ingo Molnar <mingo@redhat.com> Cc: Tom Zanussi <zanussi@kernel.org> Cc: Masami Hiramatsu <mhiramat@kernel.org> Cc: Juri Lelli <juri.lelli@redhat.com> Cc: Clark Williams <williams@redhat.com> Cc: John Kacur <jkacur@redhat.com> Cc: Peter Zijlstra <peterz@infradead.org> Cc: Thomas Gleixner <tglx@linutronix.de> Cc: Sebastian Andrzej Siewior <bigeasy@linutronix.de> Cc: Daniel Bristot de Oliveira <bristot@kernel.org> Cc: linux-rt-users@vger.kernel.org Cc: linux-trace-devel@vger.kernel.org Cc: linux-kernel@vger.kernel.org Signed-off-by: Daniel Bristot de Oliveira <bristot@kernel.org> Signed-off-by: Steven Rostedt <rostedt@goodmis.org>
1 parent df337d0 commit 5dce590

File tree

1 file changed

+106
-0
lines changed

1 file changed

+106
-0
lines changed

‎Documentation/tools/rtla/rtla-timerlat-hist.rst

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
=====================
2+
rtla-timerlat-hist
3+
=====================
4+
------------------------------------------------
5+
Histograms of the operating system timer latency
6+
------------------------------------------------
7+
8+
:Manual section: 1
9+
10+
SYNOPSIS
11+
========
12+
**rtla timerlat hist** [*OPTIONS*] ...
13+
14+
DESCRIPTION
15+
===========
16+
17+
.. include:: common_timerlat_description.rst
18+
19+
The **rtla timerlat hist** displays a histogram of each tracer event
20+
occurrence. This tool uses the periodic information, and the
21+
**osnoise:** tracepoints are enabled when using the **-T** option.
22+
23+
OPTIONS
24+
=======
25+
26+
.. include:: common_timerlat_options.rst
27+
28+
.. include:: common_hist_options.rst
29+
30+
.. include:: common_options.rst
31+
32+
EXAMPLE
33+
=======
34+
In the example below, **rtla timerlat hist** is set to run for *10* minutes,
35+
in the cpus *0-4*, *skipping zero* only lines. Moreover, **rtla timerlat
36+
hist** will change the priority of the *timelat* threads to run under
37+
*SCHED_DEADLINE* priority, with a *10us* runtime every *1ms* period. The
38+
*1ms* period is also passed to the *timerlat* tracer::
39+
40+
[root@alien ~]# timerlat hist -d 10m -c 0-4 -P d:100us:1ms -p 1ms
41+
# RTLA timerlat histogram
42+
# Time unit is microseconds (us)
43+
# Duration: 0 00:10:00
44+
Index IRQ-000 Thr-000 IRQ-001 Thr-001 IRQ-002 Thr-002 IRQ-003 Thr-003 IRQ-004 Thr-004
45+
0 276489 0 206089 0 466018 0 481102 0 205546 0
46+
1 318327 35487 388149 30024 94531 48382 83082 71078 388026 55730
47+
2 3282 122584 4019 126527 28231 109012 23311 89309 4568 98739
48+
3 940 11815 837 9863 6209 16227 6895 17196 910 9780
49+
4 444 17287 424 11574 2097 38443 2169 36736 462 13476
50+
5 206 43291 255 25581 1223 101908 1304 101137 236 28913
51+
6 132 101501 96 64584 635 213774 757 215471 99 73453
52+
7 74 169347 65 124758 350 57466 441 53639 69 148573
53+
8 53 85183 31 156751 229 9052 306 9026 39 139907
54+
9 22 10387 12 42762 161 2554 225 2689 19 26192
55+
10 13 1898 8 5770 114 1247 128 1405 13 3772
56+
11 9 560 9 924 71 686 76 765 8 713
57+
12 4 256 2 360 50 411 64 474 3 278
58+
13 2 167 2 172 43 256 53 350 4 180
59+
14 1 88 1 116 15 198 42 223 0 115
60+
15 2 63 3 94 11 139 20 150 0 58
61+
16 2 37 0 56 5 78 10 102 0 39
62+
17 0 18 0 28 4 57 8 80 0 15
63+
18 0 8 0 17 2 50 6 56 0 12
64+
19 0 9 0 5 0 19 0 48 0 18
65+
20 0 4 0 8 0 11 2 27 0 4
66+
21 0 2 0 3 1 9 1 18 0 6
67+
22 0 1 0 3 1 7 0 3 0 5
68+
23 0 2 0 4 0 2 0 7 0 2
69+
24 0 2 0 2 1 3 0 3 0 5
70+
25 0 0 0 1 0 1 0 1 0 3
71+
26 0 1 0 0 0 2 0 2 0 0
72+
27 0 0 0 3 0 1 0 0 0 1
73+
28 0 0 0 3 0 0 0 1 0 0
74+
29 0 0 0 2 0 2 0 1 0 3
75+
30 0 1 0 0 0 0 0 0 0 0
76+
31 0 1 0 0 0 0 0 2 0 2
77+
32 0 0 0 1 0 2 0 0 0 0
78+
33 0 0 0 2 0 0 0 0 0 1
79+
34 0 0 0 0 0 0 0 0 0 2
80+
35 0 1 0 1 0 0 0 0 0 1
81+
36 0 1 0 0 0 1 0 1 0 0
82+
37 0 0 0 1 0 0 0 0 0 0
83+
40 0 0 0 0 0 1 0 1 0 0
84+
41 0 0 0 0 0 0 0 0 0 1
85+
42 0 0 0 0 0 0 0 0 0 1
86+
44 0 0 0 0 0 1 0 0 0 0
87+
46 0 0 0 0 0 0 0 1 0 0
88+
47 0 0 0 0 0 0 0 0 0 1
89+
50 0 0 0 0 0 0 0 0 0 1
90+
54 0 0 0 1 0 0 0 0 0 0
91+
58 0 0 0 1 0 0 0 0 0 0
92+
over: 0 0 0 0 0 0 0 0 0 0
93+
count: 600002 600002 600002 600002 600002 600002 600002 600002 600002 600002
94+
min: 0 1 0 1 0 1 0 1 0 1
95+
avg: 0 5 0 5 0 4 0 4 0 5
96+
max: 16 36 15 58 24 44 21 46 13 50
97+
98+
SEE ALSO
99+
========
100+
**rtla-timerlat**\(1), **rtla-timerlat-top**\(1)
101+
102+
*timerlat* tracer documentation: <https://www.kernel.org/doc/html/latest/trace/timerlat-tracer.html>
103+
104+
AUTHOR
105+
======
106+
Written by Daniel Bristot de Oliveira <bristot@kernel.org>

0 commit comments

Comments
 (0)