Mozilla Data Documentation
This documentation was written to help Mozillians analyze and interpret data collected by our products, such as Firefox and Mozilla VPN. Mozilla refers to the systems that collect and process this data as Telemetry.
If there's information missing from these docs, or if you'd like to contribute, see this article on contributing, and feel free to file a bug here.
You can locate the source for this documentation in the data-docs repository on GitHub.
Using this document
This documentation is divided into the following sections:
This section provides a quick introduction to Mozilla's Telemetry data: it should help you understand how this data is collected and how to begin analyzing it.
Cookbooks & Tutorials
This section contains tutorials presented in a simple problem/solution format, organized by topic.
Data Platform Reference
This section contains detailed reference material on the Mozilla data platform, including links to other resources where appropriate.
In-depth references for some of the major datasets we maintain for our products.
For each dataset, we include a description of the dataset's purpose, what data is included, how the data is collected, and how you can change or augment the dataset. You do not need to read this section end-to-end.
This section contains some documentation of things that used to be part of the Mozilla Data Platform, but are no longer. You can generally ignore this section, it is intended only to answer questions like "what happened to X?".
You can find the fully-rendered documentation here, rendered with mdBook, and hosted on Github pages.