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. 4654874e32SStanislav Fomichev-n:: 4754874e32SStanislav Fomichev--proc-num:: 4854874e32SStanislav Fomichev Print task info for at least given number of tasks. 49c5079997SStanislav Fomichev-t:: 50c5079997SStanislav Fomichev--topology:: 51c5079997SStanislav Fomichev Sort CPUs according to topology. 52e57a2dffSStanislav Fomichev--highlight=<duration_nsecs|task_name>:: 53e57a2dffSStanislav Fomichev Highlight tasks (using different color) that run more than given 54e57a2dffSStanislav Fomichev duration or tasks with given name. If number is given it's interpreted 55e57a2dffSStanislav Fomichev as number of nanoseconds. If non-numeric string is given it's 56e57a2dffSStanislav Fomichev interpreted as task name. 5754874e32SStanislav Fomichev 58367b3152SStanislav FomichevRECORD OPTIONS 59367b3152SStanislav Fomichev-------------- 60367b3152SStanislav Fomichev-P:: 61367b3152SStanislav Fomichev--power-only:: 62367b3152SStanislav Fomichev Record only power-related events 63367b3152SStanislav Fomichev-T:: 64367b3152SStanislav Fomichev--tasks-only:: 65367b3152SStanislav Fomichev Record only tasks-related events 666f8d67faSStanislav Fomichev-g:: 676f8d67faSStanislav Fomichev--callchain:: 686f8d67faSStanislav Fomichev Do call-graph (stack chain/backtrace) recording 69367b3152SStanislav Fomichev 70f48e00ceSStanislav FomichevEXAMPLES 71f48e00ceSStanislav Fomichev-------- 72f48e00ceSStanislav Fomichev 73f48e00ceSStanislav Fomichev$ perf timechart record git pull 74f48e00ceSStanislav Fomichev 75f48e00ceSStanislav Fomichev [ perf record: Woken up 13 times to write data ] 76f48e00ceSStanislav Fomichev [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ] 77f48e00ceSStanislav Fomichev 78f48e00ceSStanislav Fomichev$ perf timechart 79f48e00ceSStanislav Fomichev 80f48e00ceSStanislav Fomichev Written 10.2 seconds of trace to output.svg. 81f48e00ceSStanislav Fomichev 82f48e00ceSStanislav FomichevRecord system-wide timechart: 83f48e00ceSStanislav Fomichev 84f48e00ceSStanislav Fomichev $ perf timechart record 85f48e00ceSStanislav Fomichev 86f48e00ceSStanislav Fomichev then generate timechart and highlight 'gcc' tasks: 87f48e00ceSStanislav Fomichev 88f48e00ceSStanislav Fomichev $ perf timechart --highlight gcc 89f48e00ceSStanislav Fomichev 90151750ceSArjan van de VenSEE ALSO 91151750ceSArjan van de Ven-------- 92151750ceSArjan van de Venlinkperf:perf-record[1] 93