gecko-dev/toolkit/components/telemetry/docs/internals/index.rst
Simon Friedberger e74c38214d Bug 1768617 - Add additional documentation about telemetry components. r=janerik,chutten DONTBUILD
Adds a bit of overview information about telemetry components and about desktop telemetry code modules.

Differential Revision: https://phabricator.services.mozilla.com/D145954
2022-05-13 13:49:46 +00:00

25 lines
1.1 KiB
ReStructuredText

=========
Internals
=========
Here is a quick overview of the most important code parts. They can be found in the telemetry folder.
* TelemetryController: Main telemetry logic, e.g. assembling pings, local storage (when archiving is enabled), preference changes, testing
* Telemetry.cpp contains most of the public interface, implements the IDL
* The different data types for telemetry are handled in TelemetryHistogram, TelemetryScalar, TelemetryEvent.
* TelemetryEnvironment: A helper for gathering environment data, like build version or graphics data
* TelemetryScheduler: Starts regular jobs for collecting and sending data
* TelemetrySend: Sending and caching of pings
* TelemetryStorage: Handles writing pings to disk for TelemetrySend
* TelemetrySession: Collects data for a browsing session, includes many of the most important probes (aka metrics)
* Policy: A layer of indirection added to provide testability. A common pattern in many files
* pings/: Contains definitions and handling for most ping types, like EventPing or PrioPing
More details on different topics can be found in these chapters:
.. toctree::
:maxdepth: 2
:titlesonly:
:glob:
**