From 36d22d82aa202bb199967e9512281e9a53db42c9 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 21:33:14 +0200 Subject: Adding upstream version 115.7.0esr. Signed-off-by: Daniel Baumann --- .../components/telemetry/docs/internals/index.rst | 25 ++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 toolkit/components/telemetry/docs/internals/index.rst (limited to 'toolkit/components/telemetry/docs/internals/index.rst') diff --git a/toolkit/components/telemetry/docs/internals/index.rst b/toolkit/components/telemetry/docs/internals/index.rst new file mode 100644 index 0000000000..78679bda0d --- /dev/null +++ b/toolkit/components/telemetry/docs/internals/index.rst @@ -0,0 +1,25 @@ +========= +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 + +More details on different topics can be found in these chapters: + +.. toctree:: + :maxdepth: 2 + :titlesonly: + :glob: + + ** -- cgit v1.2.3