Make it clearer how to view the deobfuscated trace Bug: 253700895 Change-Id: I7dad0c89d189281c939c26c193d3b20c7748929e
diff --git a/docs/data-sources/native-heap-profiler.md b/docs/data-sources/native-heap-profiler.md index 720b806..e5e160c 100644 --- a/docs/data-sources/native-heap-profiler.md +++ b/docs/data-sources/native-heap-profiler.md
@@ -298,7 +298,7 @@ If your profile contains obfuscated Java methods (like `fsd.a`), you can provide a deobfuscation map to turn them back into human readable. To do so, use the `PERFETTO_PROGUARD_MAP` environment variable, using the -format `packagename=filename[:packagename=filename...]`, e.g. +format `packagename=map_filename[:packagename=map_filename...]`, e.g. `PERFETTO_PROGUARD_MAP=com.example.pkg1=foo.txt:com.example.pkg2=bar.txt`. All tools (traceconv, trace_processor_shell, the heap_profile script) support specifying @@ -306,13 +306,17 @@ You can get a deobfuscation map for your trace using `tools/traceconv deobfuscate`. Then concatenate the resulting file to your -trace to get a deobfuscated version of it. +trace to get a deobfuscated version of it (the input trace should be in the +perfetto format, otherwise concatenation will not produce a reasonable output). ``` -PERFETTO_PROGUARD_MAP=com.example.pkg tools/traceconv deobfuscate ${TRACE} > deobfuscation_map +PERFETTO_PROGUARD_MAP=com.example.pkg=proguard_map.txt tools/traceconv deobfuscate ${TRACE} > deobfuscation_map cat ${TRACE} deobfuscation_map > deobfuscated_trace ``` +`deobfuscated_trace` can be viewed in the +[Perfetto UI](https://ui.perfetto.dev). + ## Troubleshooting ### Buffer overrun