Bug: 74093078

Clone this repo:
  1. 75b02ac Quipper: Update for libsimpleperf_elf_read defaults am: 3cfa5878db by Andreas Gampe · 6 weeks ago master
  2. 3cfa587 Quipper: Update for libsimpleperf_elf_read defaults by Andreas Gampe · 7 weeks ago master-cuttlefish-testing-release
  3. 6099773 Remove dangling references to deleted submodules. am: cb4dd90cba by Jaewoong Jung · 8 weeks ago
  4. cb4dd90 Remove dangling references to deleted submodules. by Jaewoong Jung · 8 weeks ago
  5. b670a33 Fix METADATA for perf_data_converter am: 67c51d5265 am: deddae1a41 by Haibo Huang · 5 months ago

Introduction

The perf_to_profile binary can be used to turn a perf.data file, which is generated by the linux profiler, perf, into a profile.proto file which can be visualized using the tool pprof.

For details on pprof, see https://github.com/google/pprof

THIS IS NOT AN OFFICIAL GOOGLE PRODUCT

Prerequisites:

Compilation:

To install all dependences and build the binary, run the following commands. These were tested on Debian GNU/Linux 8 (jessie):

sudo apt-get -y install autoconf automake g++ git libelf-dev libssl-dev libtool make pkg-config
git clone --recursive https://github.com/google/perf_data_converter.git
cd perf_data_converter/src
make perf_to_profile

If you already have protocol buffers and googletest installed on your system, you can compile using your local packages with the following commands:

sudo apt-get -y install autoconf automake g++ git libelf-dev libssl-dev libtool make pkg-config
git clone https://github.com/google/perf_data_converter.git
cd perf_data_converter/src
make perf_to_profile

Place the perf_to_profile binary in a place accessible from your path (eg /usr/local/bin).

Running tests:

There are a small number of tests that verify the basic functionality. To run these, after successful compilation, run:

make check clean
make check clean -C quipper/ -f Makefile.external

Usage:

Profile a command using perf, for example:

perf record /bin/ls

The example command will generate a profile named perf.data, you should convert this into a profile.proto then visualize it using pprof:

perf_to_profile perf.data profile.pb
pprof -web profile.pb

Recent versions of pprof will automatically invoke perf_to_profile:

pprof -web perf.data

Contribution:

We appreciate your help!

Note that perf data converter and quipper projects do not use GitHub pull requests, and that we use the issue tracker for bug reports.