Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Web-frontend for aggregated telemetry data
JavaScript HTML CSS
branch: master

Merge pull request #66 from mnoorenberghe/select2_png

Add missing images from the select2 library
latest commit dbbb9095d3
@vdjeric vdjeric authored

README.md

Telemetry Dashboard

Telemetry dashboard is a presentation of histogram and simple measure aggregates of telemetry submissions. The default dashboard developed in this repository is hosted at telemetry.mozilla.org.

But the aggregated data is also available for consumption by third-party applications, so you don't need to do the aggregation on your own.

Consuming Telemetry Aggregations

Include into your code http://telemetry.mozilla.org/v1/telemetry.js feel free to use the other modules too. Don't go about reading the raw JSON files, they are not designed for human consumption!

We recommend that you include telemetry.js from http://telemetry.mozilla.org/v1/telemetry.js, this file is used to access all the generated aggregates. We will undertake reasonable effort to ensure that it remains backwards compatible and continously updated with new aggregates.

Please refer to the official documentation for telemetry.js for instructions on how to use this library.

Hacking Telemetry Dashboard

If you want to improve the user-interface for telemetry dashboard, clone this repository, hack and push the master branch to your own gh-pages branch. Now you can share your dashboard with others.

For local development, the easiest is to run a basic webserver to serve the root of the repository as static files:

cd /path/to/telemetry-dashboard
python -m SimpleHTTPServer

Now you can load http://localhost:8000 in your browser.

If you want to add new aggregations, or improve upon existing aggregations, ie. anything that provides data not already provided by telemetry.js then you should look in the telemetry-aggregator repository.

Essentially, the dashboard is split in two repositories, the web-face features in this repository. And the server-side analysis job aggregating data in the telemetry-aggregator repository. The reasoning behind this is to make it easy to fork this repository improve the visual representations of the aggregates and create a custom dashboard hosted on github pages.

Something went wrong with that request. Please try again.