162306a36Sopenharmony_ci===================== 262306a36Sopenharmony_cirtla-timerlat-hist 362306a36Sopenharmony_ci===================== 462306a36Sopenharmony_ci------------------------------------------------ 562306a36Sopenharmony_ciHistograms of the operating system timer latency 662306a36Sopenharmony_ci------------------------------------------------ 762306a36Sopenharmony_ci 862306a36Sopenharmony_ci:Manual section: 1 962306a36Sopenharmony_ci 1062306a36Sopenharmony_ciSYNOPSIS 1162306a36Sopenharmony_ci======== 1262306a36Sopenharmony_ci**rtla timerlat hist** [*OPTIONS*] ... 1362306a36Sopenharmony_ci 1462306a36Sopenharmony_ciDESCRIPTION 1562306a36Sopenharmony_ci=========== 1662306a36Sopenharmony_ci 1762306a36Sopenharmony_ci.. include:: common_timerlat_description.rst 1862306a36Sopenharmony_ci 1962306a36Sopenharmony_ciThe **rtla timerlat hist** displays a histogram of each tracer event 2062306a36Sopenharmony_cioccurrence. This tool uses the periodic information, and the 2162306a36Sopenharmony_ci**osnoise:** tracepoints are enabled when using the **-T** option. 2262306a36Sopenharmony_ci 2362306a36Sopenharmony_ciOPTIONS 2462306a36Sopenharmony_ci======= 2562306a36Sopenharmony_ci 2662306a36Sopenharmony_ci.. include:: common_timerlat_options.rst 2762306a36Sopenharmony_ci 2862306a36Sopenharmony_ci.. include:: common_hist_options.rst 2962306a36Sopenharmony_ci 3062306a36Sopenharmony_ci.. include:: common_options.rst 3162306a36Sopenharmony_ci 3262306a36Sopenharmony_ci.. include:: common_timerlat_aa.rst 3362306a36Sopenharmony_ci 3462306a36Sopenharmony_ciEXAMPLE 3562306a36Sopenharmony_ci======= 3662306a36Sopenharmony_ciIn the example below, **rtla timerlat hist** is set to run for *10* minutes, 3762306a36Sopenharmony_ciin the cpus *0-4*, *skipping zero* only lines. Moreover, **rtla timerlat 3862306a36Sopenharmony_cihist** will change the priority of the *timerlat* threads to run under 3962306a36Sopenharmony_ci*SCHED_DEADLINE* priority, with a *100us* runtime every *1ms* period. The 4062306a36Sopenharmony_ci*1ms* period is also passed to the *timerlat* tracer. Auto-analysis is disabled 4162306a36Sopenharmony_cito reduce overhead :: 4262306a36Sopenharmony_ci 4362306a36Sopenharmony_ci [root@alien ~]# timerlat hist -d 10m -c 0-4 -P d:100us:1ms -p 1000 --no-aa 4462306a36Sopenharmony_ci # RTLA timerlat histogram 4562306a36Sopenharmony_ci # Time unit is microseconds (us) 4662306a36Sopenharmony_ci # Duration: 0 00:10:00 4762306a36Sopenharmony_ci Index IRQ-000 Thr-000 IRQ-001 Thr-001 IRQ-002 Thr-002 IRQ-003 Thr-003 IRQ-004 Thr-004 4862306a36Sopenharmony_ci 0 276489 0 206089 0 466018 0 481102 0 205546 0 4962306a36Sopenharmony_ci 1 318327 35487 388149 30024 94531 48382 83082 71078 388026 55730 5062306a36Sopenharmony_ci 2 3282 122584 4019 126527 28231 109012 23311 89309 4568 98739 5162306a36Sopenharmony_ci 3 940 11815 837 9863 6209 16227 6895 17196 910 9780 5262306a36Sopenharmony_ci 4 444 17287 424 11574 2097 38443 2169 36736 462 13476 5362306a36Sopenharmony_ci 5 206 43291 255 25581 1223 101908 1304 101137 236 28913 5462306a36Sopenharmony_ci 6 132 101501 96 64584 635 213774 757 215471 99 73453 5562306a36Sopenharmony_ci 7 74 169347 65 124758 350 57466 441 53639 69 148573 5662306a36Sopenharmony_ci 8 53 85183 31 156751 229 9052 306 9026 39 139907 5762306a36Sopenharmony_ci 9 22 10387 12 42762 161 2554 225 2689 19 26192 5862306a36Sopenharmony_ci 10 13 1898 8 5770 114 1247 128 1405 13 3772 5962306a36Sopenharmony_ci 11 9 560 9 924 71 686 76 765 8 713 6062306a36Sopenharmony_ci 12 4 256 2 360 50 411 64 474 3 278 6162306a36Sopenharmony_ci 13 2 167 2 172 43 256 53 350 4 180 6262306a36Sopenharmony_ci 14 1 88 1 116 15 198 42 223 0 115 6362306a36Sopenharmony_ci 15 2 63 3 94 11 139 20 150 0 58 6462306a36Sopenharmony_ci 16 2 37 0 56 5 78 10 102 0 39 6562306a36Sopenharmony_ci 17 0 18 0 28 4 57 8 80 0 15 6662306a36Sopenharmony_ci 18 0 8 0 17 2 50 6 56 0 12 6762306a36Sopenharmony_ci 19 0 9 0 5 0 19 0 48 0 18 6862306a36Sopenharmony_ci 20 0 4 0 8 0 11 2 27 0 4 6962306a36Sopenharmony_ci 21 0 2 0 3 1 9 1 18 0 6 7062306a36Sopenharmony_ci 22 0 1 0 3 1 7 0 3 0 5 7162306a36Sopenharmony_ci 23 0 2 0 4 0 2 0 7 0 2 7262306a36Sopenharmony_ci 24 0 2 0 2 1 3 0 3 0 5 7362306a36Sopenharmony_ci 25 0 0 0 1 0 1 0 1 0 3 7462306a36Sopenharmony_ci 26 0 1 0 0 0 2 0 2 0 0 7562306a36Sopenharmony_ci 27 0 0 0 3 0 1 0 0 0 1 7662306a36Sopenharmony_ci 28 0 0 0 3 0 0 0 1 0 0 7762306a36Sopenharmony_ci 29 0 0 0 2 0 2 0 1 0 3 7862306a36Sopenharmony_ci 30 0 1 0 0 0 0 0 0 0 0 7962306a36Sopenharmony_ci 31 0 1 0 0 0 0 0 2 0 2 8062306a36Sopenharmony_ci 32 0 0 0 1 0 2 0 0 0 0 8162306a36Sopenharmony_ci 33 0 0 0 2 0 0 0 0 0 1 8262306a36Sopenharmony_ci 34 0 0 0 0 0 0 0 0 0 2 8362306a36Sopenharmony_ci 35 0 1 0 1 0 0 0 0 0 1 8462306a36Sopenharmony_ci 36 0 1 0 0 0 1 0 1 0 0 8562306a36Sopenharmony_ci 37 0 0 0 1 0 0 0 0 0 0 8662306a36Sopenharmony_ci 40 0 0 0 0 0 1 0 1 0 0 8762306a36Sopenharmony_ci 41 0 0 0 0 0 0 0 0 0 1 8862306a36Sopenharmony_ci 42 0 0 0 0 0 0 0 0 0 1 8962306a36Sopenharmony_ci 44 0 0 0 0 0 1 0 0 0 0 9062306a36Sopenharmony_ci 46 0 0 0 0 0 0 0 1 0 0 9162306a36Sopenharmony_ci 47 0 0 0 0 0 0 0 0 0 1 9262306a36Sopenharmony_ci 50 0 0 0 0 0 0 0 0 0 1 9362306a36Sopenharmony_ci 54 0 0 0 1 0 0 0 0 0 0 9462306a36Sopenharmony_ci 58 0 0 0 1 0 0 0 0 0 0 9562306a36Sopenharmony_ci over: 0 0 0 0 0 0 0 0 0 0 9662306a36Sopenharmony_ci count: 600002 600002 600002 600002 600002 600002 600002 600002 600002 600002 9762306a36Sopenharmony_ci min: 0 1 0 1 0 1 0 1 0 1 9862306a36Sopenharmony_ci avg: 0 5 0 5 0 4 0 4 0 5 9962306a36Sopenharmony_ci max: 16 36 15 58 24 44 21 46 13 50 10062306a36Sopenharmony_ci 10162306a36Sopenharmony_ciSEE ALSO 10262306a36Sopenharmony_ci======== 10362306a36Sopenharmony_ci**rtla-timerlat**\(1), **rtla-timerlat-top**\(1) 10462306a36Sopenharmony_ci 10562306a36Sopenharmony_ci*timerlat* tracer documentation: <https://www.kernel.org/doc/html/latest/trace/timerlat-tracer.html> 10662306a36Sopenharmony_ci 10762306a36Sopenharmony_ciAUTHOR 10862306a36Sopenharmony_ci====== 10962306a36Sopenharmony_ciWritten by Daniel Bristot de Oliveira <bristot@kernel.org> 110