Adding upstream version 124.0.1.upstream/124.0.1

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 527 insertions, 0 deletions

diff --git a/toolkit/mozapps/extensions/metrics.yaml b/toolkit/mozapps/extensions/metrics.yaml
new file mode 100644
index 0000000000..d5935ae436
--- /dev/null
+++ b/toolkit/mozapps/extensions/metrics.yaml
@@ -0,0 +1,527 @@
+# 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
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+# Adding a new metric? We have docs for that!
+# https://firefox-source-docs.mozilla.org/toolkit/components/glean/user/new_definitions_file.html
+
+---
+$schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
+$tags:
+    - 'Toolkit :: Add-ons Manager'
+
+addons_manager:
+    install: &install_update_event
+        type: event
+        description: |
+            These events are recorded during the install and update flow for
+            extensions and themes.
+        bugs:
+            - https://bugzilla.mozilla.org/1433335
+            - https://bugzilla.mozilla.org/1515697
+            - https://bugzilla.mozilla.org/1523641
+            - https://bugzilla.mozilla.org/1549770
+            - https://bugzilla.mozilla.org/1590736
+            - https://bugzilla.mozilla.org/1630596
+            - https://bugzilla.mozilla.org/1672570
+            - https://bugzilla.mozilla.org/1714251
+            - https://bugzilla.mozilla.org/1749878
+            - https://bugzilla.mozilla.org/1781974
+            - https://bugzilla.mozilla.org/1817100
+            - https://bugzilla.mozilla.org/1820153
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820153#c3
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+        extra_keys:
+            addon_id:
+                description: Id of the addon (when available).
+                type: string
+            addon_type:
+                description: |
+                    Addon type, one of: extension, theme, locale, dictionary,
+                    sitepermission, siteperm_deprecated, other, unknown.
+                type: string
+            install_id:
+                description: |
+                    Shared by events related to the same install or update flow.
+                type: string
+            download_time:
+                description: The number of ms needed to complete the download.
+                type: quantity
+            error:
+                description: |
+                    The AddonManager error related to an install or update failure.
+                type: string
+            source:
+                description: |
+                    The source that originally triggered the installation, one
+                    of: "about:addons", "about:debugging", "about:preferences",
+                    "amo", "browser-import", "disco", "distribution",
+                    "extension", "enterprise-policy", "file-url",
+                    "geckoview-app", "gmp-plugin", "internal", "plugin",
+                    "rtamo", "siteperm-addon-provider" "sync", "system-addon",
+                    "temporary-addon", "unknown".
+                    For events with method set to "sideload", the source value
+                    is derived from the XPIProvider location name (e.g. possible
+                    values are "app-builtin", "app-global", "app-profile",
+                    "app-system-addons", "app-system-defaults",
+                    "app-system-local", "app-system-profile",
+                    "app-system-share", "app-system-user", "winreg-app-user",
+                    "winreg-app-gobal").
+                type: string
+            source_method:
+                description: |
+                    The method used by the source to install the add-on
+                    (included when the source can use more than one, e.g.
+                    install events with source "about:addons" may have
+                    "install-from-file" or "url" as method), one of: "amWebAPI",
+                    "drag-and-drop", "installTrigger", "install-from-file",
+                    "link", "management-webext-api", "sideload",
+                    "synthetic-install", "url", "product-updates".
+                type: string
+            num_strings:
+                description: |
+                    The number of permission description strings in the
+                    extension permission doorhanger.
+                type: quantity
+            updated_from:
+                description: |
+                    Determine if an update has been requested by the user or
+                    the application ("app" / "user").
+                type: string
+            install_origins:
+                description: |
+                    This flag indicates whether install_origins is defined in
+                    the addon manifest. ("1" / "0")
+                type: string
+            step:
+                description: |
+                    The current step in the install or update flow: started,
+                    postponed, cancelled, failed, permissions_prompt, completed,
+                    site_warning, site_blocked,install_disabled_warning,
+                    download_started, download_completed, download_failed
+                type: string
+        expires: 132
+
+    update: *install_update_event
+
+    install_stats:
+        type: event
+        description: |
+            These events are recorded at the end of the install flow, but only
+            when the source that originally triggered the add-on installation
+            is "amo", "rtamo" or "disco".
+        bugs:
+            - https://bugzilla.mozilla.org/1653020
+            - https://bugzilla.mozilla.org/1699225
+            - https://bugzilla.mozilla.org/1820153
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820153#c3
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+        extra_keys:
+            addon_id:
+                description: Id of the addon.
+                type: string
+            addon_type:
+                description: Type of the add-on.
+                type: string
+            taar_based:
+                description: |
+                    This extra key is only set for install flows related to the
+                    discovery addon. When available it is going to be a string
+                    set to "1" for TAAR based recommendations, "0" for manually
+                    curated and unset if not relevant for the particular
+                    install flow.
+                type: string
+            utm_campaign:
+                description: |
+                    The specific product promotion or strategic campaign that
+                    drives traffic to the install page.
+                type: string
+            utm_content:
+                description: |
+                    The specific item that a person clicks on to access the
+                    install page (such as an A/B test, a website banner, or a
+                    specific ad).
+                type: string
+            utm_medium:
+                description: The channel used to share the install page.
+                type: string
+            utm_source:
+                description: |
+                    The name of the product, domain of the website that drives
+                    traffic to the install page.
+                type: string
+        expires: never
+
+    manage:
+        type: event
+        description: |
+            This events are recorded when an installed add-ons is being
+            disable/enabled/uninstalled.
+        bugs:
+            - https://bugzilla.mozilla.org/1433335
+            - https://bugzilla.mozilla.org/1515697
+            - https://bugzilla.mozilla.org/1523641
+            - https://bugzilla.mozilla.org/1549770
+            - https://bugzilla.mozilla.org/1590736
+            - https://bugzilla.mozilla.org/1630596
+            - https://bugzilla.mozilla.org/1672570
+            - https://bugzilla.mozilla.org/1714251
+            - https://bugzilla.mozilla.org/1749878
+            - https://bugzilla.mozilla.org/1781974
+            - https://bugzilla.mozilla.org/1817100
+            - https://bugzilla.mozilla.org/1820153
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820153#c3
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+        extra_keys:
+            addon_id:
+                description: Id of the addon being managed.
+                type: string
+            addon_type:
+                description: The type of the add-on being managed.
+                type: string
+            method:
+                description: |
+                    One of: disable, enable, sideload_prompt, uninstall.
+                type: string
+            source:
+                description: |
+                    The source from which the addon has been installed.
+                    See extra_keys.source description from install event.
+                type: string
+            source_method:
+                description: |
+                    The method used by the source to install the add-on
+                    (included when the source can use more than one, e.g.
+                    install events with source "about:addons" may have
+                    "install-from-file" or "url" as method).
+                type: string
+            num_strings:
+                description: |
+                    The number of permission description strings in the
+                    extension permission doorhanger.
+                type: quantity
+        expires: 132
+
+    report:
+        type: event
+        description: An abuse report submitted by a user for a given extension.
+        bugs:
+            - https://bugzilla.mozilla.org/1544927
+            - https://bugzilla.mozilla.org/1580561
+            - https://bugzilla.mozilla.org/1590736
+            - https://bugzilla.mozilla.org/1630596
+            - https://bugzilla.mozilla.org/1672570
+            - https://bugzilla.mozilla.org/1714251
+            - https://bugzilla.mozilla.org/1749878
+            - https://bugzilla.mozilla.org/1780746
+            - https://bugzilla.mozilla.org/1781974
+            - https://bugzilla.mozilla.org/1817100
+            - https://bugzilla.mozilla.org/1820153
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820153#c3
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+        extra_keys:
+            addon_id:
+                description: Id of the addon being reported.
+                type: string
+            addon_type:
+                description: |
+                    The type of the add-on being reported (missing on
+                    ERROR_ADDON_NOT_FOUND, ERROR_AMODETAILS_NOTFOUND
+                    and ERROR_AMODETAILS_FAILURE).
+                type: string
+            entry_point:
+                description: |
+                    Report entry point, one of: amo, menu,
+                    toolbar_context_menu, unified_context_menu, uninstall.
+                type: string
+            error_type:
+                description: |
+                    AbuseReport Error Type (included in case of submission
+                    failures). The error types include ERROR_ABORTED_SUBMIT,
+                    ERROR_ADDON_NOT_FOUND, ERROR_CLIENT, ERROR_NETWORK,
+                    ERROR_UNKNOWN, ERROR_RECENT_SUBMIT, ERROR_SERVER,
+                    ERROR_AMODETAILS_NOTFOUND, ERROR_AMODETAILS_FAILURE.
+                type: string
+        expires: 132
+
+    report_suspicious_site:
+        type: event
+        description: |
+            Sent when a user clicks "Report Suspicious Site" on the dropdown
+            menu of the third-party xpinstall doorhanger.
+        bugs:
+            - https://bugzilla.mozilla.org/1806056
+            - https://bugzilla.mozilla.org/1817100
+            - https://bugzilla.mozilla.org/1820153
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820153#c3
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+        extra_keys:
+            suspicious_site:
+                description: The domain of the site that was reported.
+                type: string
+        expires: 132
+
+blocklist:
+    last_modified_rs_addons_mblf:
+        type: datetime
+        description: >
+            Keep track of the last time the "addons-bloomfilters" remotesetting
+            blocklist has been successfully updated.
+        lifetime: application
+        bugs:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1572711
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1607744
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1649960
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1689274
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1730037
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1763529
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1811159
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820155
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1607744#c11
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296#c5
+        data_sensitivity:
+            - technical
+        metadata:
+            tags:
+                - 'Toolkit :: Blocklist Implementation'
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+            - rwu@mozilla.com
+        expires: 132
+    mlbf_source:
+        type: string
+        description: >
+            The source of the RemoteSettings attachment that
+            holds the bloom filter. Possible values are "dump_match",
+            "cache_match", "remote_match","dump_fallback", "cache_fallback",
+            "unknown". "dump_match", "cache_match" and "remote_match"
+            are expected known-good values, and means that the loaded
+            bloomfilter matches the blocklist record in
+            the RemoteSettings collection. The prefix denotes
+            the immediate source of the loaded data: "dump"
+            means packaged with the application, "remote"
+            means a freshly downloaded bloomfilter, "cache"
+            means a previously downloaded bloomfilter. "dump_fallback"
+            and "cache_fallback" means that the last known bloomfilter
+            was used, despite it not matching the latest record
+            in the RemoteSettings collection. In this case
+            the outdated bloomfilter is used as a fallback
+            (e.g. because the latest version cannot be downloaded).
+            "unknown"  means that the bloomfilter cannot
+            be loaded at all. This can happen if the blocklist
+            is disabled via preferences or enterprise policies.
+        lifetime: application
+        bugs:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1662857
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1730037
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1763529
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1811159
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820155
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1662857#c11
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296#c5
+        data_sensitivity:
+            - technical
+        metadata:
+            tags:
+                - 'Toolkit :: Blocklist Implementation'
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+            - rwu@mozilla.com
+        expires: 132
+        telemetry_mirror: BLOCKLIST_MLBF_SOURCE
+    mlbf_generation_time:
+        type: datetime
+        description: >
+            Keep track of the generation time of the addon
+            blocklist's bloom filter. This marks the point
+            in time until which signed add-ons are recognized
+            by the selected bloom filter from the addons-bloomfilters
+            collection.
+        lifetime: application
+        bugs:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1633466
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1649960
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1689274
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1730037
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1763529
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1811159
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820155
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1633466#c3
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296#c5
+        data_sensitivity:
+            - technical
+        metadata:
+            tags:
+                - 'Toolkit :: Blocklist Implementation'
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+            - rwu@mozilla.com
+        expires: 132
+    mlbf_stash_time_oldest:
+        type: datetime
+        description: >
+            Keep track of the timestamp of the oldest stash
+            of the addons blocklist.
+        lifetime: application
+        bugs:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1633466
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1649960
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1689274
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1730037
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1763529
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1811159
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820155
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1633466#c9
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296#c5
+        data_sensitivity:
+            - technical
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+            - rwu@mozilla.com
+        expires: 132
+    mlbf_stash_time_newest:
+        type: datetime
+        description: >
+            Keep track of the timestamp of the most recent
+            stash of the addons blocklist.
+        lifetime: application
+        bugs:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1633466
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1649960
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1689274
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1730037
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1763529
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1811159
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820155
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1633466#c9
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296#c5
+        data_sensitivity:
+            - technical
+        metadata:
+            tags:
+                - 'Toolkit :: Blocklist Implementation'
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+            - rwu@mozilla.com
+        expires: 132
+    addon_block_change:
+        type: event
+        description: >
+            An add-on is blocked, or an installed add-on is unblocked.
+            When an add-on install/update is blocked, its installation
+            is aborted and the add-on is no longer listed in the activeAddons
+            field of TelemetryEnvironment.
+        extra_keys:
+            value:
+                type: string
+                description: >
+                    The value is the ID of the add-on.
+            object:
+                type: string
+                description: >
+                    The object represents the reason for triggering
+                    the blocklistState check: "addon_install" is when
+                    an add-on is installed. "addon_update" is when an
+                    add-on is updated after an update check.
+                    "addon_update_check" is when an add-on is blocked
+                    during the update check. "addon_db_modified" is when
+                    an add-on's blocklistState was altered
+                    between application restarts. "blocklist_update"
+                    is when an add-on's blocklistState changed due to a
+                    blocklist update. This may be
+                    due to the blocklist being disabled by preferences
+                    or enterprise policies, but it is more commonly
+                    the result of updating entries in the blocklist.
+                    objects: ["addon_install", "addon_update",
+                    "addon_update_check", "addon_db_modified",
+                    "blocklist_update"]
+            blocklist_state:
+                type: string
+                description: >
+                    The blocklistState of the add-on. 0 is unblocked,
+                    2 is blocked. 1 is soft blocked (this state does not
+                    exist in blocklist v3).
+            addon_version:
+                type: string
+                description: >
+                    Version of the add-on. Used together with an
+                    add-on's ID (value) to identify add-ons to block.
+            signed_date:
+                type: string
+                description: >
+                    Timestamp of the add-on (when it was signed via AMO).
+                    the add-on was installed or updated.
+                    At least zero when the blocklist is updated, -1 otherwise.
+            hours_since:
+                type: string
+                description: >
+                    The number of hours that have passed since this version of
+                    This field is missing (0) for "addon_update_check".
+            mlbf_last_time:
+                type: string
+                description: >
+                    The generation time of the most recent
+                    entry in the blocklist. Time generated by
+                    AMO when the blocklist entry was created.
+                    May be 0 when the blocklist is disabled.
+            mlbf_generation:
+                type: string
+                description: >
+                    The generation time to identify the bloomfilter
+                    that was used for this blocklist decision.
+                    The bloomfilter is updated less frequently
+                    than the so-called stashes in the RemoteSettings
+                    collection that holds the blocklist data.
+                    The stashes take precedence over the bloomfilter
+                    in blocklist decisions.
+                    Time generated by AMO when the blocklist
+                    entry was created.
+                    May be 0 when the blocklist is disabled.
+            mlbf_source:
+                type: string
+                description: >
+                    The source of the RemoteSettings attachment
+                    that holds the bloom filter. This field is
+                    documented in more detail in the definition
+                    of the blocklist.mlbf_source. Possible values
+                    are "dump_match", "cache_match",  "remote_match",
+                    "dump_fallback", "cache_fallback", "unknown".
+        bugs:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1662857
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1730037
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1763529
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1811159
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1820155
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296
+        data_reviews:
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1662857#c11
+            - https://bugzilla.mozilla.org/show_bug.cgi?id=1861296#c5
+        data_sensitivity:
+            - technical
+        metadata:
+            tags:
+                - 'Toolkit :: Blocklist Implementation'
+        notification_emails:
+            - addons-dev-internal@mozilla.com
+            - rwu@mozilla.com
+        expires: 132