michael@0: .. _data_reporting_service:
michael@0: 
michael@0: ======================
michael@0: Data Reporting Service
michael@0: ======================
michael@0: 
michael@0: ``/services/datareporting`` contains files related to an XPCOM service
michael@0: that collects and reports data within Gecko applications.
michael@0: 
michael@0: The important files in this directory are:
michael@0: 
michael@0: DataReportingService.js
michael@0:    An XPCOM service that coordinates collection and reporting of data.
michael@0: 
michael@0: policy.jsm
michael@0:    A module containing the logic for coordinating and driving collection
michael@0:    and upload of data.
michael@0: 
michael@0: sessions.jsm
michael@0:    Records Gecko application session history. This is loaded as part of
michael@0:    the XPCOM service because it needs to capture state from very early in
michael@0:    the application lifecycle. Bug 841561 tracks implementing this in C++.
michael@0: 
michael@0: There is other code in the tree that collects and uploads data. The
michael@0: original intent of this directory and XPCOM service was to serve as a
michael@0: focal point for the coordination of all this activity so that it could
michael@0: all be done consistently and properly. This vision may or may not be fully
michael@0: realized.