e238dcbbfa | ||
---|---|---|
dashboard | ||
.gitignore | ||
Formats.mkd | ||
LICENSE | ||
Makefile | ||
README.md | ||
setup.py |
README.md
Telemetry Dashboard
Telemetry dashboard is an analysis job that aggregates telemetry histograms and simple measures, and offers an decent presentation. The default dashboard developed in this repository is hosted at (telemetry.mozilla.com)[http://telemetry.mozilla.com]. 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.com/js/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!
Hacking Telemetry Dashboard
If you want to improve the user-interface for telemetry dashboard, clone this
repository, setup a static server that hosts the html/
folder on our localhost
and start hacking. This is easy!
If you want to add new aggregations, or improve upon existing aggregations,
change the storage format, take a look at Formats.mkd
. Talk to the guy who is
maintaining telemetry dashboard.
Basic flow is as follows:
- An
.egg
file is generated withmake egg
- Analysis tasks are created with telemetry-server
DashboardProcessor
fromanalysis.py
aggregated telemetry submissions, this process is driven by telemetry-server.Aggregator
fromaggregator.py
collects results from analysis tasks, by: 1. Downloads existing data from s3 2. Fetch task finished messages from SQS 3. Downloadresult.txt
files in parallel 4. Updates results on disk 5. Publishes updated results in a new subfolder ofcurrent/
on s3, every once in a while. 6. Check points all aggregated data to a subfolder ofcheck-points/
on s3, every once in a while. 7. Repeat