tools/perf/Documentation/perf-timechart.txt

   1 perf-timechart(1)
   2 =================
   3
   4 NAME
   5 ----
   6 perf-timechart - Tool to visualize total system behavior during a workload
   7
   8 SYNOPSIS
   9 --------
  10 [verse]
  11 'perf timechart' [<timechart options>] {record} [<record options>]
  12
  13 DESCRIPTION
  14 -----------
  15 There 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
  23 TIMECHART 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
  47 EXAMPLES
  48 --------
  49
  50 $ perf timechart record git pull
  51
  52   [ perf record: Woken up 13 times to write data ]
  53   [ perf record: Captured and wrote 4.253 MB perf.data (~185801 samples) ]
  54
  55 $ perf timechart
  56
  57   Written 10.2 seconds of trace to output.svg.
  58
  59 Record system-wide timechart:
  60
  61   $ perf timechart record
  62
  63   then generate timechart and highlight 'gcc' tasks:
  64
  65   $ perf timechart --highlight gcc
  66
  67 -n::
  68 --proc-num::
  69         Print task info for at least given number of tasks.
  70 -t::
  71 --topology::
  72         Sort CPUs according to topology.
  73 --highlight=<duration_nsecs|task_name>::
  74         Highlight tasks (using different color) that run more than given
  75         duration or tasks with given name. If number is given it's interpreted
  76         as number of nanoseconds. If non-numeric string is given it's
  77         interpreted as task name.
  78
  79 RECORD OPTIONS
  80 --------------
  81 -P::
  82 --power-only::
  83         Record only power-related events
  84 -T::
  85 --tasks-only::
  86         Record only tasks-related events
  87 -g::
  88 --callchain::
  89         Do call-graph (stack chain/backtrace) recording
  90
  91 SEE ALSO
  92 --------
  93 linkperf:perf-record[1]