google /pprof
pprof is a tool for visualization and analysis of profiling data
★ 9,326⑂ 688👁 121⑃ 747● 321▤ 0
+0
日增长
9,326
stars
688
forks
121
watchers
747
prs
321
issues
0
releases
README
Introduction
IMPORTANT: Read CONTRIBUTING.md if you consider making a
pprof contribution.
pprof is a tool for visualization and analysis of profiling data.
pprof reads a collection of profiling samples in profile.proto format and
generates reports to visualize and help analyze the data. It can generate both
text and graphical reports (through the use of the dot visualization package).
profile.proto is a protocol buffer that describes a set of callstacks
and symbolization information. A common usage is to represent a set of
sampled callstacks from statistical profiling. The format is
described on the proto/profile.proto file. For details on protocol
buffers, see https://developers.google.com/protocol-buffers
Profiles can be read from a local file, or over http. Multiple
profiles of the same type can be aggregated or compared.
If the profile samples contain machine addresses, pprof can symbolize
them through the use of the native binutils tools (addr2line and nm).
This is not an official Google product.
Building pprof
Prerequisites:
- Go development kit of a supported version.
Follow these instructions to prepare
the environment.
- Graphviz: http://www.graphviz.org/
Optional, used to generate graphic visualizations of profiles
To build and install it:
go install github.com/google/pprof@latest
The binary will be installed $GOPATH/bin ($HOME/go/bin by default).
Basic usage
pprof can read a profile from a file or directly from a server via http.
Specify the profile input(s) in the command line, and use options to
indicate how to format the report.
Generate a text report of the profile, sorted by hotness:
% pprof -top [main_binary] profile.pb.gz
Where
main_binary: Local path to the main program binary, to enable symbolization
profile.pb.gz: Local path to the profile in a compressed protobuf, or
URL to the http service that serves a profile.
Generate a graph in an SVG file, and open it with a web browser:
pprof -web [main_binary] profile.pb.gz
Run pprof on interactive mode:
If no output formatting option is specified, pprof runs on interactive mode,
where reads the profile and accepts interactive commands for visualization and
refinement of the profile.
pprof [main_binary] profile.pb.gz
This will open a simple shell that takes pprof commands to generate reports.
Type 'help' for available commands/options.
Run pprof via a web interface
If the -http flag is specified, pprof starts a web server at
the specified host:port that provides an interactive web-based interface to pprof.
Host is optional, and is "localhost" by default. Port is optional, and is a
random available port by default. -http=":" starts a server locally at
a random port.
pprof -http=[host]:[port] [main_binary] profile.pb.gz
The preceding command should automatically open your web browser at
the right page; if not, you can manually visit the specified port in
your web browser.
Using pprof with Linux Perf
pproTop issues
#324Not able to see the profiling results properly for a profile generated from gperftools on mac OS High sierra16 comments · 2018-02-16#477OS X symbolization still does not work15 comments · 2019-07-18#409Strange mapping at 0 on Mach-O14 comments · 2018-08-14#457Add support for flamescope12 comments · 2019-02-27#655web: flamegraph: show filename in tooltip11 comments · 2021-10-01#401Support flame graph as an output format11 comments · 2018-07-17#338Tests fail on CentOS 6.9 (binutils is 2.20 where addr2line does not support -a flag)9 comments · 2018-03-21#914weblist comes back blank on OSX when binary referenced in profile exists7 comments · 2024-11-29