Telemetry

Telemetry

It's helpful for Mozilla's engineers to be able to measure how Firefox behaves in the real world. The Telemetry feature provides this capability by sending performance and usage info to Mozilla. As you use Firefox, Telemetry measures and collects non-personal information, such as performance, hardware, usage and customizations. It then sends this information to Mozilla on a daily basis and we use it to improve Firefox.

Accessing Telemetry Data

Aggregate Telemetry data from all submissions can be viewed on the Telemetry dashboard at telemetry.mozilla.org.

Instance Telemetry data (collected in your browser) can be viewed by typing about:telemetry into the Firefox URL bar.

Documentation

Firefox Users

• Mozilla Support: Send performance data to Mozilla to help improve Firefox
• Mozilla Support: How can I help by submitting mobile performance data?
• Telemetry and User Control: FAQ

Firefox Devs

• MDN: Adding a new Telemetry probe
  • Data collection policy
• Telemetry Experiments
• Dashboards & tools built on Telemetry
• Telemetry ping format (in-tree documentation)
  • Older ping formats
• Telemetry health:
  • Telemetry Errata: outages & known issues with collected Telemetry data
  • Telemetry Twitter account
  • Heka dashboard showing Telemetry health, in particular the page showing submission rates & sizes
• Firefox & Telemetry unification progress: tracking bug
• Custom payloads uploaded by Telemetry:
  • Loop (aka Firefox Hello) "ICE Failures" payload (with payload.reason="loop")
  • ...there are others
• Code repos:
  • Telemetry code in desktop Firefox
  • Telemetry dashboard code
  • AWS Telemetry backend code - soon to be superceded by the next generation backend
    • Telemetry backend code for aggregating histograms
• Custom analysis jobs:
  • Launch an ad-hoc analysis cluster
  • Scheduleding a custom analysis job

Filing Bugs

Telemetry client (in product) bugs should be filed in Toolkit::Telemetry.

Telemetry dashboard bugs should be filed in Webtools::Telemetry Dashboard

Telemetry data related bugs should be filed in Webtools::Telemetry Server

Communication

Communication Type	Mechanism	Audience
Asking questions	#telemetry on irc.mozilla.org	devs
General discussion	dev-platform and fhr-dev list	devs
Announcements	dev-platform, dev-planning lists	all

People

Project Champion
Program Management
Product	Benjamin Smedberg, Vladan Djeric
UX
Client Engineering	Vladan Djeric, Georg Fritzsche, Alessio Placitelli
Server Engineering	Mark Reid
Data Analysis	Roberto Vitillo
Privacy	Sid Stamm
Legal	Jishnu Menon

Reference

Out of date:

• Performance/Telemetry page
• Probe implementation
• Telemetry Privacy Review
• Telemetry Experiments QA