This document describes how the data pipeline normalizes channel information sent by Firefox and makes it accessible to data consumers.
What are Firefox channels?
In addition to the the
release channel, which is what we ship to most users,
we also ship development versions of Firefox and an "extended support" (
The full list is:
dev-edition, and is just a beta repack)
For more information on this topic, see the Firefox Release Process page.
App Update Channel
This is the channel reported by Firefox. This could really be anything, but is usually one of the expected release channels listed above.
For BigQuery tables corresponding to Telemetry Ping types, such as
the field here is called
app_update_channel and is found in
metadata.uri. For example:
SELECT metadata.uri.app_update_channel FROM telemetry.main WHERE DATE(submission_timestamp) = '2019-09-01' LIMIT 10
This field is a normalization of the directly reported channel, and replaces unusual
and unexpected values with the string
There are a couple of exceptions, notably that variations on
See the relevant code here.
Normalized channel is available in the Telemetry Ping tables as a top-level field
SELECT normalized_channel FROM telemetry.crash WHERE DATE(submission_timestamp) = '2019-09-01' LIMIT 10