• Home
  • History
  • Annotate
  • only in /external/perf_data_converter/
NameDateSize

..10-Aug-201812 KiB

.gitignore10-Aug-2018205

.travis.yml10-Aug-2018773

AUTHORS10-Aug-2018306

CONTRIBUTING10-Aug-20181.4 KiB

CONTRIBUTORS10-Aug-2018572

LICENSE10-Aug-20181.5 KiB

METADATA10-Aug-2018444

MODULE_LICENSE_BSD10-Aug-20180

NOTICE10-Aug-20181.5 KiB

OWNERS10-Aug-201851

README.md10-Aug-20182 KiB

src/10-Aug-20184 KiB

third_party/10-Aug-20184 KiB

README.md

1# Introduction
2
3The `perf_to_profile` binary can be used to turn a perf.data file, which is
4generated by the linux profiler, perf, into a profile.proto file which can be
5visualized using the tool pprof.
6
7For details on pprof, see https://github.com/google/pprof
8
9**THIS IS NOT AN OFFICIAL GOOGLE PRODUCT**
10
11
12# Prerequisites:
13- Protocol buffers: http://github.com/google/protobuf
14- Google Test: http://github.com/google/googletest
15
16# Compilation:
17To install all dependences and build the binary, run the following commands.
18These were tested on Debian GNU/Linux 8 (jessie):
19```
20sudo apt-get -y install autoconf automake g++ git libelf-dev libssl-dev libtool make pkg-config
21git clone --recursive https://github.com/google/perf_data_converter.git
22cd perf_data_converter/src
23make perf_to_profile
24```
25
26If you already have protocol buffers and googletest installed on your system,
27you can compile using your local packages with the following commands:
28```
29sudo apt-get -y install autoconf automake g++ git libelf-dev libssl-dev libtool make pkg-config
30git clone https://github.com/google/perf_data_converter.git
31cd perf_data_converter/src
32make perf_to_profile
33```
34
35Place the `perf_to_profile` binary in a place accessible from your path (eg `/usr/local/bin`).
36
37# Running tests:
38There are a small number of tests that verify the basic functionality.
39To run these, after successful compilation, run:
40```
41make check clean
42make check clean -C quipper/ -f Makefile.external
43```
44
45# Usage:
46Profile a command using perf, for example:
47```
48perf record /bin/ls
49```
50
51The example command will generate a profile named perf.data, you
52should convert this into a profile.proto then visualize it using
53pprof:
54
55```
56perf_to_profile perf.data profile.pb
57pprof -web profile.pb
58```
59
60Recent versions of pprof will automatically invoke `perf_to_profile`:
61```
62pprof -web perf.data
63```
64
65# Contribution:
66We appreciate your help!
67
68Note that perf data converter and quipper projects do not use GitHub pull
69requests, and that we use the issue tracker for bug reports.
70