mirror of
https://github.com/mozilla/gecko-dev.git
synced 2025-11-12 14:20:14 +02:00
31 lines
1.2 KiB
ReStructuredText
31 lines
1.2 KiB
ReStructuredText
===============
|
|
Data collection
|
|
===============
|
|
|
|
There are different APIs and formats to collect data in Firefox, all suiting different use cases.
|
|
|
|
In general, we aim to submit data in a common format where possible. This has several advantages; from common code and tooling to sharing analysis know-how.
|
|
|
|
In cases where this isn't possible and more flexibility is needed, we can submit custom pings or consider adding different data formats to existing pings.
|
|
|
|
*Note:* Every new data collection must go through a `data collection review <https://wiki.mozilla.org/Firefox/Data_Collection>`_.
|
|
|
|
The current data collection possibilities include:
|
|
|
|
* :doc:`scalars` allow recording of a single value (string, boolean, a number)
|
|
* :doc:`histograms` can efficiently record multiple data points
|
|
* ``environment`` data records information about the system and settings a session occurs in
|
|
* ``TelemetryLog`` allows collecting ordered event entries (note: this does not have supporting analysis tools)
|
|
* :doc:`measuring elapsed time <measuring-time>`
|
|
* :doc:`custom pings <custom-pings>`
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:titlesonly:
|
|
:hidden:
|
|
:glob:
|
|
|
|
scalars
|
|
histograms
|
|
measuring-time
|
|
custom-pings
|