rtla-timerlat-hist.rst 7.0 KB

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