4.8 KiB
Firefox Data Documentation
This document will teach you how to use Firefox data to answer questions about our users. The source for this documentation can be found in this repo.
Using this document
This documentation is divided into four main sections:
Getting Started
This section provides a quick introduction to analyzing telemetry data. After reading these articles, you will be able to confidently perform analysis over telemetry data.
Data Collection and Datasets
Describes all available data we have on our users. 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.
Tools
Describes the tools we maintain to access and analyze user data. For each tool we include a description of the purpose, relative strengths and weaknesses, and what data you can access from the tool.
Cookbooks & Tutorials
This section contains tutorials presented in a simple problem/solution format.
Missing Documentation
We're writing documentation as fast as we can, but there's always going to be confusing or missing documentation. If you can't find what you need, please file a bug.
Reporting a problem
If you have a problem with data tools, datasets, or other pieces of infrastructure, please help us out by reporting it.
Most of our work is tracked in Bugzilla in the Data Platform and Tools product.
Bugs should be filed in the closest-matching component in the Data Platform and Tools product, but if there is no component for the item in question, please file an issue in the General component.
Components are triaged at least weekly by the component owner(s). For issues needing
urgent attention, it is recommended that you use the needinfo flag to attract attention
from a specific person. If an issue doesn't receive the appropriate attention within a
week, you can send email to the fx-data-dev mailing list or reach out on IRC
in #datapipeline.
When a bug is triaged, it will be assigned a priority and points. Priorities have the following meanings:
- P1: in active development in the current sprint
- P2: planned to be worked on in the current quarter
- P3: planned to be worked on next quarter
- P4 and beyond: nice to have, we would accept a patch, but not actively being worked on.
Points reflect the amount of effort required for a bug and are assigned as follows:
- 1 point: one day or less of effort
- 2 points: two days of effort
- 3 points: three days to a week of effort
- 5 points or more: SO MUCH EFFORT, major project.
Problems with the data
There are bugzilla components for several of core datasets described in this documentation, so if possible, please use a specific component.
If there is a problem with a dataset that does not have its own component, please file an issue in the Datasets: General component.
Problems with tools
There are bugzilla components for several of the tools that comprise the Data Platform, so please file a bug in the specific component that most closely matches the tool in question.
Operational bugs, such as services being unavailable, should be filed either in the component for the service itself or in the Operations component.
Other problems
When in doubt, please file issues in the General component.