v8/tools/turbolizer
George Wort 7c0c52861f [turbolizer] Display live range uses
Display UsePositions in the intervals
in live ranges in turbolizer.

Uses are shown as vertical red lines.

Bug: v8:7327
Change-Id: Iab8d08989b9113d1b7d393252de5988e8b25b8de
Notry: true
Reviewed-on: https://chromium-review.googlesource.com/c/v8/v8/+/2224215
Commit-Queue: Santiago Aboy Solanes <solanes@chromium.org>
Reviewed-by: Georg Neis <neis@chromium.org>
Reviewed-by: Santiago Aboy Solanes <solanes@chromium.org>
Cr-Commit-Position: refs/heads/master@{#68102}
2020-06-02 15:04:11 +00:00
..
img
src [turbolizer] Display live range uses 2020-06-02 15:04:11 +00:00
test
deploy.sh
down-arrow.png [turbolizer] Display live ranges with sequences 2020-05-27 15:50:45 +00:00
index.html [turbolizer] Display live ranges with sequences 2020-05-27 15:50:45 +00:00
info-view.html [turbolizer] Add shortcuts for hide (un)selected nodes 2019-12-04 17:34:22 +00:00
left-arrow.png
OWNERS [turbolizer] Make sigurds@ a turbolizer OWNER 2019-06-07 14:40:38 +00:00
package-lock.json [turbolizer] Updated package through npm 2019-10-16 15:02:50 +00:00
package.json [turbolizer] Updated package through npm 2019-10-16 15:02:50 +00:00
README.md [turbolizer] Update Readme regarding typescript migration 2020-05-14 10:55:23 +00:00
right-arrow.png
rollup.config.js
search2.png
tabs.css [turbolizer] Make the resizers permanently big 2019-10-21 13:45:06 +00:00
tsconfig.json
tsconfig.test.json
tsfmt.json
tslint.json
turbo-visualizer-ranges.css [turbolizer] Display live range uses 2020-06-02 15:04:11 +00:00
turbo-visualizer.css [turbolizer] Display live ranges with sequences 2020-05-27 15:50:45 +00:00
turbolizer.png
up-arrow.png [turbolizer] Display live ranges with sequences 2020-05-27 15:50:45 +00:00
upload-icon.png

Turbolizer

Turbolizer is a HTML-based tool that visualizes optimized code along the various phases of Turbofan's optimization pipeline, allowing easy navigation between source code, Turbofan IR graphs, scheduled IR nodes and generated assembly code.

Turbolizer consumes .json files that are generated per-function by d8 by passing the '--trace-turbo' command-line flag.

Turbolizer is build using npm:

cd tools/turbolizer
npm i
npm run-script build

Afterwards, turbolizer can be hosted locally by starting a web server that serve the contents of the turbolizer directory, e.g.:

python -m SimpleHTTPServer 8000

To deploy to a directory that can be hosted the script deploy can be used. The following command will deploy to the directory /www/turbolizer:

npm run deploy -- /www/turbolizer

Optionally, profiling data generated by the perf tools in linux can be merged with the .json files using the turbolizer-perf.py file included. The following command is an example of using the perf script:

perf script -i perf.data.jitted -s turbolizer-perf.py turbo-main.json

The output of the above command is a json object that can be piped to a file which, when uploaded to turbolizer, will display the event counts from perf next to each instruction in the disassembly. Further detail can be found in the bottom of this document under "Using Perf with Turbo."

Using the python interface in perf script requires python-dev to be installed and perf be recompiled with python support enabled. Once recompiled, the variable PERF_EXEC_PATH must be set to the location of the recompiled perf binaries.

Graph visualization and manipulation based on Mike Bostock's sample code for an interactive tool for creating directed graphs. Original source is at https://github.com/metacademy/directed-graph-creator and released under the MIT/X license.

Icons derived from the "White Olive Collection" created by Breezi released under the Creative Commons BY license.

Using Perf with Turbo

In order to generate perf data that matches exactly with the turbofan trace, you must use either a debug build of v8 or a release build with the flag 'disassembler=on'. This flag ensures that the '--trace-turbo' will output the necessary disassembly for linking with the perf profile.

The basic example of generating the required data is as follows:

perf record -k mono /path/to/d8 --trace-turbo --perf-prof main.js
perf inject -j -i perf.data -o perf.data.jitted
perf script -i perf.data.jitted -s turbolizer-perf.py turbo-main.json

These commands combined will run and profile d8, merge the output into a single 'perf.data.jitted' file, then take the event data from that and link them to the disassembly in the 'turbo-main.json'. Note that, as above, the output of the script command must be piped to a file for uploading to turbolizer.

There are many options that can be added to the first command, for example '-e' can be used to specify the counting of specific events (default: cycles), as well as '--cpu' to specify which CPU to sample.

Turbolizer build process

The typescript sources reside in tools/turbolizer/src, and the typescript compiler will put the JavaScript output into tools/turbolizer/build/. The index.html file is set up to load the JavaScript from that directory.