1 For a higher level overview, try: perf report 1 For a higher level overview, try: perf report --sort comm,dso
2 Sample related events with: perf record -e '{c 2 Sample related events with: perf record -e '{cycles,instructions}:S'
3 Compare performance results with: perf diff [< 3 Compare performance results with: perf diff [<old file> <new file>]
4 Boolean options have negative forms, e.g.: per 4 Boolean options have negative forms, e.g.: perf report --no-children
5 To not accumulate CPU time of children symbols <<
6 Customize output of perf script with: perf scr 5 Customize output of perf script with: perf script -F event,ip,sym
7 Generate a script for your data: perf script - 6 Generate a script for your data: perf script -g <lang>
8 Save output of perf stat using: perf stat reco 7 Save output of perf stat using: perf stat record <target workload>
9 Create an archive with symtabs to analyse on o 8 Create an archive with symtabs to analyse on other machine: perf archive
10 Search options using a keyword: perf report -h 9 Search options using a keyword: perf report -h <keyword>
11 Use parent filter to see specific call path: p 10 Use parent filter to see specific call path: perf report -p <regex>
12 List events using substring match: perf list < 11 List events using substring match: perf list <keyword>
13 To see list of saved events and attributes: pe 12 To see list of saved events and attributes: perf evlist -v
14 Use --symfs <dir> if your symbol files are in 13 Use --symfs <dir> if your symbol files are in non-standard locations
15 To see callchains in a more compact form: perf 14 To see callchains in a more compact form: perf report -g folded
16 To see call chains by final symbol taking CPU <<
17 Show individual samples with: perf script 15 Show individual samples with: perf script
18 Limit to show entries above 5% only: perf repo 16 Limit to show entries above 5% only: perf report --percent-limit 5
19 Profiling branch (mis)predictions with: perf r 17 Profiling branch (mis)predictions with: perf record -b / perf report
20 To show assembler sample context control flow !! 18 Treat branches as callchains: perf report --branch-history
21 To adjust path to source files to local file s !! 19 To count events in every 1000 msec: perf stat -I 1000
22 Treat branches as callchains: perf record -b . !! 20 Print event counts in CSV format with: perf stat -x,
23 Show estimate cycles per function and IPC in a <<
24 To count events every 1000 msec: perf stat -I <<
25 Print event counts in machine readable CSV for <<
26 If you have debuginfo enabled, try: perf repor 21 If you have debuginfo enabled, try: perf report -s sym,srcline
27 For memory address profiling, try: perf mem re 22 For memory address profiling, try: perf mem record / perf mem report
28 For tracepoint events, try: perf report -s tra 23 For tracepoint events, try: perf report -s trace_fields
29 To record callchains for each sample: perf rec 24 To record callchains for each sample: perf record -g
30 If call chains don't work try perf record --ca <<
31 To record every process run by a user: perf re 25 To record every process run by a user: perf record -u <user>
32 To show inline functions in call traces add -- <<
33 To not record events from perf itself add --ex <<
34 Skip collecting build-id when recording: perf 26 Skip collecting build-id when recording: perf record -B
35 To change sampling frequency to 100 Hz: perf r 27 To change sampling frequency to 100 Hz: perf record -F 100
36 To show information about system the samples w <<
37 To only collect call graph on one event use pe <<
38 To set sampling period of individual events us <<
39 To group events which need to be collected tog <<
40 To compute metrics for samples use perf record <<
41 See assembly instructions with percentage: per 28 See assembly instructions with percentage: perf annotate <symbol>
42 If you prefer Intel style assembly, try: perf 29 If you prefer Intel style assembly, try: perf annotate -M intel
43 When collecting LBR backtraces use --stitch-lb <<
44 For hierarchical output, try: perf report --hi 30 For hierarchical output, try: perf report --hierarchy
45 Order by the overhead of source file name and 31 Order by the overhead of source file name and line number: perf report -s srcline
46 System-wide collection from all CPUs: perf rec 32 System-wide collection from all CPUs: perf record -a
47 Show current config key-value pairs: perf conf 33 Show current config key-value pairs: perf config --list
48 To collect Processor Trace with samples use pe <<
49 To trace calls using Processor Trace use perf <<
50 To measure approximate function latency with P <<
51 To trace only single function with Processor T <<
52 Show user configuration overrides: perf config 34 Show user configuration overrides: perf config --user --list
53 To add Node.js USDT(User-Level Statically Defi 35 To add Node.js USDT(User-Level Statically Defined Tracing): perf buildid-cache --add `which node`
54 To analyze cache line scalability issues use p !! 36 To report cacheline events from previous recording: perf c2c report
55 To browse sample contexts use perf report --sa <<
56 To separate samples by time use perf report -- <<
57 To filter subset of samples with report or scr <<
58 To set sample time separation other than 100ms <<
59 Add -I to perf record to sample register value <<
60 To show IPC for sampling periods use perf reco <<
61 To show context switches in perf report sample <<
62 To show time in nanoseconds in record/report a <<
63 To compare hot regions in two workloads use pe <<
64 To compare scalability of two workload samples <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.