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