| # Converting from Perfetto to other trace formats |
| |
| Perfetto's native protobuf based format can be converted to other trace formats. |
| This doc is a quick guide to how that works. |
| |
|  |
| |
| ## Prerequisites |
| |
| - A host running Linux or MacOS |
| - A Perfetto protobuf trace file |
| |
| The supported output formats are: |
| |
| - `text` - protobuf text format: a text based representation of protos |
| - `json` - Chrome JSON format: the format used by chrome://tracing |
| - `systrace`: the ftrace text format used by Android systrace |
| - `profile` : pprof-like format. Either for traces with with native heap |
| profiler dumps or callstack sampling (note however callstacks requires the |
| `--perf` flag). |
| |
| ## Setup |
| |
| To use the latest binaries: |
| |
| ```bash |
| curl -LO https://get.perfetto.dev/traceconv |
| chmod +x traceconv |
| ./traceconv [text|json|systrace|profile] [input proto file] [output file] |
| ``` |
| |
| For versioned downloads, replace `<tag>` with the required git tag: |
| |
| ```bash |
| curl -LO https://raw.githubusercontent.com/google/perfetto/<tag>/tools/traceconv |
| chmod +x traceconv |
| ./traceconv [text|json|systrace|profile] [input proto file] [output file] |
| ``` |
| |
| ## Converting to systrace text format |
| |
| `./traceconv systrace [input proto file] [output systrace file]` |
| |
| ## Converting to Chrome Tracing JSON format |
| |
| `./traceconv json [input proto file] [output json file]` |
| |
| ## Converting to pprof profile. |
| |
| This extract all samples from the trace, and outputs a proto that is compatible |
| with pprof. |
| |
| If you are extracting heaps profiles like heapprofd you can use the following: |
| |
| `~/traceconv profile [input proto file] [output file]` |
| |
| However if you are using callstack sampling like traced_perf then use the |
| following instead: |
| |
| `~/traceconv profile [input proto file] [output file] --perf` |
| |
| Note for `--perf` the output is one pprof file per process sampled in the trace. |
| You can use pprof to merge them together if desired. |
| |
| ## Opening in the legacy systrace UI |
| |
| If you just want to open a Perfetto trace with the legacy (Catapult) trace |
| viewer, you can just navigate to [ui.perfetto.dev](https://ui.perfetto.dev), and |
| use the _"Open with legacy UI"_ link. This runs `traceconv` within the browser |
| using WebAssembly and passes the converted trace seamlessly to chrome://tracing. |
