0001 ===================
0002 rtla-osnoise-hist
0003 ===================
0004 ------------------------------------------------------
0005 Display a histogram of the osnoise tracer samples
0006 ------------------------------------------------------
0007
0008 :Manual section: 1
0009
0010 SYNOPSIS
0011 ========
0012 **rtla osnoise hist** [*OPTIONS*]
0013
0014 DESCRIPTION
0015 ===========
0016 .. include:: common_osnoise_description.rst
0017
0018 The **rtla osnoise hist** tool collects all **osnoise:sample_threshold**
0019 occurrence in a histogram, displaying the results in a user-friendly way.
0020 The tool also allows many configurations of the *osnoise* tracer and the
0021 collection of the tracer output.
0022
0023 OPTIONS
0024 =======
0025 .. include:: common_osnoise_options.rst
0026
0027 .. include:: common_hist_options.rst
0028
0029 .. include:: common_options.rst
0030
0031 EXAMPLE
0032 =======
0033 In the example below, *osnoise* tracer threads are set to run with real-time
0034 priority *FIFO:1*, on CPUs *0-11*, for *900ms* at each period (*1s* by
0035 default). The reason for reducing the runtime is to avoid starving the
0036 **rtla** tool. The tool is also set to run for *one minute*. The output
0037 histogram is set to group outputs in buckets of *10us* and *25* entries::
0038
0039 [root@f34 ~/]# rtla osnoise hist -P F:1 -c 0-11 -r 900000 -d 1M -b 10 -E 25
0040 # RTLA osnoise histogram
0041 # Time unit is microseconds (us)
0042 # Duration: 0 00:01:00
0043 Index CPU-000 CPU-001 CPU-002 CPU-003 CPU-004 CPU-005 CPU-006 CPU-007 CPU-008 CPU-009 CPU-010 CPU-011
0044 0 42982 46287 51779 53740 52024 44817 49898 36500 50408 50128 49523 52377
0045 10 12224 8356 2912 878 2667 10155 4573 18894 4214 4836 5708 2413
0046 20 8 5 12 2 13 24 20 41 29 53 39 39
0047 30 1 1 0 0 10 3 6 19 15 31 30 38
0048 40 0 0 0 0 0 4 2 7 2 3 8 11
0049 50 0 0 0 0 0 0 0 0 0 1 1 2
0050 over: 0 0 0 0 0 0 0 0 0 0 0 0
0051 count: 55215 54649 54703 54620 54714 55003 54499 55461 54668 55052 55309 54880
0052 min: 0 0 0 0 0 0 0 0 0 0 0 0
0053 avg: 0 0 0 0 0 0 0 0 0 0 0 0
0054 max: 30 30 20 20 30 40 40 40 40 50 50 50
0055
0056 SEE ALSO
0057 ========
0058 **rtla-osnoise**\(1), **rtla-osnoise-top**\(1)
0059
0060 *osnoise* tracer documentation: <https://www.kernel.org/doc/html/latest/trace/osnoise-tracer.html>
0061
0062 AUTHOR
0063 ======
0064 Written by Daniel Bristot de Oliveira <bristot@kernel.org>
0065
0066 .. include:: common_appendix.rst
