browser/components/metrics.yaml

   1 # This Source Code Form is subject to the terms of the Mozilla Public
   2 # License, v. 2.0. If a copy of the MPL was not distributed with this
   3 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
   4
   5 # Adding a new metric? We have docs for that!
   6 # https://firefox-source-docs.mozilla.org/toolkit/components/glean/user/new_definitions_file.html
   7
   8 ---
   9 $schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
  10 $tags:
  11   - 'Firefox :: General'
  12
  13 browser.launched_to_handle:
  14   system_notification:
  15     type: event
  16     description: >
  17       Recorded when Firefox launches to complete a native notification popped by
  18       a system (chrome privileged) alert.  Windows-only at the time of writing.
  19     bugs:
  20       - https://bugzilla.mozilla.org/show_bug.cgi?id=1788960
  21     data_reviews:
  22       - https://bugzilla.mozilla.org/show_bug.cgi?id=1788960#c10
  23     data_sensitivity:
  24       - interaction
  25     notification_emails:
  26       - nalexander@mozilla.com
  27       - rtestard@mozilla.com
  28     expires: never
  29     extra_keys:
  30       name:
  31         description: >
  32           The `name` of the system (chrome privileged) alert that Firefox was
  33           launched to complete.
  34         type: string
  35       action:
  36         description: >
  37           The `action` of the system (chrome privileged) alert that Firefox was
  38           launched to complete.
  39         type: string
  40     telemetry_mirror: BrowserLaunched_to_handle_SystemNotification_Toast
  41
  42 background_update:
  43   reasons_to_not_update:
  44     type: string_list
  45     description: >
  46       Records which error was causing the background updater to fail.
  47       This list supercedes the `background-update.reason` in
  48       `mozapps/update/metrics.yaml`
  49     bugs:
  50       - https://bugzilla.mozilla.org/show_bug.cgi?id=1795471
  51     data_reviews:
  52       - https://bugzilla.mozilla.org/show_bug.cgi?id=1795471
  53     data_sensitivity:
  54       - technical
  55     notification_emails:
  56       - install-update@mozilla.com
  57     expires: never
  58     send_in_pings:
  59       - background-update
  60       - metrics
  61     lifetime: application
  62
  63   time_last_update_scheduled:
  64     type: datetime
  65     time_unit: day
  66     description: >
  67       Last time the background update was triggered.
  68     bugs:
  69       - https://bugzilla.mozilla.org/show_bug.cgi?id=1795471
  70     data_reviews:
  71       - https://bugzilla.mozilla.org/show_bug.cgi?id=1795471
  72     data_sensitivity:
  73       - interaction
  74     notification_emails:
  75       - install-update@mozilla.com
  76     expires: never
  77     send_in_pings:
  78       - background-update
  79       - metrics
  80     lifetime: application
  81
  82 start_menu:
  83   manually_unpinned_since_last_launch:
  84     type: event
  85     description: >
  86       Records whether Firefox has been unpinned from the Windows start menu
  87       since last launch. This will only be recorded on MSIX due to the
  88       underlying API only being available for packaged applications.
  89     bugs:
  90       - https://bugzilla.mozilla.org/show_bug.cgi?id=1900035
  91     data_reviews:
  92       - https://bugzilla.mozilla.org/show_bug.cgi?id=1900035
  93     data_sensitivity:
  94       - interaction
  95     notification_emails:
  96       - install-update@mozilla.com
  97     expires: never
  98     send_in_pings:
  99       - events
 100     lifetime: ping
 101
 102 sslkeylogging:
 103   enabled:
 104     type: boolean
 105     description: >
 106       Records whether TLS key logging has been enabled via the environment
 107       variable SSLKEYLOGFILE.
 108     bugs:
 109       - https://bugzilla.mozilla.org/show_bug.cgi?id=1918455
 110     data_reviews:
 111       - https://bugzilla.mozilla.org/show_bug.cgi?id=1918455
 112     data_sensitivity:
 113       - technical
 114     notification_emails:
 115       - dkeeler@mozilla.com
 116     expires: never
 117
 118 launch_on_login:
 119   last_profile_disable_startup:
 120     type: event
 121     description: >
 122       Recorded when Launch on login is disabled because the start with
 123       last profile setting has been disabled.
 124       This event was generated to correspond to the Legacy Telemetry event
 125       launch_on_login.last_profile_disable#startup.
 126     bugs:
 127       - https://bugzil.la/1858223
 128     data_reviews:
 129       - https://bugzil.la/1858223
 130     notification_emails:
 131       - nalexander@mozilla.com
 132     expires: never
 133     telemetry_mirror: Launch_on_login_LastProfileDisable_Startup
 134
 135 upgrade_dialog:
 136   trigger_reason:
 137     type: event
 138     description: >
 139       Triggering behaviors of the upgrade dialog. Value indicates which
 140       condition failed or all satisfied.
 141       This event was generated to correspond to the Legacy Telemetry event
 142       upgrade_dialog.trigger#reason.
 143     bugs:
 144       - https://bugzil.la/1697222
 145     data_reviews:
 146       - https://bugzil.la/1697222
 147     notification_emails:
 148       - edilee@mozilla.com
 149     expires: never
 150     extra_keys:
 151       value:
 152         description: >
 153           The `value` of the event. Mirrors to the Legacy Telemetry
 154           event's `value` parameter.
 155         type: string
 156     telemetry_mirror: Upgrade_dialog_Trigger_Reason
 157
 158 browser.startup:
 159   abouthome_cache_result:
 160     type: quantity
 161     description: >
 162       How the about:home startup cache functioned on startup.
 163
 164       0: Result value was never set (error case)
 165       1: Cache did not exist
 166       2: Cache page stream was corrupt / inaccessible
 167       3: Cache script stream was corrupt / inaccessible
 168       4: Cache was invalidated by a version bump
 169       5: Cache was valid, but read too late to be useful.
 170       6: Cache was valid and used.
 171       7: Cache is disabled.
 172       8: User did not load about:home on its own by default.
 173       9: Cache is disabled because about:newtab preloading is disabled.
 174
 175       This metric was generated to correspond to the Legacy Telemetry
 176       scalar browser.startup.abouthome_cache_result.
 177     bugs:
 178       - https://bugzil.la/1622263
 179       - https://bugzil.la/1614351
 180       - https://bugzil.la/1683101
 181       - https://bugzil.la/1714258
 182       - https://bugzil.la/1730042
 183       - https://bugzil.la/1754641
 184       - https://bugzil.la/1781978
 185       - https://bugzil.la/1811151
 186       - https://bugzil.la/1841926
 187     data_reviews:
 188       - https://bugzil.la/1622263
 189       - https://bugzil.la/1614351
 190       - https://bugzil.la/1683101
 191       - https://bugzil.la/1714258
 192       - https://bugzil.la/1730042
 193       - https://bugzil.la/1754641
 194       - https://bugzil.la/1781978
 195       - https://bugzil.la/1811151
 196       - https://bugzil.la/1841926
 197     notification_emails:
 198       - mconley@mozilla.com
 199       - perf-telemetry-alerts@mozilla.com
 200     expires: never
 201     unit: CACHE_RESULT_SCALARS
 202     telemetry_mirror: BROWSER_STARTUP_ABOUTHOME_CACHE_RESULT
 203     no_lint:
 204       - COMMON_PREFIX
 205
 206   abouthome_cache_shutdownwrite:
 207     type: boolean
 208     description: >
 209       True if the about:home startup cache was written via the
 210       AsyncShutdown blocker.
 211       This metric was generated to correspond to the Legacy Telemetry
 212       scalar browser.startup.abouthome_cache_shutdownwrite.
 213     bugs:
 214       - https://bugzil.la/1622263
 215       - https://bugzil.la/1614351
 216       - https://bugzil.la/1683101
 217       - https://bugzil.la/1714258
 218       - https://bugzil.la/1730042
 219       - https://bugzil.la/1754641
 220       - https://bugzil.la/1781978
 221       - https://bugzil.la/1811151
 222       - https://bugzil.la/1841926
 223     data_reviews:
 224       - https://bugzil.la/1622263
 225       - https://bugzil.la/1614351
 226       - https://bugzil.la/1683101
 227       - https://bugzil.la/1714258
 228       - https://bugzil.la/1730042
 229       - https://bugzil.la/1754641
 230       - https://bugzil.la/1781978
 231       - https://bugzil.la/1811151
 232       - https://bugzil.la/1841926
 233     notification_emails:
 234       - mconley@mozilla.com
 235       - perf-telemetry-alerts@mozilla.com
 236     expires: never
 237     telemetry_mirror: BROWSER_STARTUP_ABOUTHOME_CACHE_SHUTDOWNWRITE
 238     no_lint:
 239       - COMMON_PREFIX
 240
 241 datasanitization:
 242   privacy_sanitize_sanitize_on_shutdown:
 243     type: boolean
 244     description: >
 245       A boolean reporting the value of the
 246       privacy.sanitize.sanitizeOnShutdown pref.
 247       This metric was generated to correspond to the Legacy Telemetry
 248       scalar datasanitization.privacy_sanitize_sanitizeOnShutdown.
 249     bugs:
 250       - https://bugzil.la/1589753
 251       - https://bugzil.la/1617241
 252       - https://bugzil.la/1645089
 253       - https://bugzil.la/1678210
 254     data_reviews:
 255       - https://bugzil.la/1589753
 256       - https://bugzil.la/1617241
 257       - https://bugzil.la/1645089
 258       - https://bugzil.la/1678210
 259     notification_emails:
 260       - ewright@mozilla.com
 261       - seceng-telemetry@mozilla.com
 262     expires: never
 263     telemetry_mirror: DATASANITIZATION_PRIVACY_SANITIZE_SANITIZEONSHUTDOWN
 264
 265   privacy_clear_on_shutdown_cookies:
 266     type: boolean
 267     description: >
 268       A boolean reporting the value of the privacy.clearOnShutdown.cookies
 269       pref.
 270       This metric was generated to correspond to the Legacy Telemetry
 271       scalar datasanitization.privacy_clearOnShutdown_cookies.
 272     bugs:
 273       - https://bugzil.la/1589753
 274       - https://bugzil.la/1617241
 275       - https://bugzil.la/1645089
 276       - https://bugzil.la/1678210
 277     data_reviews:
 278       - https://bugzil.la/1589753
 279       - https://bugzil.la/1617241
 280       - https://bugzil.la/1645089
 281       - https://bugzil.la/1678210
 282     notification_emails:
 283       - ewright@mozilla.com
 284       - seceng-telemetry@mozilla.com
 285     expires: never
 286     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_COOKIES
 287
 288   privacy_clear_on_shutdown_history:
 289     type: boolean
 290     description: >
 291       A boolean reporting the value of the privacy.clearOnShutdown.history
 292       pref.
 293       This metric was generated to correspond to the Legacy Telemetry
 294       scalar datasanitization.privacy_clearOnShutdown_history.
 295     bugs:
 296       - https://bugzil.la/1589753
 297       - https://bugzil.la/1617241
 298       - https://bugzil.la/1645089
 299       - https://bugzil.la/1678210
 300     data_reviews:
 301       - https://bugzil.la/1589753
 302       - https://bugzil.la/1617241
 303       - https://bugzil.la/1645089
 304       - https://bugzil.la/1678210
 305     notification_emails:
 306       - ewright@mozilla.com
 307       - seceng-telemetry@mozilla.com
 308     expires: never
 309     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_HISTORY
 310
 311   privacy_clear_on_shutdown_formdata:
 312     type: boolean
 313     description: >
 314       A boolean reporting the value of the
 315       privacy.clearOnShutdown.formdata pref.
 316       This metric was generated to correspond to the Legacy Telemetry
 317       scalar datasanitization.privacy_clearOnShutdown_formdata.
 318     bugs:
 319       - https://bugzil.la/1589753
 320       - https://bugzil.la/1617241
 321       - https://bugzil.la/1645089
 322       - https://bugzil.la/1678210
 323     data_reviews:
 324       - https://bugzil.la/1589753
 325       - https://bugzil.la/1617241
 326       - https://bugzil.la/1645089
 327       - https://bugzil.la/1678210
 328     notification_emails:
 329       - ewright@mozilla.com
 330       - seceng-telemetry@mozilla.com
 331     expires: never
 332     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_FORMDATA
 333
 334   privacy_clear_on_shutdown_downloads:
 335     type: boolean
 336     description: >
 337       A boolean reporting the value of the
 338       privacy.clearOnShutdown.downloads pref.
 339       This metric was generated to correspond to the Legacy Telemetry
 340       scalar datasanitization.privacy_clearOnShutdown_downloads.
 341     bugs:
 342       - https://bugzil.la/1589753
 343       - https://bugzil.la/1617241
 344       - https://bugzil.la/1645089
 345       - https://bugzil.la/1678210
 346     data_reviews:
 347       - https://bugzil.la/1589753
 348       - https://bugzil.la/1617241
 349       - https://bugzil.la/1645089
 350       - https://bugzil.la/1678210
 351     notification_emails:
 352       - ewright@mozilla.com
 353       - seceng-telemetry@mozilla.com
 354     expires: never
 355     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_DOWNLOADS
 356
 357   privacy_clear_on_shutdown_cache:
 358     type: boolean
 359     description: >
 360       A boolean reporting the value of the privacy.clearOnShutdown.cache
 361       pref.
 362       This metric was generated to correspond to the Legacy Telemetry
 363       scalar datasanitization.privacy_clearOnShutdown_cache.
 364     bugs:
 365       - https://bugzil.la/1589753
 366       - https://bugzil.la/1617241
 367       - https://bugzil.la/1645089
 368       - https://bugzil.la/1678210
 369     data_reviews:
 370       - https://bugzil.la/1589753
 371       - https://bugzil.la/1617241
 372       - https://bugzil.la/1645089
 373       - https://bugzil.la/1678210
 374     notification_emails:
 375       - ewright@mozilla.com
 376       - seceng-telemetry@mozilla.com
 377     expires: never
 378     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_CACHE
 379
 380   privacy_clear_on_shutdown_sessions:
 381     type: boolean
 382     description: >
 383       A boolean reporting the value of the
 384       privacy.clearOnShutdown.sessions pref.
 385       This metric was generated to correspond to the Legacy Telemetry
 386       scalar datasanitization.privacy_clearOnShutdown_sessions.
 387     bugs:
 388       - https://bugzil.la/1589753
 389       - https://bugzil.la/1617241
 390       - https://bugzil.la/1645089
 391       - https://bugzil.la/1678210
 392     data_reviews:
 393       - https://bugzil.la/1589753
 394       - https://bugzil.la/1617241
 395       - https://bugzil.la/1645089
 396       - https://bugzil.la/1678210
 397     notification_emails:
 398       - ewright@mozilla.com
 399       - seceng-telemetry@mozilla.com
 400     expires: never
 401     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_SESSIONS
 402
 403   privacy_clear_on_shutdown_offline_apps:
 404     type: boolean
 405     description: >
 406       A boolean reporting the value of the
 407       privacy.clearOnShutdown.offlineApps pref.
 408       This metric was generated to correspond to the Legacy Telemetry
 409       scalar datasanitization.privacy_clearOnShutdown_offlineApps.
 410     bugs:
 411       - https://bugzil.la/1589753
 412       - https://bugzil.la/1617241
 413       - https://bugzil.la/1645089
 414       - https://bugzil.la/1678210
 415     data_reviews:
 416       - https://bugzil.la/1589753
 417       - https://bugzil.la/1617241
 418       - https://bugzil.la/1645089
 419       - https://bugzil.la/1678210
 420     notification_emails:
 421       - ewright@mozilla.com
 422       - seceng-telemetry@mozilla.com
 423     expires: never
 424     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_OFFLINEAPPS
 425
 426   privacy_clear_on_shutdown_site_settings:
 427     type: boolean
 428     description: >
 429       A boolean reporting the value of the
 430       privacy.clearOnShutdown.siteSettings pref.
 431       This metric was generated to correspond to the Legacy Telemetry
 432       scalar datasanitization.privacy_clearOnShutdown_siteSettings.
 433     bugs:
 434       - https://bugzil.la/1589753
 435       - https://bugzil.la/1617241
 436       - https://bugzil.la/1645089
 437       - https://bugzil.la/1678210
 438     data_reviews:
 439       - https://bugzil.la/1589753
 440       - https://bugzil.la/1617241
 441       - https://bugzil.la/1645089
 442       - https://bugzil.la/1678210
 443     notification_emails:
 444       - ewright@mozilla.com
 445       - seceng-telemetry@mozilla.com
 446     expires: never
 447     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_SITESETTINGS
 448
 449   privacy_clear_on_shutdown_open_windows:
 450     type: boolean
 451     description: >
 452       A boolean reporting the value of the
 453       privacy.clearOnShutdown.openWindows pref.
 454       This metric was generated to correspond to the Legacy Telemetry
 455       scalar datasanitization.privacy_clearOnShutdown_openWindows.
 456     bugs:
 457       - https://bugzil.la/1589753
 458       - https://bugzil.la/1617241
 459       - https://bugzil.la/1645089
 460       - https://bugzil.la/1678210
 461     data_reviews:
 462       - https://bugzil.la/1589753
 463       - https://bugzil.la/1617241
 464       - https://bugzil.la/1645089
 465       - https://bugzil.la/1678210
 466     notification_emails:
 467       - ewright@mozilla.com
 468       - seceng-telemetry@mozilla.com
 469     expires: never
 470     telemetry_mirror: DATASANITIZATION_PRIVACY_CLEARONSHUTDOWN_OPENWINDOWS
 471
 472   session_permission_exceptions:
 473     type: quantity
 474     description: >
 475       A count of how many "session" cookie exceptions a user has set.
 476       This metric was generated to correspond to the Legacy Telemetry
 477       scalar datasanitization.session_permission_exceptions.
 478     bugs:
 479       - https://bugzil.la/1589753
 480       - https://bugzil.la/1617241
 481       - https://bugzil.la/1645089
 482       - https://bugzil.la/1678210
 483       - https://bugzil.la/1744559
 484     data_reviews:
 485       - https://bugzil.la/1589753
 486       - https://bugzil.la/1617241
 487       - https://bugzil.la/1645089
 488       - https://bugzil.la/1678210
 489       - https://bugzil.la/1744559
 490     notification_emails:
 491       - emz@mozilla.com
 492       - seceng-telemetry@mozilla.com
 493     expires: never
 494     unit: unknown
 495     telemetry_mirror: DATASANITIZATION_SESSION_PERMISSION_EXCEPTIONS
 496
 497 startup:
 498   is_cold:
 499     type: boolean
 500     description: >
 501       Whether or not this startup is the first startup since OS reboot
 502       (according to our best guess.)
 503       This metric was generated to correspond to the Legacy Telemetry
 504       scalar startup.is_cold.
 505     bugs:
 506       - https://bugzil.la/1542833
 507     data_reviews:
 508       - https://bugzil.la/1542833
 509     notification_emails:
 510       - dothayer@mozilla.com
 511     expires: never
 512     telemetry_mirror: STARTUP_IS_COLD
 513
 514   seconds_since_last_os_restart:
 515     type: quantity
 516     description: >
 517       The time in seconds between the first browser window loading, and
 518       the time the OS started. This can give us an indication of whether
 519       starting the browser may have been the first thing the user did
 520       after starting their computer.
 521       This metric was generated to correspond to the Legacy Telemetry
 522       scalar startup.seconds_since_last_os_restart.
 523     bugs:
 524       - https://bugzil.la/1654063
 525     data_reviews:
 526       - https://bugzil.la/1654063
 527     notification_emails:
 528       - dothayer@mozilla.com
 529     expires: never
 530     unit: seconds
 531     telemetry_mirror: STARTUP_SECONDS_SINCE_LAST_OS_RESTART
 532
 533 os.environment:
 534   launch_method:
 535     type: string
 536     description: >
 537       Records how Firefox was started on Windows. Currently will be one of
 538       "Desktop", "DesktopPrivate", "StartMenu" (including pins),
 539       "StartMenuPrivate", "Taskbar", "TaskbarPrivate", "OtherShortcut", or
 540       "Other"
 541       This metric was generated to correspond to the Legacy Telemetry
 542       scalar os.environment.launch_method.
 543     bugs:
 544       - https://bugzil.la/1685213
 545       - https://bugzil.la/1725298
 546       - https://bugzil.la/1754656
 547     data_reviews:
 548       - https://bugzil.la/1685213
 549       - https://bugzil.la/1725298
 550       - https://bugzil.la/1754656
 551     notification_emails:
 552       - application-update-telemetry-alerts@mozilla.com
 553       - rtestard@mozilla.com
 554       - shong@mozilla.com
 555     expires: never
 556     telemetry_mirror: OS_ENVIRONMENT_LAUNCH_METHOD
 557
 558   launched_to_handle:
 559     type: labeled_counter
 560     description: >
 561       Records counts for when Firefox was launched afresh (i.e., was not
 562       already running) to handle a file type or protocol with `-osint -url
 563       ...`.  The result is split into keys which represent the file
 564       extension: currently, the set of file types Firefox registers to
 565       handle, namely ".avif", ".htm", ".html", ".pdf", ".shtml", ".xht",
 566       ".xhtml", ".svg", ".webp", and the set of protocol schemes that
 567       Firefox registers to handle, namely "about", "http", "https",
 568       "mailto".  If Firefox was launched to handle a file type or protocol
 569       it does not register to handle by default, the count is recorded as
 570       ".<other extension>" or "<other protocol>", respectively (neither of
 571       which are valid extension or protocol identifiers).
 572       This metric was generated to correspond to the Legacy Telemetry
 573       scalar os.environment.launched_to_handle.
 574     bugs:
 575       - https://bugzil.la/1243603
 576       - https://bugzil.la/1781984
 577     data_reviews:
 578       - https://bugzil.la/1243603
 579       - https://bugzil.la/1781984
 580     notification_emails:
 581       - application-update-telemetry-alerts@mozilla.com
 582     expires: never
 583     telemetry_mirror: OS_ENVIRONMENT_LAUNCHED_TO_HANDLE
 584
 585   invoked_to_handle:
 586     type: labeled_counter
 587     description: >
 588       Records counts for when Firefox was invoked (i.e., was already
 589       running and was not launched) to handle a file type or protocol with
 590       `-osint -url ...`.  The result is split into keys which represent
 591       the file extension: currently, the set of file types Firefox
 592       registers to handle, namely ".avif", ".htm", ".html", ".pdf",
 593       ".shtml", ".xht", ".xhtml", ".svg", ".webp", and the set of protocol
 594       schemes that Firefox registers to handle, namely "about", "http",
 595       "https", "mailto".  If Firefox was invoked to handle a file type or
 596       protocol it does not register to handle by default, the count is
 597       recorded as ".<other extension>" or "<other protocol>", respectively
 598       (neither of which are valid extension or protocol identifiers).
 599       This metric was generated to correspond to the Legacy Telemetry
 600       scalar os.environment.invoked_to_handle.
 601     bugs:
 602       - https://bugzil.la/1243603
 603       - https://bugzil.la/1781984
 604     data_reviews:
 605       - https://bugzil.la/1243603
 606       - https://bugzil.la/1781984
 607     notification_emails:
 608       - application-update-telemetry-alerts@mozilla.com
 609     expires: never
 610     telemetry_mirror: OS_ENVIRONMENT_INVOKED_TO_HANDLE
 611
 612   is_default_handler:
 613     type: labeled_boolean
 614     description: >
 615       Records whether Firefox was the default handler for particular file
 616       types or protocols.  The result is split into keys which represent
 617       the file extension or scheme: currently, a subset of the file types
 618       Firefox registers to handle, namely ".pdf" and "mailto" as protocol.
 619       In the future, more file types may be recorded.
 620       This metric was generated to correspond to the Legacy Telemetry
 621       scalar os.environment.is_default_handler.
 622     bugs:
 623       - https://bugzil.la/1743914
 624       - https://bugzil.la/1781984
 625       - https://bugzil.la/1842290
 626     data_reviews:
 627       - https://bugzil.la/1743914
 628       - https://bugzil.la/1781984
 629       - https://bugzil.la/1842290
 630     notification_emails:
 631       - application-update-telemetry-alerts@mozilla.com
 632     expires: never
 633     telemetry_mirror: OS_ENVIRONMENT_IS_DEFAULT_HANDLER
 634
 635   is_kept_in_dock:
 636     type: boolean
 637     description: >
 638       Whether this app was kept in macOS Dock on startup
 639       This metric was generated to correspond to the Legacy Telemetry
 640       scalar os.environment.is_kept_in_dock.
 641     bugs:
 642       - https://bugzil.la/1715348
 643     data_reviews:
 644       - https://bugzil.la/1715348
 645     notification_emails:
 646       - elee@mozilla.com
 647       - shong@mozilla.com
 648     expires: never
 649     telemetry_mirror: OS_ENVIRONMENT_IS_KEPT_IN_DOCK
 650
 651   is_taskbar_pinned:
 652     type: boolean
 653     description: >
 654       Whether the non-Private Browsing version of this app was pinned to
 655       taskbar on startup
 656       This metric was generated to correspond to the Legacy Telemetry
 657       scalar os.environment.is_taskbar_pinned.
 658     bugs:
 659       - https://bugzil.la/1685213
 660       - https://bugzil.la/1725298
 661     data_reviews:
 662       - https://bugzil.la/1685213
 663       - https://bugzil.la/1725298
 664     notification_emails:
 665       - application-update-telemetry-alerts@mozilla.com
 666       - shong@mozilla.com
 667     expires: never
 668     telemetry_mirror: OS_ENVIRONMENT_IS_TASKBAR_PINNED
 669
 670   is_taskbar_pinned_private:
 671     type: boolean
 672     description: >
 673       Whether the Private Browsing version of this app was pinned to
 674       taskbar on startup
 675       This metric was generated to correspond to the Legacy Telemetry
 676       scalar os.environment.is_taskbar_pinned_private.
 677     bugs:
 678       - https://bugzil.la/1751038
 679     data_reviews:
 680       - https://bugzil.la/1751038
 681     notification_emails:
 682       - application-update-telemetry-alerts@mozilla.com
 683       - shong@mozilla.com
 684     expires: never
 685     telemetry_mirror: OS_ENVIRONMENT_IS_TASKBAR_PINNED_PRIVATE
 686
 687 security:
 688   https_only_mode_enabled:
 689     type: quantity
 690     description: >
 691       Measures user retention of the HTTPS-Only Mode. 0 = never enabled, 1
 692       = enabled, 2 = disabled (but was enabled)
 693       This metric was generated to correspond to the Legacy Telemetry
 694       scalar security.https_only_mode_enabled.
 695     bugs:
 696       - https://bugzil.la/1620244
 697     data_reviews:
 698       - https://bugzil.la/1620244
 699     notification_emails:
 700       - julianwels@mozilla.com
 701       - seceng-telemetry@mozilla.com
 702     expires: never
 703     unit: unknown
 704     telemetry_mirror: SECURITY_HTTPS_ONLY_MODE_ENABLED
 705
 706   https_only_mode_enabled_pbm:
 707     type: quantity
 708     description: >
 709       Measures user retention of the HTTPS-Only Mode in Private Browsing.
 710       0 = https-only never enabled in PBM, 1 = https-only enabled in PBM,
 711       2 = https-only disabled in PBM (but was enabled)
 712       This metric was generated to correspond to the Legacy Telemetry
 713       scalar security.https_only_mode_enabled_pbm.
 714     bugs:
 715       - https://bugzil.la/1647719
 716     data_reviews:
 717       - https://bugzil.la/1647719
 718     notification_emails:
 719       - julianwels@mozilla.com
 720       - ckerschb@mozilla.com
 721       - seceng-telemetry@mozilla.com
 722     expires: never
 723     unit: unknown
 724     telemetry_mirror: SECURITY_HTTPS_ONLY_MODE_ENABLED_PBM
 725
 726   global_privacy_control_enabled:
 727     type: quantity
 728     description: >
 729       Measures user retention of the Global Privacy Control. 0 = never
 730       enabled, 1 = enabled, 2 = disabled (but was enabled)
 731       This metric was generated to correspond to the Legacy Telemetry
 732       scalar security.global_privacy_control_enabled.
 733     bugs:
 734       - https://bugzil.la/1734185
 735     data_reviews:
 736       - https://bugzil.la/1734185
 737     notification_emails:
 738       - seceng-telemetry@mozilla.com
 739     expires: never
 740     unit: unknown
 741     telemetry_mirror: SECURITY_GLOBAL_PRIVACY_CONTROL_ENABLED
 742
 743 primary.password:
 744   enabled:
 745     type: boolean
 746     description: >
 747       If a primary-password is enabled for this profile.
 748       Set soon after browser startup.
 749       Does not update if a primary password is added or removed after startup.
 750     bugs:
 751       - https://bugzil.la/1936036
 752     data_reviews:
 753       - https://bugzil.la/1936036
 754     notification_emails:
 755       - mtigley@mozilla.com
 756     expires: never
 757     telemetry_mirror: PRIMARY_PASSWORD_ENABLED