metrics.yaml (57823B)
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.engagement: 14 active_ticks: 15 type: counter 16 description: | 17 The number of five-second intervals ('ticks') the user was considered 18 'active'. 19 20 'active' means keyboard or mouse interaction with the application. 21 It doesn't take into account whether or not the window has focus or is in 22 the foreground, only if it is receiving these interaction events. 23 24 Migrated from Telemetry's `browser.engagement.active_ticks`. 25 bugs: 26 - https://bugzilla.mozilla.org/show_bug.cgi?id=1376942 # Telemetry 27 - https://bugzilla.mozilla.org/show_bug.cgi?id=1545172 # Telemetry 28 - https://bugzilla.mozilla.org/show_bug.cgi?id=1741674 29 - https://bugzilla.mozilla.org/show_bug.cgi?id=1755050 30 - https://bugzilla.mozilla.org/show_bug.cgi?id=1781578 31 - https://bugzilla.mozilla.org/show_bug.cgi?id=1921440 32 data_reviews: 33 - https://bugzilla.mozilla.org/show_bug.cgi?id=1545172#c8 34 - https://bugzilla.mozilla.org/show_bug.cgi?id=1781578 35 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811152#c5 36 - https://bugzilla.mozilla.org/show_bug.cgi?id=1921440 37 data_sensitivity: 38 - interaction 39 notification_emails: 40 - loines@mozilla.com 41 expires: never 42 send_in_pings: 43 - baseline 44 - metrics 45 - usage-reporting 46 - events 47 telemetry_mirror: BROWSER_ENGAGEMENT_ACTIVE_TICKS 48 no_lint: 49 - BASELINE_PING 50 - METRIC_ON_EVENTS_LIFETIME 51 52 uri_count: 53 type: counter 54 description: | 55 The number of total non-unique http(s) URIs visited, including page 56 reloads, after the session has been restored. URIs on minimized or 57 background tabs may also be counted. Private browsing uris are included. 58 59 Migrated from Telemetry's 60 `browser.engagement.total_uri_count_normal_and_private_mode`. 61 bugs: 62 - https://bugzilla.mozilla.org/show_bug.cgi?id=1535169 # Telemetry 63 - https://bugzilla.mozilla.org/show_bug.cgi?id=1741674 64 - https://bugzilla.mozilla.org/show_bug.cgi?id=1755050 65 - https://bugzilla.mozilla.org/show_bug.cgi?id=1781578 66 - https://bugzilla.mozilla.org/show_bug.cgi?id=1921440 67 data_reviews: 68 - https://bugzilla.mozilla.org/show_bug.cgi?id=1535169#c14 69 - https://bugzilla.mozilla.org/show_bug.cgi?id=1781578 70 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811152#c5 71 - https://bugzilla.mozilla.org/show_bug.cgi?id=1921440 72 data_sensitivity: 73 - interaction 74 notification_emails: 75 - loines@mozilla.com 76 expires: never 77 send_in_pings: 78 - baseline 79 - metrics 80 - usage-reporting 81 - events 82 no_lint: 83 - BASELINE_PING 84 - METRIC_ON_EVENTS_LIFETIME 85 telemetry_mirror: BROWSER_ENGAGEMENT_TOTAL_URI_COUNT_NORMAL_AND_PRIVATE_MODE 86 87 uri_count_normal_mode: 88 type: counter 89 description: > 90 The count of the total non-unique http(s) URIs visited in a 91 subsession, including page reloads, after the session has been 92 restored. URIs on minimized or background tabs may also be counted 93 towards this. Private browsing is not included in this count. 94 This metric was generated to correspond to the Legacy Telemetry 95 scalar browser.engagement.total_uri_count. 96 bugs: 97 - https://bugzil.la/1271313 98 - https://bugzil.la/1529232 99 data_reviews: 100 - https://bugzil.la/1271313 101 - https://bugzil.la/1529232 102 notification_emails: 103 - rweiss@mozilla.com 104 - loines@mozilla.com 105 expires: never 106 telemetry_mirror: BROWSER_ENGAGEMENT_TOTAL_URI_COUNT 107 108 profile_count: 109 type: quantity 110 unit: profiles 111 description: | 112 Windows only count of the browser profiles on the current system. This 113 counts profiles that have been used across all Windows user accounts on 114 machine since this probe was added. The value persists across installs. 115 A value of 0 is reported if there is an error determining the correct 116 count. Unset on other platforms. 117 bugs: 118 - https://bugzilla.mozilla.org/show_bug.cgi?id=1813195 119 data_reviews: 120 - https://bugzilla.mozilla.org/show_bug.cgi?id=1647422#c8 121 data_sensitivity: 122 - technical 123 notification_emails: 124 - pmcmanis@mozilla.com 125 - rtestard@mozilla.com 126 send_in_pings: 127 - metrics 128 expires: never 129 telemetry_mirror: BROWSER_ENGAGEMENT_PROFILE_COUNT 130 131 max_concurrent_tab_count: 132 type: quantity 133 description: > 134 The count of maximum number of tabs open during a subsession, across 135 all windows, including tabs in private windows and restored at 136 startup. 137 This metric was generated to correspond to the Legacy Telemetry 138 scalar browser.engagement.max_concurrent_tab_count. 139 bugs: 140 - https://bugzil.la/1271304 141 data_reviews: 142 - https://bugzil.la/1271304 143 notification_emails: 144 - rweiss@mozilla.com 145 expires: never 146 unit: tabs 147 send_in_pings: 148 - metrics 149 - events 150 no_lint: 151 - METRIC_ON_EVENTS_LIFETIME 152 telemetry_mirror: BROWSER_ENGAGEMENT_MAX_CONCURRENT_TAB_COUNT 153 154 max_concurrent_vertical_tab_count: 155 type: quantity 156 description: > 157 The count of maximum number of tabs with vertical tabs enabled. 158 This metric was generated to correspond to the Legacy Telemetry 159 scalar browser.engagement.max_concurrent_vertical_tab_count. 160 bugs: 161 - https://bugzil.la/1899352 162 data_reviews: 163 - https://bugzil.la/1899352 164 notification_emails: 165 - vsabino@mozilla.com 166 expires: never 167 unit: vertical tabs 168 telemetry_mirror: BROWSER_ENGAGEMENT_MAX_CONCURRENT_VERTICAL_TAB_COUNT 169 170 max_concurrent_window_count: 171 type: quantity 172 description: > 173 The count of maximum number of browser windows open during a 174 subsession. This includes private windows and the ones opened when 175 starting the browser. 176 This metric was generated to correspond to the Legacy Telemetry 177 scalar browser.engagement.max_concurrent_window_count. 178 bugs: 179 - https://bugzil.la/1271304 180 data_reviews: 181 - https://bugzil.la/1271304 182 notification_emails: 183 - rweiss@mozilla.com 184 expires: never 185 unit: windows 186 telemetry_mirror: BROWSER_ENGAGEMENT_MAX_CONCURRENT_WINDOW_COUNT 187 188 max_concurrent_tab_pinned_count: 189 type: quantity 190 description: > 191 The count of maximum number of pinned tabs open during a subsession. 192 This includes private windows and the ones opened when starting the 193 browser. Starting Firefox 85 this includes number of restored pinned 194 tabs at startup. 195 This metric was generated to correspond to the Legacy Telemetry 196 scalar browser.engagement.max_concurrent_tab_pinned_count. 197 bugs: 198 - https://bugzil.la/1505535 199 data_reviews: 200 - https://bugzil.la/1505535 201 notification_emails: 202 - bmiroglio@mozilla.com 203 - omc-core@mozilla.com 204 expires: never 205 unit: pinned tabs 206 telemetry_mirror: BROWSER_ENGAGEMENT_MAX_CONCURRENT_TAB_PINNED_COUNT 207 208 max_concurrent_vertical_tab_pinned_count: 209 type: quantity 210 description: > 211 The count of maximum number of pinned tabs with vertical tabs 212 enabled. 213 This metric was generated to correspond to the Legacy Telemetry 214 scalar browser.engagement.max_concurrent_vertical_tab_pinned_count. 215 bugs: 216 - https://bugzil.la/1899352 217 data_reviews: 218 - https://bugzil.la/1899352 219 notification_emails: 220 - vsabino@mozilla.com 221 expires: never 222 unit: vertical pinned tabs 223 telemetry_mirror: BROWSER_ENGAGEMENT_MAX_CONCURRENT_VERTICAL_TAB_PINNED_COUNT 224 225 tab_open_event_count: 226 type: counter 227 description: > 228 The count of tab open events per subsession, across all windows, 229 after the session has been restored. This includes tab open events 230 from private windows and from manual session restorations (i.e. 231 after crashes and from about:home), but excludes tabs opened vertically. 232 This metric was generated to correspond to the Legacy Telemetry 233 scalar browser.engagement.tab_open_event_count. 234 bugs: 235 - https://bugzil.la/1271304 236 data_reviews: 237 - https://bugzil.la/1271304 238 notification_emails: 239 - vsabino@mozilla.com 240 expires: never 241 send_in_pings: 242 - metrics 243 - events 244 no_lint: 245 - METRIC_ON_EVENTS_LIFETIME 246 telemetry_mirror: BROWSER_ENGAGEMENT_TAB_OPEN_EVENT_COUNT 247 248 vertical_tab_open_event_count: 249 type: counter 250 description: > 251 The count of tab open events with vertical tabs enabled. 252 This metric was generated to correspond to the Legacy Telemetry 253 scalar browser.engagement.vertical_tab_open_event_count. 254 bugs: 255 - https://bugzil.la/1899352 256 data_reviews: 257 - https://bugzil.la/1899352 258 notification_emails: 259 - vsabino@mozilla.com 260 expires: never 261 telemetry_mirror: BROWSER_ENGAGEMENT_VERTICAL_TAB_OPEN_EVENT_COUNT 262 263 window_open_event_count: 264 type: counter 265 description: > 266 The count of browser window open events per subsession, after the 267 session has been restored. The count includes private windows and 268 the ones from manual session restorations (i.e. after crashes and 269 from about:home). 270 This metric was generated to correspond to the Legacy Telemetry 271 scalar browser.engagement.window_open_event_count. 272 bugs: 273 - https://bugzil.la/1271304 274 data_reviews: 275 - https://bugzil.la/1271304 276 notification_emails: 277 - rweiss@mozilla.com 278 expires: never 279 telemetry_mirror: BROWSER_ENGAGEMENT_WINDOW_OPEN_EVENT_COUNT 280 281 tab_pinned_event_count: 282 type: counter 283 description: > 284 The count of tab pinned events per subsession, across all windows, 285 after the session has been restored. This includes tab pinned events 286 from private windows. 287 This metric was generated to correspond to the Legacy Telemetry 288 scalar browser.engagement.tab_pinned_event_count. 289 bugs: 290 - https://bugzil.la/1505535 291 data_reviews: 292 - https://bugzil.la/1505535 293 notification_emails: 294 - bmiroglio@mozilla.com 295 - omc-core@mozilla.com 296 expires: never 297 telemetry_mirror: BROWSER_ENGAGEMENT_TAB_PINNED_EVENT_COUNT 298 299 vertical_tab_pinned_event_count: 300 type: counter 301 description: > 302 The count of tab pinned events with vertical tabs enabled. 303 This metric was generated to correspond to the Legacy Telemetry 304 scalar browser.engagement.vertical_tab_pinned_event_count. 305 bugs: 306 - https://bugzil.la/1899352 307 data_reviews: 308 - https://bugzil.la/1899352 309 notification_emails: 310 - vsabino@mozilla.com 311 expires: never 312 telemetry_mirror: BROWSER_ENGAGEMENT_VERTICAL_TAB_PINNED_EVENT_COUNT 313 314 unfiltered_uri_count: 315 type: counter 316 description: > 317 The count of the total non-unique URIs visited in a subsession, not 318 restricted to a specific protocol, including page reloads and 319 about:* pages (other than initial pages such as about:blank, ...), 320 after the session has been restored. This does not include 321 background page requests and URIs from embedded pages or private 322 browsing. 323 This metric was generated to correspond to the Legacy Telemetry 324 scalar browser.engagement.unfiltered_uri_count. 325 bugs: 326 - https://bugzil.la/1304647 327 data_reviews: 328 - https://bugzil.la/1304647 329 notification_emails: 330 - bcolloran@mozilla.com 331 expires: never 332 telemetry_mirror: BROWSER_ENGAGEMENT_UNFILTERED_URI_COUNT 333 334 unique_domains_count: 335 type: quantity 336 description: > 337 The count of the unique domains visited in a subsession, after the 338 session has been restored. Subdomains under eTLD are aggregated 339 after the first level (i.e. test.example.com and other.example.com 340 are only counted once). This does not include background page 341 requests and domains from embedded pages or private browsing. The 342 count is limited to 100 unique domains. 343 This metric was generated to correspond to the Legacy Telemetry 344 scalar browser.engagement.unique_domains_count. 345 bugs: 346 - https://bugzil.la/1271310 347 data_reviews: 348 - https://bugzil.la/1271310 349 notification_emails: 350 - rweiss@mozilla.com 351 expires: never 352 unit: domains 353 telemetry_mirror: BROWSER_ENGAGEMENT_UNIQUE_DOMAINS_COUNT 354 355 tab_count: 356 type: custom_distribution 357 description: > 358 Number of tabs opened across all windows, collected at most every 5 359 minutes whenever the user interacts with the browser in the following 360 ways: open tab/window, page load. 361 362 This metric was generated to correspond to the Legacy Telemetry 363 exponential histogram TAB_COUNT. 364 range_min: 1 365 range_max: 1000 366 bucket_count: 100 367 histogram_type: exponential 368 unit: tabs 369 bugs: 370 - https://bugzilla.mozilla.org/show_bug.cgi?id=1361855 371 - https://bugzilla.mozilla.org/show_bug.cgi?id=1488945 372 data_reviews: 373 - https://bugzilla.mozilla.org/show_bug.cgi?id=1361855 374 - https://bugzilla.mozilla.org/show_bug.cgi?id=1488945 375 notification_emails: 376 - gijs@mozilla.com 377 expires: never 378 telemetry_mirror: TAB_COUNT 379 380 loaded_tab_count: 381 type: custom_distribution 382 description: > 383 Number of fully loaded (i.e., not pending from session restore) tabs 384 opened across all windows, collected at most every 5 minutes whenever the 385 user interacts with the browser in the following ways: open tab/window, 386 page load, restoring a pending tab. 387 388 This metric was generated to correspond to the Legacy Telemetry 389 exponential histogram LOADED_TAB_COUNT. 390 range_min: 1 391 range_max: 1000 392 bucket_count: 100 393 histogram_type: exponential 394 unit: tabs 395 bugs: 396 - https://bugzilla.mozilla.org/show_bug.cgi?id=1634508 397 data_reviews: 398 - https://bugzilla.mozilla.org/show_bug.cgi?id=1634508 399 notification_emails: 400 - beth@mozilla.com 401 - perf-telemetry-alerts@mozilla.com 402 expires: never 403 telemetry_mirror: LOADED_TAB_COUNT 404 405 installation.first_seen: 406 failure_reason: 407 type: string 408 description: > 409 Only sent if unable to collect firstSeen data. Can have 410 value "NotFoundError" if file not found or other values 411 depending on the failure reason. 412 bugs: 413 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 414 data_reviews: 415 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 416 data_sensitivity: 417 - technical 418 notification_emails: 419 - rtestard@mozilla.com 420 - application-update-telemetry-alerts@mozilla.com 421 expires: never 422 telemetry_mirror: INSTALLATION_FIRSTSEEN_FAILURE_REASON 423 424 installer_type: 425 type: string 426 description: > 427 The type of installer used to install Firefox. 428 The value is one of "stub", "full", or "msix" 429 bugs: 430 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 431 data_reviews: 432 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 433 data_sensitivity: 434 - technical 435 notification_emails: 436 - rtestard@mozilla.com 437 - application-update-telemetry-alerts@mozilla.com 438 expires: never 439 telemetry_mirror: INSTALLATION_FIRSTSEEN_INSTALLER_TYPE 440 441 version: 442 type: string 443 description: > 444 The application version installed by the installer 445 (not necessarily the current version) 446 bugs: 447 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 448 data_reviews: 449 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 450 data_sensitivity: 451 - technical 452 notification_emails: 453 - rtestard@mozilla.com 454 - application-update-telemetry-alerts@mozilla.com 455 expires: never 456 telemetry_mirror: INSTALLATION_FIRSTSEEN_VERSION 457 458 admin_user: 459 type: boolean 460 description: > 461 Whether the installer is running from an elevated admin user 462 bugs: 463 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 464 data_reviews: 465 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 466 data_sensitivity: 467 - technical 468 notification_emails: 469 - rtestard@mozilla.com 470 - application-update-telemetry-alerts@mozilla.com 471 expires: never 472 telemetry_mirror: INSTALLATION_FIRSTSEEN_ADMIN_USER 473 474 install_existed: 475 type: boolean 476 description: > 477 Whether there was already an install in this location 478 bugs: 479 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 480 data_reviews: 481 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 482 data_sensitivity: 483 - technical 484 notification_emails: 485 - rtestard@mozilla.com 486 - application-update-telemetry-alerts@mozilla.com 487 expires: never 488 telemetry_mirror: INSTALLATION_FIRSTSEEN_INSTALL_EXISTED 489 490 profdir_existed: 491 type: boolean 492 description: > 493 Whether the top-level profile directory existed 494 bugs: 495 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 496 data_reviews: 497 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 498 data_sensitivity: 499 - technical 500 notification_emails: 501 - rtestard@mozilla.com 502 - application-update-telemetry-alerts@mozilla.com 503 expires: never 504 telemetry_mirror: INSTALLATION_FIRSTSEEN_PROFDIR_EXISTED 505 506 other_inst: 507 type: boolean 508 description: > 509 Whether there was already any non-MSIX install on this system 510 bugs: 511 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 512 data_reviews: 513 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 514 data_sensitivity: 515 - technical 516 notification_emails: 517 - rtestard@mozilla.com 518 - application-update-telemetry-alerts@mozilla.com 519 expires: never 520 telemetry_mirror: INSTALLATION_FIRSTSEEN_OTHER_INST 521 522 other_msix_inst: 523 type: boolean 524 description: > 525 Whether there was already any MSIX install on this system 526 bugs: 527 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 528 data_reviews: 529 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 530 data_sensitivity: 531 - technical 532 notification_emails: 533 - rtestard@mozilla.com 534 - application-update-telemetry-alerts@mozilla.com 535 expires: never 536 telemetry_mirror: INSTALLATION_FIRSTSEEN_OTHER_MSIX_INST 537 538 silent: 539 type: boolean 540 description: > 541 (optional, present if installer_type is "full") 542 Whether this was a silent install 543 bugs: 544 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 545 data_reviews: 546 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 547 data_sensitivity: 548 - technical 549 notification_emails: 550 - rtestard@mozilla.com 551 - application-update-telemetry-alerts@mozilla.com 552 expires: never 553 telemetry_mirror: INSTALLATION_FIRSTSEEN_SILENT 554 555 from_msi: 556 type: boolean 557 description: > 558 (optional, present if installer_type is "full") 559 Whether this was an MSI install 560 bugs: 561 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 562 data_reviews: 563 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 564 data_sensitivity: 565 - technical 566 notification_emails: 567 - rtestard@mozilla.com 568 - application-update-telemetry-alerts@mozilla.com 569 expires: never 570 telemetry_mirror: INSTALLATION_FIRSTSEEN_FROM_MSI 571 572 default_path: 573 type: boolean 574 description: > 575 (optional, present if installer_type is "full") 576 Whether the default path was used 577 bugs: 578 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 579 data_reviews: 580 - https://bugzilla.mozilla.org/show_bug.cgi?id=1811374 581 data_sensitivity: 582 - technical 583 notification_emails: 584 - rtestard@mozilla.com 585 - application-update-telemetry-alerts@mozilla.com 586 expires: never 587 telemetry_mirror: INSTALLATION_FIRSTSEEN_DEFAULT_PATH 588 589 performance.interaction: 590 tab_switch_composite: 591 type: timing_distribution 592 time_unit: millisecond 593 telemetry_mirror: FX_TAB_SWITCH_COMPOSITE_E10S_MS 594 description: > 595 Time between tab selection and first composite of the tab content onto the 596 screen. 597 (Migrated from the geckoview metric of the same name.) 598 metadata: 599 tags: 600 - 'Firefox :: Tabbed Browser' 601 bugs: 602 - https://bugzilla.mozilla.org/show_bug.cgi?id=1481704 603 - https://bugzilla.mozilla.org/show_bug.cgi?id=1529352 604 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077 605 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 606 data_reviews: 607 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10 608 notification_emails: 609 - mconley@mozilla.com 610 - perf-telemetry-alerts@mozilla.com 611 expires: never 612 613 browser.usage: 614 interaction: 615 type: event 616 description: > 617 The user interacted with something in the Firefox Desktop frontend. 618 Could be via mouse or keyboard, could be a command or a UI element. 619 bugs: 620 - https://bugzilla.mozilla.org/show_bug.cgi?id=1889111 621 - https://bugzilla.mozilla.org/show_bug.cgi?id=1912172 622 data_reviews: 623 - https://bugzilla.mozilla.org/show_bug.cgi?id=1889111 624 - https://bugzilla.mozilla.org/show_bug.cgi?id=1912172 625 expires: never 626 data_sensitivity: [interaction] 627 notification_emails: 628 - chutten@mozilla.com 629 extra_keys: 630 flow_id: 631 type: string 632 description: > 633 An UUIDv4 used to group interaction events together under the 634 assumption that they're part of the same user activity. 635 See BrowserUsageTelemetry's FLOW_IDLE_TIME for details. 636 source: 637 type: string 638 description: > 639 The source of the interaction. Usually a UI section 640 (like `bookmarks_bar` or `content_context`), but can also be an input 641 method (like `keyboard`). 642 The full list of supported `source`s can be found in 643 `BrowserUsageTelemetry`'s `BROWSER_UI_CONTAINER_IDS. Plus `keyboard` 644 and panes from `about:preferences` listed in `PREFERENCES_PANES`. 645 See `_getWidgetContainer` for details. 646 widget_id: 647 type: string 648 description: > 649 The item interacted with. 650 Usually the `id` of the DOM Node that the user used, 651 sometimes the `id` of the parent or ancestor Node instead. 652 This node is then conjugated by obscuring any addon id in it 653 (turning it to the string `addonX` where `X` is a number stable 654 within a browsing session) and then replacing any underscore with a 655 hyphen. 656 See `BrowserUsageTelemetry#_getWidgetID` and `telemetryId`. 657 e.g. "Browser:Reload", "key-newNavigatorTab", "PanelUI-Bookmarks". 658 send_in_pings: 659 - prototype-no-code-events 660 661 browser.ui: 662 toolbar_widgets: 663 type: object 664 description: > 665 What widgets are in which toolbars. 666 Not dissimilar from Telemetry's `browser.ui.toolbar_widgets`, 667 but in a friendlier format. 668 See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html 669 for how widget ids and positions are determined. 670 bugs: 671 - https://bugzilla.mozilla.org/show_bug.cgi?id=1913362 672 - https://bugzilla.mozilla.org/show_bug.cgi?id=1940641 673 data_reviews: 674 - https://bugzilla.mozilla.org/show_bug.cgi?id=1913362 675 - https://bugzilla.mozilla.org/show_bug.cgi?id=1940641 676 data_sensitivity: 677 - interaction 678 notification_emails: 679 - shong@mozilla.com 680 - dtownsend@mozilla.com 681 - chutten@mozilla.com 682 expires: never 683 structure: 684 type: array 685 items: 686 type: object 687 properties: 688 position: 689 type: string 690 widgetId: 691 type: string 692 693 mirror_for_toolbar_widgets: 694 type: labeled_boolean 695 description: > 696 The widgets in the toolbars. See https://firefox-source- 697 docs.mozilla.org/browser/BrowserUsageTelemetry.html 698 This metric was generated to correspond to the Legacy Telemetry 699 scalar browser.ui.toolbar_widgets. 700 bugs: 701 - https://bugzil.la/1620358 702 data_reviews: 703 - https://bugzil.la/1620358 704 notification_emails: 705 - shong@mozilla.com 706 - dtownsend@mozilla.com 707 expires: never 708 telemetry_mirror: BROWSER_UI_TOOLBAR_WIDGETS 709 710 customized_widgets: 711 type: labeled_counter 712 description: > 713 Records when widgets are added, removed or moved in the UI. See 714 https://firefox-source- 715 docs.mozilla.org/browser/BrowserUsageTelemetry.html 716 This metric was generated to correspond to the Legacy Telemetry 717 scalar browser.ui.customized_widgets. 718 bugs: 719 - https://bugzil.la/1620358 720 data_reviews: 721 - https://bugzil.la/1620358 722 notification_emails: 723 - shong@mozilla.com 724 - dtownsend@mozilla.com 725 expires: never 726 telemetry_mirror: BROWSER_UI_CUSTOMIZED_WIDGETS 727 728 homepage: 729 preference_ignore: 730 type: event 731 description: > 732 This is recorded whenever the homepage preference is either reset 733 due to being on the ignore list, or setting is blocked due to being 734 on the same list. The value field records the reason for the ignore. 735 "saved_reset" for when a saved preference value is reset. 736 "set_blocked" for when the setting was blocked and 737 "set_blocked_extension" for when we know a WebExtension attempting 738 to set it was blocked. 739 This event was generated to correspond to the Legacy Telemetry event 740 homepage.preference#ignore. 741 bugs: 742 - https://bugzil.la/1535049 743 data_reviews: 744 - https://bugzil.la/1535049 745 notification_emails: 746 - mdeboer@mozilla.com 747 - rharter@mozilla.com 748 expires: never 749 extra_keys: 750 value: 751 description: > 752 The `value` of the event. Mirrors to the Legacy Telemetry 753 event's `value` parameter. 754 type: string 755 webExtensionId: 756 description: > 757 The identifier of the webextension, if known. 758 type: string 759 telemetry_mirror: Homepage_Preference_Ignore 760 761 installation: 762 first_seen_full: 763 type: event 764 description: > 765 Recorded after the application has been installed or reinstalled, 766 the first time that a profile sees that there was a new 767 installation. This includes information about how the installer was 768 run. 769 This event was generated to correspond to the Legacy Telemetry event 770 installation.first_seen#full. 771 bugs: &installation_first_seen_bugs 772 - https://bugzil.la/1660198 773 - https://bugzil.la/1725295 774 - https://bugzil.la/1743465 775 - https://bugzil.la/1754638 776 data_reviews: &installation_first_seen_data_reviews 777 - https://bugzil.la/1660198 778 - https://bugzil.la/1725295 779 - https://bugzil.la/1743465 780 - https://bugzil.la/1754638 781 notification_emails: &installation_first_seen_emails 782 - application-update-telemetry-alerts@mozilla.com 783 - rtestard@mozilla.com 784 expires: never 785 extra_keys: &installation_first_seen_extra 786 version: 787 description: > 788 The application version installed by the installer (not necessarily the current version) 789 type: string 790 build_id: 791 description: > 792 The build ID of the application installed by the installer (not necessarily the current version) 793 type: string 794 admin_user: 795 description: > 796 Whether the installer is running from an elevated admin user 797 type: string 798 install_existed: 799 description: > 800 Whether there was already an install in this location 801 type: string 802 other_inst: 803 description: > 804 Whether there was already any non-MSIX install on this system 805 type: string 806 other_msix_inst: 807 description: > 808 Whether there was already any MSIX install on this system 809 type: string 810 profdir_existed: 811 description: > 812 Whether the top-level profile directory existed 813 type: string 814 silent: 815 description: > 816 (optional, present if object is "full") Whether this was a silent install 817 type: string 818 from_msi: 819 description: > 820 (optional, present if object is "full") Whether this was an MSI install 821 type: string 822 default_path: 823 description: > 824 (optional, present if object is "full") Whether the default path was used 825 type: string 826 telemetry_mirror: Installation_FirstSeen_Full 827 no_lint: 828 - COMMON_PREFIX 829 830 first_seen_stub: 831 type: event 832 description: > 833 Recorded after the application has been installed or reinstalled, 834 the first time that a profile sees that there was a new 835 installation. This includes information about how the installer was 836 run. 837 This event was generated to correspond to the Legacy Telemetry event 838 installation.first_seen#stub. 839 bugs: *installation_first_seen_bugs 840 data_reviews: *installation_first_seen_data_reviews 841 notification_emails: *installation_first_seen_emails 842 expires: never 843 extra_keys: *installation_first_seen_extra 844 telemetry_mirror: Installation_FirstSeen_Stub 845 no_lint: 846 - COMMON_PREFIX 847 848 first_seen_msix: 849 type: event 850 description: > 851 Recorded after the application has been installed or reinstalled, 852 the first time that a profile sees that there was a new 853 installation. This includes information about how the installer was 854 run. 855 This event was generated to correspond to the Legacy Telemetry event 856 installation.first_seen#msix. 857 bugs: *installation_first_seen_bugs 858 data_reviews: *installation_first_seen_data_reviews 859 notification_emails: *installation_first_seen_emails 860 expires: never 861 extra_keys: *installation_first_seen_extra 862 telemetry_mirror: Installation_FirstSeen_Msix 863 no_lint: 864 - COMMON_PREFIX 865 866 partner_link: 867 click_newtab: 868 type: event 869 description: > 870 This is recorded when clicking a partner link. The value is the 871 partner. 872 This event was generated to correspond to the Legacy Telemetry event 873 partner_link.click#newtab. 874 bugs: &partner_link_click_bugs 875 - https://bugzil.la/1637217 876 - https://bugzil.la/1644442 877 - https://bugzil.la/1643426 878 data_reviews: &partner_link_click_data_reviews 879 - https://bugzil.la/1637217 880 - https://bugzil.la/1644442 881 - https://bugzil.la/1643426 882 notification_emails: &partner_link_click_emails 883 - dao@mozilla.com 884 expires: never 885 extra_keys: &partner_link_click_extra 886 value: 887 description: > 888 The `value` of the event. Mirrors to the Legacy Telemetry 889 event's `value` parameter. 890 type: string 891 telemetry_mirror: Partner_link_Click_Newtab 892 893 click_urlbar: 894 type: event 895 description: > 896 This is recorded when clicking a partner link. The value is the 897 partner. 898 This event was generated to correspond to the Legacy Telemetry event 899 partner_link.click#urlbar. 900 bugs: *partner_link_click_bugs 901 data_reviews: *partner_link_click_data_reviews 902 notification_emails: *partner_link_click_emails 903 expires: never 904 extra_keys: *partner_link_click_extra 905 telemetry_mirror: Partner_link_Click_Urlbar 906 907 attribution_success: 908 type: event 909 description: > 910 This is recorded when sending an attribution request for a partner 911 link. The value is the partner. 912 This event was generated to correspond to the Legacy Telemetry event 913 partner_link.attribution#success. 914 bugs: &partner_link_attribution_bugs 915 - https://bugzil.la/1637217 916 - https://bugzil.la/1644442 917 - https://bugzil.la/1643426 918 data_reviews: &partner_link_attribution_data_reviews 919 - https://bugzil.la/1637217 920 - https://bugzil.la/1644442 921 - https://bugzil.la/1643426 922 notification_emails: &partner_link_attribution_emails 923 - dao@mozilla.com 924 expires: never 925 extra_keys: &partner_link_attribution_extra 926 value: 927 description: > 928 The `value` of the event. Mirrors to the Legacy Telemetry 929 event's `value` parameter. 930 type: string 931 telemetry_mirror: Partner_link_Attribution_Success 932 933 attribution_failure: 934 type: event 935 description: > 936 This is recorded when sending an attribution request for a partner 937 link. The value is the partner. 938 This event was generated to correspond to the Legacy Telemetry event 939 partner_link.attribution#failure. 940 bugs: *partner_link_attribution_bugs 941 data_reviews: *partner_link_attribution_data_reviews 942 notification_emails: *partner_link_attribution_emails 943 expires: never 944 extra_keys: *partner_link_attribution_extra 945 telemetry_mirror: Partner_link_Attribution_Failure 946 947 attribution_abort: 948 type: event 949 description: > 950 This is recorded when sending an attribution request for a partner 951 link. The value is the partner. 952 This event was generated to correspond to the Legacy Telemetry event 953 partner_link.attribution#abort. 954 bugs: *partner_link_attribution_bugs 955 data_reviews: *partner_link_attribution_data_reviews 956 notification_emails: *partner_link_attribution_emails 957 expires: never 958 extra_keys: *partner_link_attribution_extra 959 telemetry_mirror: Partner_link_Attribution_Abort 960 961 browser.ui.interaction: 962 menu_bar: 963 type: labeled_counter 964 description: > 965 Records a count of interactions with items in the menu bar. See 966 https://firefox-source- 967 docs.mozilla.org/browser/BrowserUsageTelemetry.html 968 This metric was generated to correspond to the Legacy Telemetry 969 scalar browser.ui.interaction.menu_bar. 970 bugs: 971 - https://bugzil.la/1620358 972 data_reviews: 973 - https://bugzil.la/1620358 974 notification_emails: 975 - shong@mozilla.com 976 - dtownsend@mozilla.com 977 expires: never 978 telemetry_mirror: BROWSER_UI_INTERACTION_MENU_BAR 979 980 tabs_bar: 981 type: labeled_counter 982 description: > 983 Records a count of interactions with items in the tab bar. See 984 https://firefox-source- 985 docs.mozilla.org/browser/BrowserUsageTelemetry.html 986 This metric was generated to correspond to the Legacy Telemetry 987 scalar browser.ui.interaction.tabs_bar. 988 bugs: 989 - https://bugzil.la/1620358 990 data_reviews: 991 - https://bugzil.la/1620358 992 notification_emails: 993 - shong@mozilla.com 994 - dtownsend@mozilla.com 995 expires: never 996 telemetry_mirror: BROWSER_UI_INTERACTION_TABS_BAR 997 998 vertical_tabs_container: 999 type: labeled_counter 1000 description: > 1001 Records a count of interactions with items in the vertical tab bar. 1002 See https://firefox-source- 1003 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1004 This metric was generated to correspond to the Legacy Telemetry 1005 scalar browser.ui.interaction.vertical_tabs_container. 1006 bugs: 1007 - https://bugzil.la/1921789 1008 data_reviews: 1009 - https://bugzil.la/1921789 1010 notification_emails: 1011 - vsabino@mozilla.com 1012 expires: never 1013 telemetry_mirror: BROWSER_UI_INTERACTION_VERTICAL_TABS_CONTAINER 1014 1015 nav_bar: 1016 type: labeled_counter 1017 description: > 1018 Records a count of interactions with items in the nav bar. See 1019 https://firefox-source- 1020 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1021 This metric was generated to correspond to the Legacy Telemetry 1022 scalar browser.ui.interaction.nav_bar. 1023 bugs: 1024 - https://bugzil.la/1620358 1025 data_reviews: 1026 - https://bugzil.la/1620358 1027 notification_emails: 1028 - shong@mozilla.com 1029 - dtownsend@mozilla.com 1030 expires: never 1031 telemetry_mirror: BROWSER_UI_INTERACTION_NAV_BAR 1032 1033 bookmarks_bar: 1034 type: labeled_counter 1035 description: > 1036 Records a count of interactions with items in the bookmarks bar. See 1037 https://firefox-source- 1038 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1039 This metric was generated to correspond to the Legacy Telemetry 1040 scalar browser.ui.interaction.bookmarks_bar. 1041 bugs: 1042 - https://bugzil.la/1620358 1043 data_reviews: 1044 - https://bugzil.la/1620358 1045 notification_emails: 1046 - shong@mozilla.com 1047 - dtownsend@mozilla.com 1048 expires: never 1049 telemetry_mirror: BROWSER_UI_INTERACTION_BOOKMARKS_BAR 1050 1051 app_menu: 1052 type: labeled_counter 1053 description: > 1054 Records a count of interactions with items in the app menu. See 1055 https://firefox-source- 1056 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1057 This metric was generated to correspond to the Legacy Telemetry 1058 scalar browser.ui.interaction.app_menu. 1059 bugs: 1060 - https://bugzil.la/1620358 1061 data_reviews: 1062 - https://bugzil.la/1620358 1063 notification_emails: 1064 - shong@mozilla.com 1065 - dtownsend@mozilla.com 1066 expires: never 1067 telemetry_mirror: BROWSER_UI_INTERACTION_APP_MENU 1068 1069 tabs_context: 1070 type: labeled_counter 1071 description: > 1072 Records a count of interactions with items in the tab context menu. 1073 See https://firefox-source- 1074 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1075 This metric was generated to correspond to the Legacy Telemetry 1076 scalar browser.ui.interaction.tabs_context. 1077 bugs: 1078 - https://bugzil.la/1620358 1079 data_reviews: 1080 - https://bugzil.la/1620358 1081 notification_emails: 1082 - shong@mozilla.com 1083 - dtownsend@mozilla.com 1084 expires: never 1085 telemetry_mirror: BROWSER_UI_INTERACTION_TABS_CONTEXT 1086 1087 tabs_context_entrypoint: 1088 type: labeled_counter 1089 description: > 1090 Records a count for each entrypoint (the container of the trigger 1091 node) when an item from the tabs context menu is selected. See 1092 https://firefox-source- 1093 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1094 This metric was generated to correspond to the Legacy Telemetry 1095 scalar browser.ui.interaction.tabs_context_entrypoint. 1096 bugs: 1097 - https://bugzil.la/1804722 1098 data_reviews: 1099 - https://bugzil.la/1804722 1100 notification_emails: 1101 - shong@mozilla.com 1102 - mconley@mozilla.com 1103 expires: never 1104 telemetry_mirror: BROWSER_UI_INTERACTION_TABS_CONTEXT_ENTRYPOINT 1105 1106 content_context: 1107 type: labeled_counter 1108 description: > 1109 Records a count of interactions with items in the content context 1110 menu. See https://firefox-source- 1111 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1112 This metric was generated to correspond to the Legacy Telemetry 1113 scalar browser.ui.interaction.content_context. 1114 bugs: 1115 - https://bugzil.la/1620358 1116 data_reviews: 1117 - https://bugzil.la/1620358 1118 notification_emails: 1119 - shong@mozilla.com 1120 - dtownsend@mozilla.com 1121 expires: never 1122 telemetry_mirror: BROWSER_UI_INTERACTION_CONTENT_CONTEXT 1123 1124 overflow_menu: 1125 type: labeled_counter 1126 description: > 1127 Records a count of interactions with items in the overflow menu. See 1128 https://firefox-source- 1129 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1130 This metric was generated to correspond to the Legacy Telemetry 1131 scalar browser.ui.interaction.overflow_menu. 1132 bugs: 1133 - https://bugzil.la/1620358 1134 data_reviews: 1135 - https://bugzil.la/1620358 1136 notification_emails: 1137 - shong@mozilla.com 1138 - dtownsend@mozilla.com 1139 expires: never 1140 telemetry_mirror: BROWSER_UI_INTERACTION_OVERFLOW_MENU 1141 1142 unified_extensions_area: 1143 type: labeled_counter 1144 description: > 1145 Records a count of interactions with items in the Unified Extensions 1146 area. See https://firefox-source- 1147 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1148 This metric was generated to correspond to the Legacy Telemetry 1149 scalar browser.ui.interaction.unified_extensions_area. 1150 bugs: 1151 - https://bugzil.la/1800114 1152 data_reviews: 1153 - https://bugzil.la/1800114 1154 notification_emails: 1155 - dtownsend@mozilla.com 1156 - mconley@mozilla.com 1157 - wdurand@mozilla.com 1158 expires: never 1159 telemetry_mirror: BROWSER_UI_INTERACTION_UNIFIED_EXTENSIONS_AREA 1160 1161 pinned_overflow_menu: 1162 type: labeled_counter 1163 description: > 1164 Records a count of interactions with items in the pinned area of the 1165 overflow menu. See https://firefox-source- 1166 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1167 This metric was generated to correspond to the Legacy Telemetry 1168 scalar browser.ui.interaction.pinned_overflow_menu. 1169 bugs: 1170 - https://bugzil.la/1620358 1171 data_reviews: 1172 - https://bugzil.la/1620358 1173 notification_emails: 1174 - shong@mozilla.com 1175 - dtownsend@mozilla.com 1176 expires: never 1177 telemetry_mirror: BROWSER_UI_INTERACTION_PINNED_OVERFLOW_MENU 1178 1179 pageaction_urlbar: 1180 type: labeled_counter 1181 description: > 1182 Records a count of interactions with page action items in the url 1183 bar. See https://firefox-source- 1184 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1185 This metric was generated to correspond to the Legacy Telemetry 1186 scalar browser.ui.interaction.pageaction_urlbar. 1187 bugs: 1188 - https://bugzil.la/1620358 1189 data_reviews: 1190 - https://bugzil.la/1620358 1191 notification_emails: 1192 - shong@mozilla.com 1193 - dtownsend@mozilla.com 1194 expires: never 1195 telemetry_mirror: BROWSER_UI_INTERACTION_PAGEACTION_URLBAR 1196 1197 pageaction_panel: 1198 type: labeled_counter 1199 description: > 1200 Records a count of interactions with page action items in the panel. 1201 See https://firefox-source- 1202 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1203 This metric was generated to correspond to the Legacy Telemetry 1204 scalar browser.ui.interaction.pageaction_panel. 1205 bugs: 1206 - https://bugzil.la/1620358 1207 data_reviews: 1208 - https://bugzil.la/1620358 1209 notification_emails: 1210 - shong@mozilla.com 1211 - dtownsend@mozilla.com 1212 expires: never 1213 telemetry_mirror: BROWSER_UI_INTERACTION_PAGEACTION_PANEL 1214 1215 preferences_pane_home: 1216 type: labeled_counter 1217 description: > 1218 Records the items interacted with in the Home section of 1219 preferences. See https://firefox-source- 1220 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1221 This metric was generated to correspond to the Legacy Telemetry 1222 scalar browser.ui.interaction.preferences_paneHome. 1223 bugs: 1224 - https://bugzil.la/1620358 1225 data_reviews: 1226 - https://bugzil.la/1620358 1227 notification_emails: 1228 - shong@mozilla.com 1229 - dtownsend@mozilla.com 1230 expires: never 1231 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANEHOME 1232 1233 preferences_pane_general: 1234 type: labeled_counter 1235 description: > 1236 Records the items interacted with in the General section of 1237 preferences. See https://firefox-source- 1238 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1239 This metric was generated to correspond to the Legacy Telemetry 1240 scalar browser.ui.interaction.preferences_paneGeneral. 1241 bugs: 1242 - https://bugzil.la/1620358 1243 data_reviews: 1244 - https://bugzil.la/1620358 1245 notification_emails: 1246 - shong@mozilla.com 1247 - dtownsend@mozilla.com 1248 expires: never 1249 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANEGENERAL 1250 1251 preferences_pane_privacy: 1252 type: labeled_counter 1253 description: > 1254 Records the items interacted with in the Privacy section of 1255 preferences. See https://firefox-source- 1256 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1257 This metric was generated to correspond to the Legacy Telemetry 1258 scalar browser.ui.interaction.preferences_panePrivacy. 1259 bugs: 1260 - https://bugzil.la/1620358 1261 data_reviews: 1262 - https://bugzil.la/1620358 1263 notification_emails: 1264 - shong@mozilla.com 1265 - dtownsend@mozilla.com 1266 expires: never 1267 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANEPRIVACY 1268 1269 preferences_pane_search: 1270 type: labeled_counter 1271 description: > 1272 Records the items interacted with in the Search section of 1273 preferences. See https://firefox-source- 1274 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1275 This metric was generated to correspond to the Legacy Telemetry 1276 scalar browser.ui.interaction.preferences_paneSearch. 1277 bugs: 1278 - https://bugzil.la/1620358 1279 data_reviews: 1280 - https://bugzil.la/1620358 1281 notification_emails: 1282 - shong@mozilla.com 1283 - dtownsend@mozilla.com 1284 expires: never 1285 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANESEARCH 1286 1287 preferences_pane_search_results: 1288 type: labeled_counter 1289 description: > 1290 Records the items interacted with in the Search results section of 1291 preferences. See https://firefox-source- 1292 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1293 This metric was generated to correspond to the Legacy Telemetry 1294 scalar browser.ui.interaction.preferences_paneSearchResults. 1295 bugs: 1296 - https://bugzil.la/1620358 1297 data_reviews: 1298 - https://bugzil.la/1620358 1299 notification_emails: 1300 - shong@mozilla.com 1301 - dtownsend@mozilla.com 1302 expires: never 1303 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANESEARCHRESULTS 1304 1305 preferences_pane_sync: 1306 type: labeled_counter 1307 description: > 1308 Records the items interacted with in the Sync section of 1309 preferences. See https://firefox-source- 1310 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1311 This metric was generated to correspond to the Legacy Telemetry 1312 scalar browser.ui.interaction.preferences_paneSync. 1313 bugs: 1314 - https://bugzil.la/1620358 1315 data_reviews: 1316 - https://bugzil.la/1620358 1317 notification_emails: 1318 - shong@mozilla.com 1319 - dtownsend@mozilla.com 1320 expires: never 1321 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANESYNC 1322 1323 preferences_pane_containers: 1324 type: labeled_counter 1325 description: > 1326 Records the items interacted with in the Containers section of 1327 preferences. See https://firefox-source- 1328 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1329 This metric was generated to correspond to the Legacy Telemetry 1330 scalar browser.ui.interaction.preferences_paneContainers. 1331 bugs: 1332 - https://bugzil.la/1620358 1333 data_reviews: 1334 - https://bugzil.la/1620358 1335 notification_emails: 1336 - shong@mozilla.com 1337 - dtownsend@mozilla.com 1338 expires: never 1339 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANECONTAINERS 1340 1341 preferences_pane_experimental: 1342 type: labeled_counter 1343 description: > 1344 Records the items interacted with in the Experimental section of 1345 preferences. See https://firefox-source- 1346 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1347 This metric was generated to correspond to the Legacy Telemetry 1348 scalar browser.ui.interaction.preferences_paneExperimental. 1349 bugs: 1350 - https://bugzil.la/1620358 1351 - https://bugzil.la/1651986 1352 data_reviews: 1353 - https://bugzil.la/1620358 1354 - https://bugzil.la/1651986 1355 notification_emails: 1356 - shong@mozilla.com 1357 - dtownsend@mozilla.com 1358 expires: never 1359 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANEEXPERIMENTAL 1360 1361 preferences_pane_more_from_mozilla: 1362 type: labeled_counter 1363 description: > 1364 Records the items interacted with in the More From Mozilla section 1365 of preferences. See https://firefox-source- 1366 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1367 This metric was generated to correspond to the Legacy Telemetry 1368 scalar browser.ui.interaction.preferences_paneMoreFromMozilla. 1369 bugs: 1370 - https://bugzil.la/1738187 1371 data_reviews: 1372 - https://bugzil.la/1738187 1373 notification_emails: 1374 - shong@mozilla.com 1375 - pdahiya@mozilla.com 1376 expires: never 1377 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANEMOREFROMMOZILLA 1378 1379 preferences_pane_unknown: 1380 type: labeled_counter 1381 description: > 1382 Records the items interacted with in any other section of 1383 preferences. See https://firefox-source- 1384 docs.mozilla.org/browser/BrowserUsageTelemetry.html 1385 This metric was generated to correspond to the Legacy Telemetry 1386 scalar browser.ui.interaction.preferences_paneUnknown. 1387 bugs: 1388 - https://bugzil.la/1620358 1389 - https://bugzil.la/1651986 1390 data_reviews: 1391 - https://bugzil.la/1620358 1392 - https://bugzil.la/1651986 1393 notification_emails: 1394 - shong@mozilla.com 1395 - dtownsend@mozilla.com 1396 expires: never 1397 telemetry_mirror: BROWSER_UI_INTERACTION_PREFERENCES_PANEUNKNOWN 1398 1399 timestamps: 1400 about_home_topsites_first_paint: 1401 type: quantity 1402 description: > 1403 Record the timestamp of when the first about:home's Topsites are 1404 painted. Only records if about:home is set as the default homepage, 1405 and if sessions are not being restored by default. 1406 This metric was generated to correspond to the Legacy Telemetry 1407 scalar timestamps.about_home_topsites_first_paint. 1408 bugs: 1409 - https://bugzil.la/1518521 1410 data_reviews: 1411 - https://bugzil.la/1518521 1412 notification_emails: 1413 - perf-telemetry-alerts@mozilla.com 1414 - mconley@mozilla.com 1415 expires: never 1416 unit: ms 1417 telemetry_mirror: TIMESTAMPS_ABOUT_HOME_TOPSITES_FIRST_PAINT 1418 1419 browser.sanitizer: 1420 total: 1421 type: timing_distribution 1422 description: > 1423 Sanitize: Total time it takes to sanitize (ms) 1424 1425 This metric was generated to correspond to the Legacy Telemetry 1426 exponential histogram FX_SANITIZE_TOTAL. 1427 time_unit: millisecond 1428 bugs: 1429 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1430 data_reviews: 1431 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1432 notification_emails: 1433 - mbonardo@mozilla.com 1434 expires: never 1435 telemetry_mirror: FX_SANITIZE_TOTAL 1436 1437 cache: 1438 type: timing_distribution 1439 description: > 1440 Sanitize: Time it takes to sanitize the cache (ms) 1441 1442 This metric was generated to correspond to the Legacy Telemetry 1443 exponential histogram FX_SANITIZE_CACHE. 1444 time_unit: millisecond 1445 bugs: 1446 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1447 data_reviews: 1448 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1449 notification_emails: 1450 - mbonardo@mozilla.com 1451 expires: never 1452 telemetry_mirror: FX_SANITIZE_CACHE 1453 1454 cookies: 1455 type: timing_distribution 1456 description: > 1457 Sanitize: Time it takes to sanitize firefox cookies (ms). A subset of 1458 FX_SANITIZE_COOKIES. 1459 1460 This metric was generated to correspond to the Legacy Telemetry 1461 exponential histogram FX_SANITIZE_COOKIES_2. 1462 time_unit: millisecond 1463 bugs: 1464 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1465 data_reviews: 1466 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1467 notification_emails: 1468 - mbonardo@mozilla.com 1469 expires: never 1470 telemetry_mirror: FX_SANITIZE_COOKIES_2 1471 1472 history: 1473 type: timing_distribution 1474 description: > 1475 Sanitize: Time it takes to sanitize history (ms) 1476 1477 This metric was generated to correspond to the Legacy Telemetry 1478 exponential histogram FX_SANITIZE_HISTORY. 1479 time_unit: millisecond 1480 bugs: 1481 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1482 data_reviews: 1483 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1484 notification_emails: 1485 - mbonardo@mozilla.com 1486 expires: never 1487 telemetry_mirror: FX_SANITIZE_HISTORY 1488 1489 formdata: 1490 type: timing_distribution 1491 description: > 1492 Sanitize: Time it takes to sanitize stored form data (ms) 1493 1494 This metric was generated to correspond to the Legacy Telemetry 1495 exponential histogram FX_SANITIZE_FORMDATA. 1496 time_unit: millisecond 1497 bugs: 1498 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1499 data_reviews: 1500 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1501 notification_emails: 1502 - mbonardo@mozilla.com 1503 expires: never 1504 telemetry_mirror: FX_SANITIZE_FORMDATA 1505 1506 downloads: 1507 type: timing_distribution 1508 description: > 1509 Sanitize: Time it takes to sanitize recent downloads (ms) 1510 1511 This metric was generated to correspond to the Legacy Telemetry 1512 exponential histogram FX_SANITIZE_DOWNLOADS. 1513 time_unit: millisecond 1514 bugs: 1515 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1516 data_reviews: 1517 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1518 notification_emails: 1519 - mbonardo@mozilla.com 1520 expires: never 1521 telemetry_mirror: FX_SANITIZE_DOWNLOADS 1522 1523 sessions: 1524 type: timing_distribution 1525 description: > 1526 Sanitize: Time it takes to sanitize saved sessions (ms) 1527 1528 This metric was generated to correspond to the Legacy Telemetry 1529 exponential histogram FX_SANITIZE_SESSIONS. 1530 time_unit: millisecond 1531 bugs: 1532 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1533 data_reviews: 1534 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1535 notification_emails: 1536 - mbonardo@mozilla.com 1537 expires: never 1538 telemetry_mirror: FX_SANITIZE_SESSIONS 1539 1540 sitesettings: 1541 type: timing_distribution 1542 description: > 1543 Sanitize: Time it takes to sanitize site-specific settings (ms) 1544 1545 This metric was generated to correspond to the Legacy Telemetry 1546 exponential histogram FX_SANITIZE_SITESETTINGS. 1547 time_unit: millisecond 1548 bugs: 1549 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1550 data_reviews: 1551 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1552 notification_emails: 1553 - mbonardo@mozilla.com 1554 expires: never 1555 telemetry_mirror: FX_SANITIZE_SITESETTINGS 1556 1557 openwindows: 1558 type: timing_distribution 1559 description: > 1560 Sanitize: Time it takes to sanitize the open windows list (ms). On 1561 Android, this is the time it takes to close all open tabs (ms). 1562 1563 This metric was generated to correspond to the Legacy Telemetry 1564 exponential histogram FX_SANITIZE_OPENWINDOWS. 1565 time_unit: millisecond 1566 bugs: 1567 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1568 data_reviews: 1569 - https://bugzilla.mozilla.org/show_bug.cgi?id=1944631 1570 notification_emails: 1571 - mbonardo@mozilla.com 1572 expires: never 1573 telemetry_mirror: FX_SANITIZE_OPENWINDOWS 1574 1575 browser.content_crash: 1576 dump_unavailable: 1577 type: counter 1578 description: > 1579 Counts the number of times that about:tabcrashed was unable to find a 1580 crash dump. 1581 1582 This metric was generated to correspond to the Legacy Telemetry count 1583 histogram FX_CONTENT_CRASH_DUMP_UNAVAILABLE. 1584 bugs: 1585 - https://bugzilla.mozilla.org/show_bug.cgi?id=1269961 1586 data_reviews: 1587 - https://bugzilla.mozilla.org/show_bug.cgi?id=1269961 1588 notification_emails: 1589 - wmccloskey@mozilla.com 1590 expires: never 1591 telemetry_mirror: h#FX_CONTENT_CRASH_DUMP_UNAVAILABLE 1592 1593 not_submitted: 1594 type: counter 1595 description: > 1596 Counts the number of times that about:tabcrashed was unloaded without 1597 submitting. 1598 1599 This metric was generated to correspond to the Legacy Telemetry count 1600 histogram FX_CONTENT_CRASH_NOT_SUBMITTED. 1601 bugs: 1602 - https://bugzilla.mozilla.org/show_bug.cgi?id=1269961 1603 data_reviews: 1604 - https://bugzilla.mozilla.org/show_bug.cgi?id=1269961 1605 notification_emails: 1606 - wmccloskey@mozilla.com 1607 expires: never 1608 telemetry_mirror: h#FX_CONTENT_CRASH_NOT_SUBMITTED 1609 1610 link_icon_sizes_attr: 1611 usage: 1612 type: custom_distribution 1613 description: > 1614 The possible types of the 'sizes' attribute for <link rel=icon>. 0: 1615 Attribute not specified, 1: 'any', 2: Integer dimensions, 3: Invalid 1616 value. 1617 1618 This metric was generated to correspond to the Legacy Telemetry enumerated 1619 histogram LINK_ICON_SIZES_ATTR_USAGE. 1620 range_min: 0 1621 range_max: 4 1622 bucket_count: 5 1623 histogram_type: linear 1624 bugs: 1625 - https://bugzilla.mozilla.org/show_bug.cgi?id=1053467 1626 data_reviews: 1627 - https://bugzilla.mozilla.org/show_bug.cgi?id=1053467 1628 notification_emails: 1629 - fx-search-telemetry@mozilla.com 1630 expires: never 1631 telemetry_mirror: LINK_ICON_SIZES_ATTR_USAGE 1632 1633 dimension: 1634 type: custom_distribution 1635 description: > 1636 The width dimension of the 'sizes' attribute for <link rel=icon>. 1637 1638 This metric was generated to correspond to the Legacy Telemetry linear 1639 histogram LINK_ICON_SIZES_ATTR_DIMENSION. 1640 range_min: 1 1641 range_max: 513 1642 bucket_count: 64 1643 histogram_type: linear 1644 unit: pixel 1645 bugs: 1646 - https://bugzilla.mozilla.org/show_bug.cgi?id=1053467 1647 data_reviews: 1648 - https://bugzilla.mozilla.org/show_bug.cgi?id=1053467 1649 notification_emails: 1650 - fx-search-telemetry@mozilla.com 1651 expires: never 1652 telemetry_mirror: LINK_ICON_SIZES_ATTR_DIMENSION 1653 1654 contextual_services: 1655 context_id: 1656 type: uuid 1657 description: > 1658 An identifier for Contextual Services user interaction pings. This is 1659 used internally for counting unique users as well as for anti-fraud. It 1660 is shared with other Contextual Services. 1661 1662 Does not need to be sent in the Glean "deletion-request" ping. It is sent 1663 in its own "context-id-deletion-request" ping. 1664 bugs: 1665 - https://bugzilla.mozilla.org/show_bug.cgi?id=1952316 1666 data_reviews: 1667 - https://bugzilla.mozilla.org/show_bug.cgi?id=1952316 1668 data_sensitivity: 1669 - technical 1670 notification_emails: 1671 - mconley@mozilla.com 1672 expires: never 1673 send_in_pings: 1674 - context-id-deletion-request