perf_script
Dump raw per-sample events from perf.data with configurable fields for flamegraph input, custom filtering, or inspecting individual events.
Instructions
Dump raw per-sample events from perf.data. Each line is one sample with configurable fields.
Use this when you need the raw data rather than aggregated histograms — for flamegraph input, custom filtering, or inspecting individual events.
Key parameters:
fields: comma-separated output fields. Common sets: 'comm,pid,tid,time,event,ip,sym,dso' (general), 'ip,sym,dso' (flamegraph input), 'comm,tid,time,ip,sym,srcline' (source mapping). Available: comm,tid,pid,time,cpu,event,trace,ip,sym,dso,addr,symoff,srcline,period,flags,callindent,insn,brstacksym.
symbols/dsos/comms/pid/tid: filter to specific functions/DSOs/processes.
time: restrict to time range 'start,stop'.
max_events: limit number of events returned.
header_only: show file metadata only.
show_task_events/show_mmap_events/show_switch_events: include non-sample events.
call_trace/call_ret_trace/insn_trace: Intel PT trace modes.
Output: one line per sample. Format depends on fields parameter. Works on any perf.data from perf record.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ns | No | Show times in nanoseconds | |
| cpu | No | List of CPUs to filter | |
| pid | No | Only consider symbols in these PIDs | |
| tid | No | Only consider symbols in these TIDs | |
| xed | No | Use Intel XED disassembler | |
| dsos | No | Only consider these DSOs | |
| time | No | Time span of interest (start,stop) | |
| comms | No | Only display events for these comms | |
| force | No | Don't complain, do it | |
| input | Yes | Path to perf.data file | |
| symfs | No | Symbol filesystem root | |
| fields | No | Comma-separated list of fields to display: comm,tid,pid,time,cpu,event,trace,ip,sym,dso,addr,symoff,srcline,period,iregs,uregs,brstack,brstacksym,flags,bpf-output,brstackinsn,brstackoff,callindent,insn,insnlen,synth,phys_addr,metric,misc,ipc,tod,data_page_size,code_page_size,ins_lat,machine_pid,vcpu,cgroup,retire_lat,brstackinsnlen,parallelism,latency | |
| header | No | Show data header | |
| inline | No | Show inline function | |
| itrace | No | Instruction Tracing options | |
| Latency | No | Show latency attributes | |
| reltime | No | Show relative time | |
| stop_bt | No | Stop unwinding callchain at this symbol | |
| symbols | No | Only consider these symbols | |
| verbose | No | Verbosity level (0-2) | |
| vmlinux | No | vmlinux pathname | |
| all_cpus | No | System-wide collection from all CPUs | |
| demangle | No | Symbol demangling (default on) | |
| kallsyms | No | kallsyms pathname | |
| deltatime | No | Show delta time | |
| max_stack | No | Maximum stack depth for callchains | |
| show_info | No | Display extended perf.data info | |
| addr_range | No | Filter by address range | |
| call_trace | No | Show call trace | |
| guest_code | No | Display guest code | |
| guestmount | No | Guest OS root file system mount point | |
| insn_trace | No | Show instruction trace | |
| max_blocks | No | Maximum number of code blocks to dump | |
| max_events | No | Maximum number of events to display | |
| stitch_lbr | No | Enable LBR callgraph stitching | |
| header_only | No | Show only data header | |
| guestmodules | No | Guest modules file | |
| guestvmlinux | No | Guest vmlinux pathname | |
| guestkallsyms | No | Guest kallsyms file | |
| call_ret_trace | No | Show call/return trace | |
| dump_raw_trace | No | Dump raw trace in ASCII | |
| graph_function | No | Show callgraph for specific function(s) | |
| per_event_dump | No | Display record as parsed event | |
| demangle_kernel | No | Enable kernel symbol demangling | |
| hide_call_graph | No | Don't display the callchain | |
| show_bpf_events | No | Display BPF events | |
| full_source_path | No | Show full source file name path | |
| merge_callchains | No | Merge deferred callchains | |
| show_kernel_path | No | Show kernel DSO path instead of [kernel.kallsyms] | |
| show_lost_events | No | Display lost events | |
| show_mmap_events | No | Display mmap-related events | |
| show_task_events | No | Display task-related events (fork/comm/exit) | |
| show_round_events | No | Display finished round events | |
| show_cgroup_events | No | Display cgroup events | |
| show_switch_events | No | Display context switch events | |
| show_namespace_events | No | Display namespace events | |
| show_text_poke_events | No | Display text poke events |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |