1 # Converting between trace formats 2 3 Perfetto traces can be converted into other trace formats using the 4 `traceconv` tool. 5 6 The formats supported today are: 7 * proto text format: the standard text based representation of protos 8 * Chrome JSON format: the format used by chrome://tracing 9 * systrace format: the ftrace text format used by Android systrace 10 * profile format (heap profiler only): pprof-like format. 11 This is only valid for traces with 12 [heap profiler](src/profiling/memory/README.md) dumps. 13 14 traceconv is also used in the UI to convert Perfetto traces to the Chrome 15 JSON format and directly open these traces in the legacy systrace UI 16 (Catapult's chrome://tracing). 17 18 Usage 19 --------- 20 ``` 21 curl https://get.perfetto.dev/traceconv -o traceconv 22 chmod +x traceconv 23 ./traceconv [text|json|systrace|profile] [input proto file] [output file] 24 ``` 25 26 Examples 27 --------- 28 29 ### Converting a perfetto trace to systrace text format 30 `./traceconv systrace [input proto file] [output systrace file]` 31 32 ### Opening a Perfetto trace in the legacy systrace UI 33 Navigate to ui.perfetto.dev and choose the "Open with legacy UI" option. This 34 runs traceconv (the progress of which can be seen in the UI) and passes the 35 converted trace seamlessly to chrome://tracing 36 37 ### Converting a perfetto trace to Chrome JSON format (for chrome://tracing) 38 `./traceconv json [input proto file] [output json file]` 39
