table of contents
PERF_5.16-TIMECHART(1) | perf Manual | PERF_5.16-TIMECHART(1) |
NAME¶
perf-timechart - Tool to visualize total system behavior during a workload
SYNOPSIS¶
perf timechart [<timechart options>] {record} [<record options>]
DESCRIPTION¶
There are two variants of perf timechart:
'perf timechart record <command>' to record the system level events of an arbitrary workload. By default timechart records only scheduler and CPU events (task switches, running times, CPU power states, etc), but it's possible to record IO (disk, network) activity using -I argument.
'perf timechart' to turn a trace into a Scalable Vector Graphics file, that can be viewed with popular SVG viewers such as 'Inkscape'. Depending on the events in the perf.data file, timechart will contain scheduler/cpu events or IO events.
In IO mode, every bar has two charts: upper and lower. Upper bar shows incoming events (disk reads, ingress network packets). Lower bar shows outgoing events (disk writes, egress network packets). There are also poll bars which show how much time application spent in poll/epoll/select syscalls.
TIMECHART OPTIONS¶
-o, --output=
-i, --input=
-w, --width=
-P, --power-only
-T, --tasks-only
-p, --process
-f, --force
--symfs=<directory>
-n, --proc-num
-t, --topology
--highlight=<duration_nsecs|task_name>
--io-skip-eagain
--io-min-time=<nsecs>
--io-merge-dist=<nsecs>
RECORD OPTIONS¶
-P, --power-only
-T, --tasks-only
-I, --io-only
-g, --callchain
EXAMPLES¶
$ perf timechart record git pull
[ perf record: Woken up 13 times to write data ] [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ]
$ perf timechart
Written 10.2 seconds of trace to output.svg.
Record system-wide timechart:
$ perf timechart record
then generate timechart and highlight 'gcc' tasks:
$ perf timechart --highlight gcc
Record system-wide IO events:
$ perf timechart record -I
then generate timechart:
$ perf timechart
SEE ALSO¶
perf-record(1)
2022-01-03 | perf |