1perf-timechart(1) 2================= 3 4NAME 5---- 6perf-timechart - Tool to visualize total system behavior during a workload 7 8SYNOPSIS 9-------- 10[verse] 11'perf timechart' [<timechart options>] {record} [<record options>] 12 13DESCRIPTION 14----------- 15There are two variants of perf timechart: 16 17 'perf timechart record <command>' to record the system level events 18 of an arbitrary workload. 19 20 'perf timechart' to turn a trace into a Scalable Vector Graphics file, 21 that can be viewed with popular SVG viewers such as 'Inkscape'. 22 23TIMECHART OPTIONS 24----------------- 25-o:: 26--output=:: 27 Select the output file (default: output.svg) 28-i:: 29--input=:: 30 Select the input file (default: perf.data unless stdin is a fifo) 31-w:: 32--width=:: 33 Select the width of the SVG file (default: 1000) 34-P:: 35--power-only:: 36 Only output the CPU power section of the diagram 37-T:: 38--tasks-only:: 39 Don't output processor state transitions 40-p:: 41--process:: 42 Select the processes to display, by name or PID 43 44--symfs=<directory>:: 45 Look for files with symbols relative to this directory. 46-n:: 47--proc-num:: 48 Print task info for at least given number of tasks. 49-t:: 50--topology:: 51 Sort CPUs according to topology. 52--highlight=<duration_nsecs|task_name>:: 53 Highlight tasks (using different color) that run more than given 54 duration or tasks with given name. If number is given it's interpreted 55 as number of nanoseconds. If non-numeric string is given it's 56 interpreted as task name. 57 58RECORD OPTIONS 59-------------- 60-P:: 61--power-only:: 62 Record only power-related events 63-T:: 64--tasks-only:: 65 Record only tasks-related events 66-g:: 67--callchain:: 68 Do call-graph (stack chain/backtrace) recording 69 70EXAMPLES 71-------- 72 73$ perf timechart record git pull 74 75 [ perf record: Woken up 13 times to write data ] 76 [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ] 77 78$ perf timechart 79 80 Written 10.2 seconds of trace to output.svg. 81 82Record system-wide timechart: 83 84 $ perf timechart record 85 86 then generate timechart and highlight 'gcc' tasks: 87 88 $ perf timechart --highlight gcc 89 90SEE ALSO 91-------- 92linkperf:perf-record[1] 93