Bug 1510566 - Document that use counters are enabled on release r=chutten
authorJan-Erik Rediger <jrediger@mozilla.com>
Wed, 16 Jan 2019 16:59:40 +0000
changeset 514099 7db49cc01bb7e20dc4bdb6d1a1e6a5663aa9ba98
parent 514098 7f25f8bee25bcd1f5da9ef7cc8c4026560f9d356
child 514100 3e12097e2b601e2dd06b868e98bf7167c6c6aa94
push id1953
push userffxbld-merge
push dateMon, 11 Mar 2019 12:10:20 +0000
treeherdermozilla-release@9c35dcbaa899 [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewerschutten
bugs1510566
milestone66.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
Bug 1510566 - Document that use counters are enabled on release r=chutten Differential Revision: https://phabricator.services.mozilla.com/D16715
toolkit/components/telemetry/docs/collection/use-counters.rst
--- a/toolkit/components/telemetry/docs/collection/use-counters.rst
+++ b/toolkit/components/telemetry/docs/collection/use-counters.rst
@@ -3,16 +3,18 @@ Use Counters
 ============
 
 Use counters are used to report Telemetry statistics on whether individual documents
 use a given WebIDL method or attribute (getters and setters are reported separately), CSS
 property, or deprecated DOM operation.  Custom use counters can also be
 defined to test frequency of things that don't fall into one of those
 categories.
 
+As of Firefox 65 the collection of Use Counters is enabled on all channels.
+
 The API
 =======
 The process to add a new use counter is different depending on the type feature that needs
 to be measured. In general, for each defined use counter, two separate boolean histograms are generated:
 
 - one describes the use of the tracked feature for individual documents and has the ``_DOCUMENT`` suffix;
 - the other describes the use of the same thing for top-level pages (basically what we think of as a *web page*) and has the ``_PAGE`` suffix.
 
@@ -90,8 +92,15 @@ The values accumulated within a use coun
 and the related use counters below tell us how many pages did *not* use the feature in question.
 For instance, if we see that a given session has destroyed 30 content documents, but a
 particular use counter shows only a count of 5, we can infer that the use counter was *not*
 used in 25 of those 30 documents.
 
 Things are done this way, rather than accumulating a boolean flag for each use counter,
 to avoid sending histograms for features that don't get widely used. Doing things in this
 fashion means smaller telemetry payloads and faster processing on the server side.
+
+Version History
+---------------
+
+- Firefox 65:
+
+  - Enable Use Counters on release channel (`bug 1477433 <https://bugzilla.mozilla.org/show_bug.cgi?id=1477433>`_)