[XRay][docs] Chrome Trace Viewer Instructions
This patch adds an example on how to generate a Chrome Trace Viewer
loadable trace from an XRay trace.
llvm-svn: 340847
diff --git a/llvm/docs/XRayExample.rst b/llvm/docs/XRayExample.rst
index e5d934c..ca24324 100644
--- a/llvm/docs/XRayExample.rst
+++ b/llvm/docs/XRayExample.rst
@@ -257,6 +257,21 @@
If you open the svg in a browser, mouse events allow exploring the call stacks.
+Chrome Trace Viewer Visualization
+---------------------------------
+
+We can also generate a trace which can be loaded by the Chrome Trace Viewer
+from the same generated trace:
+
+::
+
+ $ llvm-xray convert -symbolize -instr_map=./bin/llc \
+ -output_format=trace_event xray-log.llc.5rqxkU \
+ | gzip > llc-trace.txt.gz
+
+From a Chrome browser, navigating to ``chrome:///tracing`` allows us to load
+the ``sample-trace.txt.gz`` file to visualize the execution trace.
+
Further Exploration
-------------------
@@ -317,6 +332,7 @@
$ llvm-xray graph xray-log.sample.* -m sample -color-edges=sum -edge-label=sum \
| unflatten -f -l10 | dot -Tsvg -o sample.svg
+
Next Steps
----------
@@ -327,8 +343,6 @@
- Implement a query/filtering library that allows for finding patterns in the
XRay traces.
- - A conversion from the XRay trace onto something that can be visualised
- better by other tools (like the Chrome trace viewer for example).
- Collecting function call stacks and how often they're encountered in the
XRay trace.