1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
Telemetry
=========
This document describes search telemetry recorded by Toolkit such as search
service telemetry and telemetry related to fetching search suggestions.
This document only covers Legacy telemetry, not Glean telemetry.
Glean metrics are self-documenting and can be looked up in the Glean dictionary.
Other important search-related telemetry is recorded by Firefox and is
documented in :doc:`/browser/search/telemetry` in the Firefox documentation.
Legacy Telemetry
----------------
Scalars
-------
browser.searchinit.secure_opensearch_engine_count
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
NOTE: This telemetry is no longer reported to legacy Telemetry. See changelog
below.
Records the number of secure (i.e., using https) OpenSearch search
engines a given user has installed.
Changelog
Firefox 144
Legacy ``browser.searchinit.secure_opensearch_engine_count`` telemetry
removed completely. (See bug 1984462)
browser.searchinit.insecure_opensearch_engine_count
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
NOTE: This telemetry is no longer reported to legacy Telemetry. See changelog
below.
Records the number of insecure (i.e., using http) OpenSearch search
engines a given user has installed.
Changelog
Firefox 144
Legacy ``browser.searchinit.insecure_opensearch_engine_count`` telemetry
removed completely. (See bug 1984462)
browser.searchinit.secure_opensearch_update_count
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
NOTE: This telemetry is no longer reported to legacy Telemetry. See changelog
below.
Records the number of OpenSearch search engines with secure updates
enabled (i.e., using https) a given user has installed.
Changelog
Firefox 144
Legacy ``browser.searchinit.secure_opensearch_update_count`` telemetry
removed completely. (See bug 1984462)
browser.searchinit.insecure_opensearch_update_count
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
NOTE: This telemetry is no longer reported to legacy Telemetry. See changelog
below.
Records the number of OpenSearch search engines with insecure updates
enabled (i.e., using http) a given user has installed.
Changelog
Firefox 144
Legacy ``browser.searchinit.insecure_opensearch_update_count`` telemetry
removed completely. (See bug 1984462)
Keyed Scalars
-------------
browser.searchinit.engine_invalid_webextension
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
NOTE: This telemetry is no longer reported to legacy Telemetry. See changelog
below.
Records the WebExtension ID of a search engine where the saved search engine
settings do not match the WebExtension.
The keys are the WebExtension IDs. The values are integers:
1. Associated WebExtension is not installed.
2. Associated WebExtension is disabled.
3. The submission URL of the associated WebExtension is different to that of the saved settings.
Changelog
Firefox 134
Legacy ``browser.searchinit.engine_invalid_webextension`` telemetry
mirrored to Glean. (See bug 1927093)
Firefox 139
Legacy ``browser.searchinit.engine_invalid_webextension`` telemetry
removed completely. (See bug 1958170)
Histograms
----------
SEARCH_SUGGESTIONS_LATENCY_MS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This histogram records the latency in milliseconds of fetches to the
suggestions endpoints of search engines, or in other words, the time from
Firefox's request to a suggestions endpoint to the time Firefox receives a
response. It is a keyed exponential histogram with 50 buckets and values
between 0 and 30000 (0s and 30s). Keys in this histogram are search engine IDs
for built-in search engines and 'other' for non-built-in search engines.
Default Search Engine
~~~~~~~~~~~~~~~~~~~~~
Telemetry for the user's default search engine is currently reported via two
systems:
1. Legacy telemetry:
`Fields are reported within the legacy telemetry environment <https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/data/environment.html#defaultsearchengine>`__
2. Glean:
`Fields are documented in the Glean dictionary <https://dictionary.telemetry.mozilla.org/apps/firefox_desktop?search=search.engine>`__.
Glean Telemetry
---------------
`These search service fields are documented via Glean dictionary <https://dictionary.telemetry.mozilla.org/apps/firefox_desktop?search=tags%3A%22Firefox%20%3A%3A%20Search%22>`__.
search.service.startup_time
~~~~~~~~~~~~~~~~~~~~~~~~~~~
The time duration it takes for the search service to start up.
search.service.initializationStatus
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A labeled counter for the type of initialization statuses that can occur on
start up. Labels include: ``failedSettings``, ``failedFetchEngines``,
``failedLoadEngines``, ``failedLoadSettingsAddonManager``, ``settingsCorrupt``,
``success``.
A counter for initialization successes on start up.
search.suggestions.latency
~~~~~~~~~~~~~~~~~~~~~~~~~~
A labelled timing distribution that records the latencies (ms) of search
suggestions fetches per search engine. Keys in this histogram are the search
engine identifier for configuration provided search engines and 'other' for
search engines installed via other methods.
|
