Expand description
Manage recording sync telemetry. Assumes some external telemetry library/code which manages submitting.
Structs§
- Engine
- One engine’s sync.
- Engine
Incoming - Incoming record for an engine’s sync
- Engine
Outgoing - Outgoing record for an engine’s sync.
- Event
- A generic “Event” - suitable for all kinds of pings (although this module only cares about the sync ping)
- Problem
- Sync
Telemetry - A single sync. May have many engines, may have its own failure.
- Sync
Telemetry Ping - The Sync ping payload, as documented at https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/telemetry/data/sync-ping.html. May have many syncs, may have many events. However, due to the architecture of apps which use these components, this payload is almost certainly not suitable for submitting directly. For example, we will always return a payload with exactly 1 sync, and it will not know certain other fields in the payload, such as the hashed FxA device ID (see https://searchfox.org/mozilla-central/rev/c3ebaf6de2d481c262c04bb9657eaf76bf47e2ac/services/sync/modules/browserid_identity.js#185 for an example of how the device ID is constructed). The intention is that consumers of this will use this to create a “real” payload - eg, accumulating until some threshold number of syncs is reached, and contributing additional data which only the consumer knows.
- Validation
Enums§
- Sync
Failure - A Sync failure.