Namhyung Kim | 14cbfbe | 2016-01-07 20:41:53 +0900 | [diff] [blame] | 1 | For a higher level overview, try: perf report --sort comm,dso |
| 2 | Sample related events with: perf record -e '{cycles,instructions}:S' |
| 3 | Compare performance results with: perf diff [<old file> <new file>] |
| 4 | Boolean options have negative forms, e.g.: perf report --no-children |
| 5 | Customize output of perf script with: perf script -F event,ip,sym |
| 6 | Generate a script for your data: perf script -g <lang> |
| 7 | Save output of perf stat using: perf stat record <target workload> |
| 8 | Create an archive with symtabs to analyse on other machine: perf archive |
| 9 | Search options using a keyword: perf report -h <keyword> |
| 10 | Use parent filter to see specific call path: perf report -p <regex> |
| 11 | List events using substring match: perf list <keyword> |
| 12 | To see list of saved events and attributes: perf evlist -v |
| 13 | Use --symfs <dir> if your symbol files are in non-standard locations |
| 14 | To see callchains in a more compact form: perf report -g folded |
Namhyung Kim | 09f1985 | 2016-01-11 19:35:10 +0900 | [diff] [blame] | 15 | Show individual samples with: perf script |
| 16 | Limit to show entries above 5% only: perf report --percent-limit 5 |
| 17 | Profiling branch (mis)predictions with: perf record -b / perf report |
Andi Kleen | ca52bab | 2019-03-11 07:44:59 -0700 | [diff] [blame] | 18 | To show assembler sample contexts use perf record -b / perf script -F +brstackinsn --xed |
Namhyung Kim | 09f1985 | 2016-01-11 19:35:10 +0900 | [diff] [blame] | 19 | Treat branches as callchains: perf report --branch-history |
| 20 | To count events in every 1000 msec: perf stat -I 1000 |
| 21 | Print event counts in CSV format with: perf stat -x, |
| 22 | If you have debuginfo enabled, try: perf report -s sym,srcline |
| 23 | For memory address profiling, try: perf mem record / perf mem report |
| 24 | For tracepoint events, try: perf report -s trace_fields |
| 25 | To record callchains for each sample: perf record -g |
Masahiro Yamada | 9332ef9 | 2017-02-27 14:28:47 -0800 | [diff] [blame] | 26 | To record every process run by a user: perf record -u <user> |
Kim Phillips | 1291927 | 2017-05-03 13:13:50 +0100 | [diff] [blame] | 27 | Skip collecting build-id when recording: perf record -B |
Namhyung Kim | 09f1985 | 2016-01-11 19:35:10 +0900 | [diff] [blame] | 28 | To change sampling frequency to 100 Hz: perf record -F 100 |
| 29 | See assembly instructions with percentage: perf annotate <symbol> |
| 30 | If you prefer Intel style assembly, try: perf annotate -M intel |
Namhyung Kim | 4251446 | 2016-02-25 00:13:48 +0900 | [diff] [blame] | 31 | For hierarchical output, try: perf report --hierarchy |
Kim SeonYoung | 8649b64 | 2016-09-29 17:16:42 -0700 | [diff] [blame] | 32 | Order by the overhead of source file name and line number: perf report -s srcline |
Donghyun Kim | 4934323 | 2016-09-30 07:15:57 +0900 | [diff] [blame] | 33 | System-wide collection from all CPUs: perf record -a |
Nambong Ha | 2ad8327 | 2016-09-30 08:26:02 +0900 | [diff] [blame] | 34 | Show current config key-value pairs: perf config --list |
| 35 | Show user configuration overrides: perf config --user --list |
Hansuk Hong | 2e38e66 | 2017-11-24 01:05:46 +0900 | [diff] [blame] | 36 | To add Node.js USDT(User-Level Statically Defined Tracing): perf buildid-cache --add `which node` |
Sangwon Hong | 0125195 | 2017-12-02 13:16:41 +0900 | [diff] [blame] | 37 | To report cacheline events from previous recording: perf c2c report |
Andi Kleen | ca52bab | 2019-03-11 07:44:59 -0700 | [diff] [blame] | 38 | To browse sample contexts use perf report --sample 10 and select in context menu |
| 39 | To separate samples by time use perf report --sort time,overhead,sym |
| 40 | To set sample time separation other than 100ms with --sort time use --time-quantum |
Andi Kleen | 734ac47 | 2019-06-28 15:09:00 -0700 | [diff] [blame] | 41 | Add -I to perf record to sample register values, which will be visible in perf report sample context. |
Andi Kleen | ca52bab | 2019-03-11 07:44:59 -0700 | [diff] [blame] | 42 | To show IPC for sampling periods use perf record -e '{cycles,instructions}:S' and then browse context |
| 43 | To show context switches in perf report sample context add --switch-events to perf record. |