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

   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>