Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
bin [Dashboard] Fix stdio URLs for histogram uploads May 4, 2018
docs Fixed square bracket in trace-viewer-internals.md Nov 14, 2016
images [Catapult] Make documentation logo less comically large Nov 6, 2015
skp_data Move the skp_data directory to tracing/ Jun 30, 2015
test_data [fuchsia] Add thread state to fuchsia importer. Mar 16, 2018
third_party [Tracing] Remove unused resize_sensor.html and css-element-queries May 24, 2018
tracing Telemetry: pixel metrics in TBMv2 Aug 20, 2018
tracing_build HtmlEscape histogram json when rendering results.html Apr 26, 2018
tracing_examples tracing: Add support for system tracing via chrome://inspect?tracing Dec 15, 2017
.allow-devtools-save Move remaining files to tracing. Jun 30, 2015
.bowerrc Move third_party, examples, bin and images to tracing/ Jun 30, 2015
.gitignore Move remaining files to tracing. Jun 30, 2015
.npmignore tracing: add package.json for npm Mar 4, 2016
BUILD.gn Move all executable files to per-project bin folders Aug 10, 2015
LICENSE Move remaining files to tracing. Jun 30, 2015
OWNERS Move myself to tracing/ OWNERS emeriti Jun 12, 2017
PRESUBMIT.py [Build] Fix tracing Python tests Mar 24, 2018
README.md Update catapult docs for Gerrit. Sep 28, 2017
app.yaml trace-viewer: Let the gzip_importer use Pako directly instead of JSZip Oct 5, 2017
bower.json Move remaining files to tracing. Jun 30, 2015
package.json Use more normative name for node_bootstrap: index.js Mar 8, 2016
trace_viewer.gyp Move all executable files to per-project bin folders Aug 10, 2015
trace_viewer.gypi Telemetry: pixel metrics in TBMv2 Aug 20, 2018
tracing_project.py trace-viewer: Let the gzip_importer use Pako directly instead of JSZip Oct 5, 2017

README.md

Trace Viewer Logo

Trace-Viewer is the javascript frontend for Chrome about:tracing and Android systrace.

It provides rich analysis and visualization capabilities for many types of trace files. Its particularly good at viewing linux kernel traces (aka ftrace) and Chrome's trace_event format. Trace viewer can be embedded as a component in your own code, or used from a plain checkout to turn trace files into standalone, emailable HTML files from the commandline:

$CATAPULT/tracing/bin/trace2html my_trace.json --output=my_trace.html && open my_trace.html

Its easy to extend trace viewer to support your favorite trace format, or add domain specific visualizations to the UI to simplify drilling down into complex data.

Contributing, quick version

We welcome contributions! To hack on this code.

There are two type of tests.

In the browser

Run http server $CATAPULT/bin/run_dev_server. In any browser, navigate to http://localhost:8003/

Unit tests Descripton
All tests http://localhost:8003/tests.html
All tests with short format http://localhost:8003/tracing/tests.html?shortFormat
An individual test suite(such as ui/foo_test.js) http://localhost:8003/tests.html?testSuiteName=ui.foo
Tests named foo http://localhost:8003/tests.html?testFilterString=foo

On command

Unit tests Description
All python tests $CATAPULT/tracing/bin/run_py_tests
All tracing tests in d8 environment $CATAPULT/tracing/bin/run_vinn_tests
All tracing tests in devserver environment $CATAPULT/tracing/bin/run_devserver_tests
All tests $CATAPULT/tracing/bin/run_tests

Make sure tests pass before sending us changelist. We use Gerrit for codereview. For more details, esp on Gerrit, read our contributing guide or check out the trace viewer wiki.

Contact Us

Join our Google Group: