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