Project import generated by Copybara. (#16)

PiperOrigin-RevId: 164864795
2 files changed
tree: b8e84613ed859acb7adc97ff43a28c2638090045
  1. compat/
  2. testdata/
  3. third_party/
  4. .gitignore
  5. .gitmodules
  6. .travis.yml
  7. AUTHORS
  8. builder.cc
  9. builder.h
  10. chrome_huge_pages_mapping_deducer.cc
  11. chrome_huge_pages_mapping_deducer.h
  12. chrome_huge_pages_mapping_deducer_test.cc
  13. CONTRIBUTING
  14. CONTRIBUTORS
  15. intervalmap.h
  16. intervalmap_test.cc
  17. LICENSE
  18. Makefile
  19. path_matching.h
  20. perf_data_converter.cc
  21. perf_data_converter.h
  22. perf_data_converter_test.cc
  23. perf_data_handler.cc
  24. perf_data_handler.h
  25. perf_data_handler_test.cc
  26. perf_to_profile.cc
  27. profile.proto
  28. README.md
README.md

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
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
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

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