---
name: "perf_3.16-timechart"
section: "1"
platform: "linux"
package: "linux-tools-3.16"
version: "3.16.56-1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/perf_3.16-timechart"
---

# perf\_3.16-timechart(1)

Tool to visualize total system behavior during a workload

## NAME

perf-timechart - Tool to visualize total system behavior during a workload

## SYNOPSIS

```

```

## DESCRIPTION

There are two variants of perf timechart:

```
'perf timechart record <command>' to record the system level events
of an arbitrary workload.
```

```
'perf timechart' to turn a trace into a Scalable Vector Graphics file,
that can be viewed with popular SVG viewers such as 'Inkscape'.
```

## TIMECHART OPTIONS

\-o, --output=

Select the output file (default: output.svg)

\-i, --input=

Select the input file (default: perf.data unless stdin is a fifo)

\-w, --width=

Select the width of the SVG file (default: 1000)

- \-P, --power-only

  Only output the CPU power section of the diagram

- \-T, --tasks-only

  Don’t output processor state transitions

- \-p, --process

  Select the processes to display, by name or PID

- \--symfs=\<directory\>

  Look for files with symbols relative to this directory.

- \-n, --proc-num

  Print task info for at least given number of tasks.

- \-t, --topology

  Sort CPUs according to topology.

- \--highlight=\<duration\_nsecs\|task\_name\>

  Highlight tasks (using different color) that run more than given duration or tasks with given name. If number is given it’s interpreted as number of nanoseconds. If non-numeric string is given it’s interpreted as task name.

## RECORD OPTIONS

- \-P, --power-only

  Record only power-related events

- \-T, --tasks-only

  Record only tasks-related events

- \-g, --callchain

  Do call-graph (stack chain/backtrace) recording

## 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
```

## SEE ALSO

[**perf\_3.16-record**(1)](/perf_3.16-record/1.md)