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 --- toolkit/components/telemetry/docs/start/index.rst | 28 +++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 toolkit/components/telemetry/docs/start/index.rst (limited to 'toolkit/components/telemetry/docs/start/index.rst') diff --git a/toolkit/components/telemetry/docs/start/index.rst b/toolkit/components/telemetry/docs/start/index.rst new file mode 100644 index 0000000000..9cc544c9a3 --- /dev/null +++ b/toolkit/components/telemetry/docs/start/index.rst @@ -0,0 +1,28 @@ +=============== +Getting started +=============== + +If you are interested in extending data collection by adding new probes have a look at + +.. toctree:: + :maxdepth: 2 + :titlesonly: + :glob: + + adding-a-new-probe + report-gecko-telemetry-in-glean + +If you want to work with the telemetry code itself, for example to fix a bug, it is often helpful to start with these steps: + +1. Have a look at about:telemetry to see which data is being collected and sent. +2. Increase the log level in about:config by setting toolkit.telemetry.log.level to Debug or Trace. This will show telemetry information in the browser console. To enable the browser console follow `these instructions <../../../../devtools-user/browser_console/index.html>`__. +3. Run a local telemetry receiver, e.g. `this one `__ and set ``toolkit.telemetry.server`` to “localhost” (Like the next preference this needs a restart.) +4. Set ``toolkit.telemetry.send.overrideOfficialCheck = true``, otherwise local debug builds will not send telemetry data. (Requires restart.) + +More information about the internals can be found `here <../internals/index.html>`__. + +Further Reading +############### + +* `Telemetry Portal `_ - Discover all important resources for working with data +* `Telemetry Data Documentation `_ - Find what data is available & how to use it -- cgit v1.2.3