1151750ceSArjan van de Venperf-timechart(1) 2151750ceSArjan van de Ven================= 3151750ceSArjan van de Ven 4151750ceSArjan van de VenNAME 5151750ceSArjan van de Ven---- 6151750ceSArjan van de Venperf-timechart - Tool to visualize total system behavior during a workload 7151750ceSArjan van de Ven 8151750ceSArjan van de VenSYNOPSIS 9151750ceSArjan van de Ven-------- 10151750ceSArjan van de Ven[verse] 11367b3152SStanislav Fomichev'perf timechart' [<timechart options>] {record} [<record options>] 12151750ceSArjan van de Ven 13151750ceSArjan van de VenDESCRIPTION 14151750ceSArjan van de Ven----------- 15151750ceSArjan van de VenThere are two variants of perf timechart: 16151750ceSArjan van de Ven 17151750ceSArjan van de Ven 'perf timechart record <command>' to record the system level events 18151750ceSArjan van de Ven of an arbitrary workload. 19151750ceSArjan van de Ven 20151750ceSArjan van de Ven 'perf timechart' to turn a trace into a Scalable Vector Graphics file, 21151750ceSArjan van de Ven that can be viewed with popular SVG viewers such as 'Inkscape'. 22151750ceSArjan van de Ven 23367b3152SStanislav FomichevTIMECHART OPTIONS 24367b3152SStanislav Fomichev----------------- 25151750ceSArjan van de Ven-o:: 26151750ceSArjan van de Ven--output=:: 27151750ceSArjan van de Ven Select the output file (default: output.svg) 28151750ceSArjan van de Ven-i:: 29151750ceSArjan van de Ven--input=:: 30efad1415SRobert Richter Select the input file (default: perf.data unless stdin is a fifo) 315094b655SArjan van de Ven-w:: 325094b655SArjan van de Ven--width=:: 335094b655SArjan van de Ven Select the width of the SVG file (default: 1000) 34bbe2987bSArjan van de Ven-P:: 3539a90a8eSArjan van de Ven--power-only:: 3639a90a8eSArjan van de Ven Only output the CPU power section of the diagram 37c87097d3SStanislav Fomichev-T:: 38c87097d3SStanislav Fomichev--tasks-only:: 39c87097d3SStanislav Fomichev Don't output processor state transitions 40bbe2987bSArjan van de Ven-p:: 41bbe2987bSArjan van de Ven--process:: 42bbe2987bSArjan van de Ven Select the processes to display, by name or PID 43151750ceSArjan van de Ven 44ec5761eaSDavid Ahern--symfs=<directory>:: 45ec5761eaSDavid Ahern Look for files with symbols relative to this directory. 46151750ceSArjan van de Ven 47d366c53eSRamkumar RamachandraEXAMPLES 48d366c53eSRamkumar Ramachandra-------- 49d366c53eSRamkumar Ramachandra 50d366c53eSRamkumar Ramachandra$ perf timechart record git pull 51d366c53eSRamkumar Ramachandra 52d366c53eSRamkumar Ramachandra [ perf record: Woken up 13 times to write data ] 53d366c53eSRamkumar Ramachandra [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ] 54d366c53eSRamkumar Ramachandra 55d366c53eSRamkumar Ramachandra$ perf timechart 56d366c53eSRamkumar Ramachandra 57d366c53eSRamkumar Ramachandra Written 10.2 seconds of trace to output.svg. 58d366c53eSRamkumar Ramachandra 59e57a2dffSStanislav FomichevRecord system-wide timechart: 60e57a2dffSStanislav Fomichev 61e57a2dffSStanislav Fomichev $ perf timechart record 62e57a2dffSStanislav Fomichev 63e57a2dffSStanislav Fomichev then generate timechart and highlight 'gcc' tasks: 64e57a2dffSStanislav Fomichev 65e57a2dffSStanislav Fomichev $ perf timechart --highlight gcc 66e57a2dffSStanislav Fomichev 6754874e32SStanislav Fomichev-n:: 6854874e32SStanislav Fomichev--proc-num:: 6954874e32SStanislav Fomichev Print task info for at least given number of tasks. 70c5079997SStanislav Fomichev-t:: 71c5079997SStanislav Fomichev--topology:: 72c5079997SStanislav Fomichev Sort CPUs according to topology. 73e57a2dffSStanislav Fomichev--highlight=<duration_nsecs|task_name>:: 74e57a2dffSStanislav Fomichev Highlight tasks (using different color) that run more than given 75e57a2dffSStanislav Fomichev duration or tasks with given name. If number is given it's interpreted 76e57a2dffSStanislav Fomichev as number of nanoseconds. If non-numeric string is given it's 77e57a2dffSStanislav Fomichev interpreted as task name. 7854874e32SStanislav Fomichev 79367b3152SStanislav FomichevRECORD OPTIONS 80367b3152SStanislav Fomichev-------------- 81367b3152SStanislav Fomichev-P:: 82367b3152SStanislav Fomichev--power-only:: 83367b3152SStanislav Fomichev Record only power-related events 84367b3152SStanislav Fomichev-T:: 85367b3152SStanislav Fomichev--tasks-only:: 86367b3152SStanislav Fomichev Record only tasks-related events 876f8d67faSStanislav Fomichev-g:: 886f8d67faSStanislav Fomichev--callchain:: 896f8d67faSStanislav Fomichev Do call-graph (stack chain/backtrace) recording 90367b3152SStanislav Fomichev 91151750ceSArjan van de VenSEE ALSO 92151750ceSArjan van de Ven-------- 93151750ceSArjan van de Venlinkperf:perf-record[1] 94