1=====================
2rtla-timerlat-hist
3=====================
4------------------------------------------------
5Histograms of the operating system timer latency
6------------------------------------------------
7
8:Manual section: 1
9
10SYNOPSIS
11========
12**rtla timerlat hist** [*OPTIONS*] ...
13
14DESCRIPTION
15===========
16
17.. include:: common_timerlat_description.rst
18
19The **rtla timerlat hist** displays a histogram of each tracer event
20occurrence. This tool uses the periodic information, and the
21**osnoise:** tracepoints are enabled when using the **-T** option.
22
23OPTIONS
24=======
25
26.. include:: common_timerlat_options.rst
27
28.. include:: common_hist_options.rst
29
30.. include:: common_options.rst
31
32EXAMPLE
33=======
34In the example below, **rtla timerlat hist** is set to run for *10* minutes,
35in the cpus *0-4*, *skipping zero* only lines. Moreover, **rtla timerlat
36hist** 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
98SEE 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
104AUTHOR
105======
106Written by Daniel Bristot de Oliveira <bristot@kernel.org>
107