Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

56 lines (35 sloc) 1.716 kB
<h2>Using Google CPU Profiler</h2>
Building with GOOGLE_CPU_PROFILER set lets you collect profiles from
the server or from the command line. However, our testing has found
that the server can get stalled while profiling for reasons
unknown. Still, it's possible to get enough requests in that the
profile can be significant.
There are two stages in profiling, collecting the profile and
processing it into a readable format. Collection is different on the
command line and server.
= Profiling from the command line
For building stand alone programs you need to link with libprofiler and
libunwind:
export LIBRARY_PATH=[path]/hphp/external/google-perftools/lib:\
[path]/hphp/external/libunwind/lib
g++ <my program>.cpp -lprofiler
With a compiled program, p, execute:
CPUPROFILE=p.prof CPUPROFILE_FREQUENCY=1000 p args
This will create a file p.prof when p finishes while taking samples 1000
times per second. The frequency can be changed: higher frequencies
will impact performance but lower frequencies will require a longer
run to collect a significant number of samples.
= Profiling from the server
Run
GET http://[server]:8088/prof-cpu-on
Then hit the server some number of times. When satisfied,
GET http://[server]:8088/prof-cpu-off
A file /hphp/pprof/[host]/hphp.prof should be created. The exact path is
configurable with the runtime option Debug.ProfilerOutputDir
(defaults to /tmp on production).
= Processing the profile
Use the tool pprof to process the profile. For example:
pprof --gif p p.prof > p.gif
This generates a gif with the callgraph of p.
Note that if you needed to strip the program, it's still possible
to use pprof if you call it on the unstripped version.
Jump to Line
Something went wrong with that request. Please try again.