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.
The current data collection possibilities include:
- Scalars allow recording of a single value (string, boolean, a number)
- Histograms can efficiently record multiple data points
environmentdata records information about the system and settings a session occurs in
- Events can record richer data on individual occurences of specific actions
TelemetryLogallows collecting ordered event entries up to a limit of 1000 entries (note: this does not have supporting analysis tools)
- measuring elapsed time
- custom pings
- stack capture allow recording application call stacks
- Use counters measure the usage of web platform features
- Experiment annotations