services/docs/datareporting.rst
author Robert Strong <robert.bugzilla@gmail.com>
Mon, 02 Mar 2015 11:02:26 -0800
changeset 245435 3cd0f44138dab909efb4f3e14785c6d4ddd75762
parent 177095 95c9865ac36688fb99013c8b0adf5d38e3d8612e
permissions -rw-r--r--
Bug 1044443 - release off main thread crash in nsXPCWrappedJS::Release() via nsUpdateProcessor::~nsUpdateProcessor(). r=bbondy, a=sledru

.. _data_reporting_service:

======================
Data Reporting Service
======================

``/services/datareporting`` contains files related to an XPCOM service
that collects and reports data within Gecko applications.

The important files in this directory are:

DataReportingService.js
   An XPCOM service that coordinates collection and reporting of data.

policy.jsm
   A module containing the logic for coordinating and driving collection
   and upload of data.

sessions.jsm
   Records Gecko application session history. This is loaded as part of
   the XPCOM service because it needs to capture state from very early in
   the application lifecycle. Bug 841561 tracks implementing this in C++.

There is other code in the tree that collects and uploads data. The
original intent of this directory and XPCOM service was to serve as a
focal point for the coordination of all this activity so that it could
all be done consistently and properly. This vision may or may not be fully
realized.