It's helpful for Mozilla's engineers and decision-makers 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 the Data== * Instance Telemetry data (collected in your browser) can be viewed by typing <tt>about:telemetry</tt> into the Firefox URL bar.* Aggregate Telemetry data from all submissions can be viewed on the Telemetry dashboard at [http://telemetry.mozilla.org telemetry.mozilla.org].* Arbitrary custom analyses can be done via [http://www.robertovitillo.com/2015/01/16/next-gen-data-analysis-framework-for-telemetry/ analysis.telemetry.mozilla.org].* Different datasets are available for SQL queries in [https://sql.telemetry.mozilla.org/ our re:dash instance]. ==Documentation=====For Firefox Devs=== ====Telemetry talks:====* [https://air.mozilla.org/roberto-vitillo-telemetry-and-other-data-sources/ Telemetry Onboarding]* [https://air.mozilla.org/azhang/ Zen and more information, see the Art of Telemetry] ====Telemetry client-side:====* [https://developerdocs.mozilla.org/en-US/docs/Performance/Adding_a_new_Telemetry_probe MDN: Adding a new Telemetry probe]** [https://telemetry.mozilla.org/histogram-simulator Histogram Simulator]** [[Firefox/Data_Collection|Data collection policy]]* [https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/telemetry/index.html Telemetry ping format (in-tree documentation)]** [https://github.com/mozilla/telemetry-server/blob/master/docs/PayloadFormat.md Older ping formats]* [https://docs.google.com/document/d/11wM2RJkHAqYF-4xgL5tHwA621IUQEaf4vecuC-hqnzk/edit#heading=h.tkrw9ahjfrcp Adding a new Telemetry ping type]** Known Telemetry ping types: [[Telemetry/PingTypes]]* [[Telemetry/Experiments|Telemetry Experiments]] ====Telemetry back-end:====* Data Pipeline Documentation : [[CloudServices/DataPipeline]] ====Telemetry Aggregates:====* [https://anthony-zhang.me/blog/telemetry-demystified/ Telemetry aggregation pipeline]* [https://github.com/mozilla/telemetry-dashboard/blob/gh-pages/v2/doc.md telemetry.js]* [https://chuttenblog.wordpress.com/2015/12/01/to-order-telemetry-dashboards-dashboard-generator/ Dashboard Generator] ====Analyzing Telemetry:====* [https://mozilla.github.io/firefox-data-docs/concepts/choosing_a_dataset.html Choosing a Dataset]* Writing custom analyses:** [https://gist.github.com/trink/bf7d6e504b3fd937b73095412612ae5a Writing custom real-time analysis with Hindsight]** [[Telemetry/Custom analysis with spark|Writing custom analysis jobs with Spark]]** [https://wiki.mozilla.org/Telemetry/Custom_dashboards_with_re:dash Custom dashboards with re:dash]** [https://mozilla.github.io/firefox-data-docs/cookbooks/longitudinal_examples.html Working with the longitudinal dataset]** [[Telemetry/Quirks|Telemetry Quirks: things to watch out for when analyzing Telemetry data]] ====Telemetry status:====* [[Telemetry/Errata|Telemetry Errata: outages & known issues with collected Telemetry data]]* [https://twitter.com/MozTelemetry Telemetry Twitter account]* [http://ec2-50-112-66-71.us-west-2.compute.amazonaws.com:4352/# Heka dashboard showing Telemetry health], in particular the page showing [http://ec2-50-112-66-71.us-west-2.compute.amazonaws.com:4352/#sandboxes/TelemetryChannelMetrics60DaysAggregator/outputs/TelemetryChannelMetrics60DaysAggregator.nightly.cbuf submission rates & sizes] ===For Firefox Users===* [https://support.mozilla.org/kb/send-performance-data-improve-firefox Mozilla Support: Send performance data to Mozilla to help improve Firefox]* [https://support.mozilla.org/kb/how-can-i-help-submitting-mobile-performance-data Mozilla Support: How can I help by submitting mobile performance data?]* [[Telemetry/FAQ|Telemetry and User Control: FAQ]] == Filing Bugs ==Telemetry client (in product) bugs should be filed in [https://bugzilla.mozilla.org/enter_bug.cgi?product=Toolkit&component=Telemetry Toolkit::Telemetry]. Data Pipeline related bugs should be filed in one of the components in [https://bugzilla.mozilla.org/describecomponents.cgi?product=Data%20Platform%20and%20Tools Data Platform and Tools] Telemetry dashboard bugs should be filed in [https://bugzilla.mozilla.org/enter_bug.cgi?product=Webtools&component=Telemetry%20Dashboard Webtools::Telemetry Dashboard] == Tracking Bugs ==Open Telemetry bugs are usually organized as a blocker for one of the following tracking bugs:* [https://bugzilla.mozilla.org/show_bug.cgi?id=1121467 Desired Telemetry measurements / probes]* [https://bugzilla.mozilla.org/show_bug.cgi?id=1105864 Telemetry data quality issues]* [https://bugzilla.mozilla.org/show_bug.cgi?id=1210637 Tracking for desired Telemetry dashboards]* [https://bugzilla.mozilla.org/show_bug.cgi?id=1201022 Telemetry cleanup work]* [https://bugzilla.mozilla.org/show_bug.cgi?id=1220718 Telemetry ping size issues]* [https://bugzilla.mozilla.org/show_bug.cgi?id=1226137 Tracking about:telemetry work and improvements] ==Communication=={| class="wikitable fullwidth-table" ! Communication Type !! Mechanism !! Audience |- | Asking questions|| #telemetry on [https://wiki.mozilla.org/IRC irc.mozilla.org] || devs |- | General discussion || [https://lists.mozilla.org/listinfo/dev-platform dev-platform] and [https://mail.mozilla.org/listinfo/fx-data-dev fx-data-dev] list || devs |- | Announcements || [https://lists.mozilla.org/listinfo/dev-platform dev-platform], [https://lists.mozilla.org/listinfo/dev-planning dev-planning] lists || all|}
