rtla-osnoise-hist.rst 3.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. .. |tool| replace:: osnoise hist
  2. ===================
  3. rtla-osnoise-hist
  4. ===================
  5. ------------------------------------------------------
  6. Display a histogram of the osnoise tracer samples
  7. ------------------------------------------------------
  8. :Manual section: 1
  9. SYNOPSIS
  10. ========
  11. **rtla osnoise hist** [*OPTIONS*]
  12. DESCRIPTION
  13. ===========
  14. .. include:: common_osnoise_description.txt
  15. The **rtla osnoise hist** tool collects all **osnoise:sample_threshold**
  16. occurrence in a histogram, displaying the results in a user-friendly way.
  17. The tool also allows many configurations of the *osnoise* tracer and the
  18. collection of the tracer output.
  19. OPTIONS
  20. =======
  21. .. include:: common_osnoise_options.txt
  22. .. include:: common_hist_options.txt
  23. .. include:: common_options.txt
  24. EXAMPLE
  25. =======
  26. In the example below, *osnoise* tracer threads are set to run with real-time
  27. priority *FIFO:1*, on CPUs *0-11*, for *900ms* at each period (*1s* by
  28. default). The reason for reducing the runtime is to avoid starving the
  29. **rtla** tool. The tool is also set to run for *one minute*. The output
  30. histogram is set to group outputs in buckets of *10us* and *25* entries::
  31. [root@f34 ~/]# rtla osnoise hist -P F:1 -c 0-11 -r 900000 -d 1M -b 10 -E 25
  32. # RTLA osnoise histogram
  33. # Time unit is microseconds (us)
  34. # Duration: 0 00:01:00
  35. 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
  36. 0 42982 46287 51779 53740 52024 44817 49898 36500 50408 50128 49523 52377
  37. 10 12224 8356 2912 878 2667 10155 4573 18894 4214 4836 5708 2413
  38. 20 8 5 12 2 13 24 20 41 29 53 39 39
  39. 30 1 1 0 0 10 3 6 19 15 31 30 38
  40. 40 0 0 0 0 0 4 2 7 2 3 8 11
  41. 50 0 0 0 0 0 0 0 0 0 1 1 2
  42. over: 0 0 0 0 0 0 0 0 0 0 0 0
  43. count: 55215 54649 54703 54620 54714 55003 54499 55461 54668 55052 55309 54880
  44. min: 0 0 0 0 0 0 0 0 0 0 0 0
  45. avg: 0 0 0 0 0 0 0 0 0 0 0 0
  46. max: 30 30 20 20 30 40 40 40 40 50 50 50
  47. SEE ALSO
  48. ========
  49. **rtla-osnoise**\(1), **rtla-osnoise-top**\(1)
  50. *osnoise* tracer documentation: <https://www.kernel.org/doc/html/latest/trace/osnoise-tracer.html>
  51. AUTHOR
  52. ======
  53. Written by Daniel Bristot de Oliveira <bristot@kernel.org>
  54. .. include:: common_appendix.txt