Source code
Revision control
Copy as Markdown
Other Tools
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
---
$tags:
- 'Firefox :: Search'
search.engine.default:
engine_id:
type: string
description: |
Deprecated in Fx139, please use provider_id, partner_code,
overridden_by_third_party and display_name instead.
The telemetry id of the search engine.
For example: "engine1"
For application-provided engines, this is the identifier plus telemetry
suffix supplied by the configuration.
For other engines, this is `other-<engineName>`.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
- 'newtab'
provider_id:
type: string
description: |
The identifier of the user's default search engine if the search engine is
an application provided engine. For user installed engines, this value will
be `other`.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
- 'newtab'
partner_code:
type: string
description: |
The partner code of the user's default search engine, if defined/known,
that is being used for the search. Not all search engines have partner
codes.
May be empty for engines that are overridden by a third-party add-on or
OpenSearch engine.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
- 'newtab'
overridden_by_third_party:
type: boolean
description: |
Set to true if the user's default search engine has been allowed to be
overridden by a third-party add-on or OpenSearch engine.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
- 'newtab'
display_name:
type: string
description: |
The display name of the user's default engine.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
load_path:
type: string
description: |
A path relating to where the search engine was installed/loaded from.
For example:
`[app]appDefault` for an app-provided engine.
`[addon]<extension id>` for a WebExtension-based engine.
`[https]developer.mozilla.org/mdn-web-docs.xml` for an OpenSearch-based
engine.
`[policy]` for an enteprise policy engine.
`[user]` for a search engine defined by the user or generated from a
web page.
Note: this metric is truncated at 100 characters.
bugs:
data_reviews:
data_sensitivity:
- web_activity
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
submission_url:
type: url
description: |
The submission URL of the default engine. This is only reported in the
cases where:
The engine is an application provided engine.
The engine has the same name as an application provided engine.
The engine matches one of a specific list of well known search engines.
bugs:
data_reviews:
data_sensitivity:
- web_activity
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
changed:
type: event
description: |
Recorded when the default search engine is changed.
bugs:
data_reviews:
data_sensitivity:
- web_activity
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
extra_keys:
previous_engine_id:
type: string
description: The id of the previous default engine.
new_engine_id:
type: string
description: The id of the new default engine.
new_display_name:
type: string
description: The display name of the new default engine.
new_load_path:
type: string
description: |
The path relating to where the new default engine was installed/loaded
from.
new_submission_url:
type: string
description: |
The new submission URL of the new default engine. This is
limited to 100 characters.
change_reason:
type: string
description: |
The reason for the change of engine. For possible values,
see `REASON_CHANGE_MAP` in
This was renamed from change_source to change_reason in Fx 139.
search.engine.private:
engine_id:
type: string
description: |
Deprecated in Fx139, please use provider_id, partner_code,
overridden_by_third_party and display_name instead.
The telemetry id of the search engine.
For example: "engine1"
For application-provided engines, this is the identifier plus telemetry
suffix supplied by the configuration.
For other engines, this is `other-<engineName>`.
If this string is an empty string (`""`), this means that one or both of
the preferences `browser.search.separatePrivateDefault` and
`browser.search.separatePrivateDefault.ui.enabled` are set to false.
It is possible that the user selects the same private engine as for the
default engine, and hence both versions of these fields will be filled in.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
- 'newtab'
provider_id:
type: string
description: |
The identifier of the user's default search engine if the search engine is
an application provided engine. For user installed engines, this value will
be `other`.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
- 'newtab'
partner_code:
type: string
description: |
The partner code of the user's default search engine, if defined/known,
that is being used for the search. Not all search engines have partner
codes.
May be empty for engines that are overridden by a third-party add-on or
OpenSearch engine.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
- 'newtab'
overridden_by_third_party:
type: boolean
description: |
Set to true if the user's default search engine has been allowed to be
overridden by a third-party add-on or OpenSearch engine.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
- 'newtab'
display_name:
type: string
description: |
The display name of the user's default engine.
If this string is an empty string (`""`), this means that one or both of
the preferences `browser.search.separatePrivateDefault` and
`browser.search.separatePrivateDefault.ui.enabled` are set to false.
It is possible that the user selects the same private engine as for the
default engine, and hence both versions of these fields will be filled in.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
load_path:
type: string
description: |
A path relating to where the search engine was installed/loaded from.
For example:
`[app]appDefault` for an app-provided engine.
`[addon]<extension id>` for a WebExtension-based engine.
`[https]developer.mozilla.org/mdn-web-docs.xml` for an OpenSearch-based
engine.
`[policy]` for an enteprise policy engine.
`[user]` for a search engine defined by the user or generated from a
web page.
Note: this metric is truncated at 100 characters.
If this string is an empty string (`""`), this means that one or both of
the preferences `browser.search.separatePrivateDefault` and
`browser.search.separatePrivateDefault.ui.enabled` are set to false.
It is possible that the user selects the same private engine as for the
default engine, and hence both versions of these fields will be filled in.
bugs:
data_reviews:
data_sensitivity:
- web_activity
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
submission_url:
type: url
description: |
The submission URL of the default engine. This is only reported in the
cases where:
The engine is an application provided engine.
The engine has the same name as an application provided engine.
The engine matches one of a specific list of well known search engines.
If this string is an empty string (`""`), this means that one or both of
the preferences `browser.search.separatePrivateDefault` and
`browser.search.separatePrivateDefault.ui.enabled` are set to false.
It is possible that the user selects the same private engine as for the
default engine, and hence both versions of these fields will be filled in.
bugs:
data_reviews:
data_sensitivity:
- web_activity
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
lifetime: application
send_in_pings:
- 'metrics'
changed:
type: event
description: |
Recorded when the default search engine is changed
bugs:
data_reviews:
data_sensitivity:
- web_activity
notification_emails:
- fx-search-telemetry@mozilla.com
- rev-data@mozilla.com
expires: never
extra_keys:
previous_engine_id:
type: string
description: The id of the previous default engine.
new_engine_id:
type: string
description: The id of the new default engine.
new_display_name:
type: string
description: The display name of the new default engine.
new_load_path:
type: string
description: |
The path relating to where the new default engine was installed/loaded
from.
new_submission_url:
type: string
description: |
The new submission URL of the new default engine. This is
limited to 100 characters.
change_reason:
type: string
description: |
The reason for the change of engine. For possible values,
see `REASON_CHANGE_MAP` in
This was renamed from change_source to change_reason in Fx 139.
search.service:
startup_time:
type: timing_distribution
time_unit: nanosecond
description: |
The time duration it takes for the search service to start up.
bugs:
data_reviews:
notification_emails:
- fx-search-telemetry@mozilla.com
data_sensitivity:
- technical
expires: never
initialization_status:
type: labeled_counter
description: |
Counts the type of initialization statuses on start up.
failedSettings - failed loading and migrating the search settings file.
failedFetchEngines - failed to load or parse the configuration from remote
settings.
failedLoadEngines - failed to create all the search engines from the
configuration or user installed engines.
failedLoadSettingsAddonManager - the addon manager ready promise was rejected. (from FF135)
settingsCorrupt - the search settings were reset because of an exception, but
the search service still finished initializing. (from FF136)
success - search service successfully initialized.
bugs:
data_reviews:
notification_emails:
- fx-search-telemetry@mozilla.com
data_sensitivity:
- technical
expires: never
labels:
- failedSettings
- failedFetchEngines
- failedLoadEngines
- failedLoadSettingsAddonManager
- settingsCorrupt
- success
browser.searchinit:
engine_invalid_webextension:
type: labeled_quantity
description: >
Records the WebExtension ID of a search engine where the
WebExtension is not installed (= 1), disabled (= 2), search engine
no longer specified (= 4), a different name (= 5), where the
submission URL is different between the search engine and the
WebExtension (= 6). The value '3' has been replaced by '6' to
distinguish newer entries.
This metric was generated to correspond to the Legacy Telemetry
scalar browser.searchinit.engine_invalid_webextension, which was removed
in Fx 139.
bugs:
data_reviews:
notification_emails:
- fx-search-telemetry@mozilla.com
- mbanner@mozilla.com
expires: 147
unit: custom enum value
secure_opensearch_engine_count:
type: quantity
description: >
Records the number of secure (i.e., using https) OpenSearch search
engines a given user has installed.
This metric was generated to correspond to the Legacy Telemetry
scalar browser.searchinit.secure_opensearch_engine_count.
bugs:
data_reviews:
notification_emails:
- fx-search-telemetry@mozilla.com
expires: 145
unit: engines
telemetry_mirror: BROWSER_SEARCHINIT_SECURE_OPENSEARCH_ENGINE_COUNT
insecure_opensearch_engine_count:
type: quantity
description: >
Records the number of insecure (i.e., using http) OpenSearch search
engines a given user has installed.
This metric was generated to correspond to the Legacy Telemetry
scalar browser.searchinit.insecure_opensearch_engine_count.
bugs:
data_reviews:
notification_emails:
- fx-search-telemetry@mozilla.com
expires: 145
unit: engines
telemetry_mirror: BROWSER_SEARCHINIT_INSECURE_OPENSEARCH_ENGINE_COUNT
secure_opensearch_update_count:
type: quantity
description: >
Records the number of OpenSearch search engines with secure updates
enabled (i.e., using https) a given user has installed.
This metric was generated to correspond to the Legacy Telemetry
scalar browser.searchinit.secure_opensearch_update_count.
bugs:
data_reviews:
notification_emails:
- fx-search-telemetry@mozilla.com
expires: 145
unit: updates
telemetry_mirror: BROWSER_SEARCHINIT_SECURE_OPENSEARCH_UPDATE_COUNT
insecure_opensearch_update_count:
type: quantity
description: >
Records the number of OpenSearch search engines with insecure
updates enabled (i.e., using http) a given user has installed.
This metric was generated to correspond to the Legacy Telemetry
scalar browser.searchinit.insecure_opensearch_update_count.
bugs:
data_reviews:
notification_emails:
- fx-search-telemetry@mozilla.com
expires: 145
unit: updates
telemetry_mirror: BROWSER_SEARCHINIT_INSECURE_OPENSEARCH_UPDATE_COUNT
search:
suggestions_latency:
type: labeled_timing_distribution
description: >
Records the latencies (ms) of search suggestions fetches per search
engine. Keys in this histogram are search engine identifiers for built-in
search engines and 'other' for non-built-in search engines.
This metric was generated to correspond to the Legacy Telemetry
exponential histogram SEARCH_SUGGESTIONS_LATENCY_MS.
time_unit: millisecond
bugs:
data_reviews:
notification_emails:
- fx-search-telemetry@mozilla.com
- adw@mozilla.com
expires: never
telemetry_mirror: SEARCH_SUGGESTIONS_LATENCY_MS
search.suggestions:
successful_requests:
type: labeled_counter
description: >
Counts the number of successful search suggestion fetches per search
engine. Only records app provided engines using their short IDs
('id', not 'identifier') as labels.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
expires: 146
aborted_requests:
type: labeled_counter
description: >
Counts the number of aborted search suggestion fetches per search
engine. Only records app provided engines using their short IDs
('id', not 'identifier') as labels.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
expires: 146
failed_requests:
type: labeled_counter
description: >
Counts the number of failed search suggestion fetches per search
engine. Only records app provided engines using their short IDs
('id', not 'identifier') as labels.
bugs:
data_reviews:
data_sensitivity:
- interaction
notification_emails:
- fx-search-telemetry@mozilla.com
expires: 146