You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
iceraven-browser/docs/metrics.md

139 KiB

Metrics

This document enumerates the metrics collected by this project using the Glean SDK. This project may depend on other projects which also collect metrics. This means you might have to go searching through the dependency tree to get a full picture of everything collected by this project.

Pings

activation

This ping is intended to provide a measure of the activation of mobile products. It's generated when Fenix starts, right after Glean is initialized. It doesn't include the client_id, since it might be reporting an hashed version of the Google Advertising ID.

Data reviews for this ping:

Bugs related to this ping:

All Glean pings contain built-in metrics in the ping_info and client_info sections.

In addition to those built-in metrics, the following metrics are added to the ping:

Name Type Description Data reviews Extras Expiration Data Sensitivity
activation.activation_id uuid An alternate identifier, not correlated with the client_id, generated once and only sent with the activation ping. mozilla-mobile/fenix#1707, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 4
activation.identifier string A hashed and salted version of the Google Advertising ID from the device. This will never be sent in a ping that also contains the client_id. mozilla-mobile/fenix#1707, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 4

events

This is a built-in ping that is assembled out of the box by the Glean SDK.

See the Glean SDK documentation for the events ping.

All Glean pings contain built-in metrics in the ping_info and client_info sections.

In addition to those built-in metrics, the following metrics are added to the ping:

Name Type Description Data reviews Extras Expiration Data Sensitivity
about_page.privacy_notice_tapped event A user tapped on "Privacy notice" item from About page mozilla-mobile/fenix#8047, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
about_page.support_tapped event A user tapped on "Support" item from About page mozilla-mobile/fenix#8047, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
addons.open_addon_in_toolbar_menu event A user interacted with an installed add-on in the toolbar menu mozilla-mobile/fenix#8318, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • addon_id: The id of the add-on that was interacted with in the toolbar menu
2021-07-01 2
addons.open_addon_setting event A user opened an add-on's setting mozilla-mobile/fenix#18504
  • addon_id: The id of the add-on that was interacted with
2022-08-01 2
addons.open_addons_in_settings event A user accessed "Add-ons" from the Settings mozilla-mobile/fenix#8318, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
android_keystore_experiment.experiment_failure event Records an instance of an unexpected failure during the experiment mozilla-mobile/fenix#18333
  • failure_exception: Exception class associated with an unexpected failure of this experiment, not caught by the other failure handlers.
2021-09-01 1
android_keystore_experiment.get_failure event Unexpected failure when trying to read from secure prefs. mozilla-mobile/fenix#18333
  • failure_exception: Exception class associated with an unexpected failure of this experiment.
2021-09-01 1
android_keystore_experiment.get_result event Success when trying to read from secure prefs. mozilla-mobile/fenix#18333
  • result: Result code identifying whether the read operation returned the expected value or not.
2021-09-01 1
android_keystore_experiment.reset event An experiment failed, and was reset to run again in the future from a blank state. mozilla-mobile/fenix#18333 2021-09-01 1
android_keystore_experiment.write_failure event Unexpected failure when trying to write to secure prefs. mozilla-mobile/fenix#18333
  • failure_exception: Exception class associated with an unexpected failure of this experiment.
2021-09-01 1
android_keystore_experiment.write_success event Success in writing to secure prefs. mozilla-mobile/fenix#18333 2021-09-01 1
app_theme.dark_theme_selected event A user selected Dark Theme mozilla-mobile/fenix#7968, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • source: The source from where dark theme was selected. The source can be 'SETTINGS' or 'ONBOARDING'
2021-07-01 2
autoplay.setting_changed event A user changed their autoplay setting to either block_cellular, block_audio, or block_all. mozilla-mobile/fenix#13041
  • autoplay_setting: The new setting for autoplay: block_cellular, block_audio, or block_all.
2021-08-01 2
autoplay.visited_setting event A user visited the autoplay settings screen mozilla-mobile/fenix#13041 2021-08-01 2
awesomebar.bookmark_suggestion_clicked event The bookmark suggestion in awesomebar was clicked. mozilla-mobile/fenix#18090 2021-08-01 2
awesomebar.clipboard_suggestion_clicked event The clipboard suggestion in awesomebar was clicked. mozilla-mobile/fenix#18090 2021-08-01 2
awesomebar.history_suggestion_clicked event The history suggestion in awesomebar was clicked. mozilla-mobile/fenix#18090 2021-08-01 2
awesomebar.opened_tab_suggestion_clicked event The opened tab suggestion in awesomebar was clicked. mozilla-mobile/fenix#18090 2021-08-01 2
awesomebar.search_action_clicked event The search action in awesomebar was clicked. mozilla-mobile/fenix#18090 2021-08-01 2
awesomebar.search_suggestion_clicked event The search suggestion in awesomebar was clicked. mozilla-mobile/fenix#18090 2021-08-01 2
banner_open_in_app.dismissed event User tapped 'dismiss' on Open in App banner. mozilla-mobile/fenix#17049 2021-08-01 2
banner_open_in_app.displayed event Open in App banner was shown. mozilla-mobile/fenix#17049 2021-08-01 2
banner_open_in_app.go_to_settings event User tapped 'go to settings' on Open in App banner. mozilla-mobile/fenix#17049 2021-08-01 2
bookmarks_management.copied event A user copied a bookmark. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.edited event A user edited the title and/or URL of an existing bookmark. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.folder_add event A user added a new bookmark folder. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.folder_remove event A user removed a bookmark folder. mozilla-mobile/fenix#3724, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.moved event A user moved an existing bookmark or folder to another folder. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.multi_removed event A user removed multiple bookmarks at once. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.open event A user opened a bookmark. mozilla-mobile/fenix#18174 2022-08-01 2
bookmarks_management.open_in_new_tab event A user opened a bookmark in a new tab. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.open_in_new_tabs event A user opened multiple bookmarks at once in new tabs. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.open_in_private_tab event A user opened a bookmark in a new private tab. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.open_in_private_tabs event A user opened multiple bookmarks at once in new private tabs. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.removed event A user removed a bookmark item. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
bookmarks_management.shared event A user shared a bookmark. mozilla-mobile/fenix#1708, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
collections.add_tab_button event A user tapped the "add tab" button in the three dot menu of collections mozilla-mobile/fenix#4358, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
collections.all_tabs_restored event A user tapped "open tabs" from collection menu mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 1, 2
collections.long_press event A user long pressed on a tab, triggering the collection creation screen mozilla-mobile/fenix#4358, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
collections.removed event A user tapped delete collection from collection menu mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 1, 2
collections.rename_button event A user pressed the "rename collection" button in the three dot menu mozilla-mobile/fenix#4539, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
collections.renamed event A user renamed a collection mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 1, 2
collections.save_button event A user pressed the "save to collection" button on either the home or browser screen, triggering the collection creation screen to open (tab_select_opened) mozilla-mobile/fenix#4358, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • from_screen: A string representing the screen from which the user pressed the save button. Currently one of: browserMenu, homeMenu or home
2021-07-01 2
collections.saved event A user saved a list of tabs to a new collection mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • tabs_open: The number of tabs open in the current session
  • tabs_selected: The number of tabs added to the collection
2021-07-01 1, 2
collections.shared event A user tapped share collection mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 1, 2
collections.tab_removed event A user tapped remove tab from collection tab list mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 1, 2
collections.tab_restored event A user restored a tab from collection tab list mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 1, 2
collections.tab_select_opened event A user opened the select tabs screen (the first step of the collection creation flow) mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 1, 2
collections.tabs_added event A user saved a list of tabs to an existing collection mozilla-mobile/fenix#3935, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • tabs_open: The number of tabs open in the current session
  • tabs_selected: The number of tabs added to the collection
2021-07-01 1, 2
context_menu.item_tapped event A user tapped an item in the browsers context menu mozilla-mobile/fenix#1344, mozilla-mobile/fenix#13958, mozilla-mobile/fenix/issues/16076, mozilla-mobile/fenix#18143
  • named: The name of the item that was tapped. Available items are: open_in_new_tab, open_in_private_tab, open_image_in_new_tab, save_image, share_link, copy_link, copy_image_location, share_image
2021-07-01 2
contextual_hint.tracking_protection.dismiss event The enhanced tracking protection contextual hint was dismissed by pressing the close button mozilla-mobile/fenix#11923, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
contextual_hint.tracking_protection.display event The enhanced tracking protection contextual hint was displayed. mozilla-mobile/fenix#11923, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
contextual_hint.tracking_protection.inside_tap event The user tapped inside of the etp contextual hint (which brings up the etp panel for this site). mozilla-mobile/fenix#11923, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
contextual_hint.tracking_protection.outside_tap event The user tapped outside of the etp contextual hint (which has no effect). mozilla-mobile/fenix#11923, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
contextual_menu.copy_tapped event The context menu's 'copy' option was used. mozilla-mobile/fenix#16968 2021-06-01 2
contextual_menu.search_tapped event The context menu's 'search' option was used. mozilla-mobile/fenix#16968 2021-06-01 2
contextual_menu.select_all_tapped event The context menu's 'select all' option was used. mozilla-mobile/fenix#16968 2021-06-01 2
contextual_menu.share_tapped event The context menu's 'share' option was used. mozilla-mobile/fenix#16968 2021-06-01 2
crash_reporter.closed event The crash reporter was closed mozilla-mobile/fenix#1214, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • crash_submitted: A boolean that tells us whether or not the user submitted a crash report
2021-07-01 2
crash_reporter.opened event The crash reporter was displayed mozilla-mobile/fenix#1214, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
custom_tab.action_button event A user pressed the action button provided by the launching app mozilla-mobile/fenix#1697, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
custom_tab.closed event A user closed the custom tab mozilla-mobile/fenix#1697, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
custom_tab.menu event A user opened the custom tabs menu mozilla-mobile/fenix#1697, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
download_notification.cancel event A user cancelled a download in the download notification mozilla-mobile/fenix#6554, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
download_notification.in_app_open event A user opened a downloaded file in the in-app notification link mozilla-mobile/fenix#6554, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
download_notification.in_app_try_again event A user tapped on try again when a download fails in the in-app notification link mozilla-mobile/fenix#6554, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
download_notification.open event A user opened a downloaded file in the download notification mozilla-mobile/fenix#6554, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
download_notification.pause event A user paused a download in the download notification mozilla-mobile/fenix#6554, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
download_notification.resume event A user resumed a download in the download notification mozilla-mobile/fenix#6554, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
download_notification.try_again event A user tapped on try again when a download fails in the download notification mozilla-mobile/fenix#6554, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
downloads_management.downloads_screen_opened event A counter for the number of times users access the "Downloads" folder inside the app. mozilla-mobile/fenix#16728, mozilla-mobile/fenix#18143 2021-07-01
downloads_management.item_deleted event A counter for how often a user deletes one / more downloads at a time. mozilla-mobile/fenix#16728, mozilla-mobile/fenix#18143 2021-07-01
downloads_management.item_opened event A counter for how often a user tap to opens a download from inside the "Downloads" folder. mozilla-mobile/fenix#16728, mozilla-mobile/fenix#18143 2021-07-01
downloads_misc.download_added event A counter for how many times something is downloaded in the app. mozilla-mobile/fenix#16730, mozilla-mobile/fenix#18143 2021-07-01
engine_tab.foreground_metrics event Event collecting data about the state of tabs when the app comes back to the foreground. mozilla-mobile/fenix#18747
  • background_active_tabs: Number of active tabs (with an engine session assigned) when the app went to the background.
  • background_crashed_tabs: Number of tabs marked as crashed when the app went to the background.
  • background_total_tabs: Number of total tabs when the app went to the background.
  • foreground_active_tabs: Number of active tabs (with an engine session assigned) when the app came back to the foreground.
  • foreground_crashed_tabs: Number of tabs marked as crashed when the app came back to the foreground.
  • foreground_total_tabs: Number of total tabs when the app came back to the foreground.
  • time_in_background: Time (in milliseconds) the app was in the background.
2021-12-31 1
error_page.visited_error event A user encountered an error page mozilla-mobile/fenix#2491, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • error_type: The error type of the error page encountered
2021-07-01 2
events.app_opened event A user opened the app (from cold start, to the homescreen or browser) mozilla-mobile/fenix#1067, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • source: The method used to open Fenix. Possible values are: app_icon, custom_tab or link
2021-07-01 2
events.app_opened_all_startup event This probe has a known flaw: for COLD start up, it doesn't take into account if the process is already running when the app starts, possibly inflating results (e.g. a Service started the process 20min ago and only now is HomeActivity launching). See the cold_*_app_to_first_frame probes for a replacement.

A user opened the app to the HomeActivity. The HomeActivity encompasses the home screen, browser screen, settings screen, collections and other screens in the nav_graph. This differs from the app_opened probe because it measures all startups, not just cold startup. Note: There is a short gap between the time application goes into background and the time android reports the application going into the background. Note: This metric does not record souce when app opened from task switcher: open application -> press home button -> open recent tasks -> choose fenix. In this case will report [source = unknown, type = hot, has_saved_instance_state = false].
mozilla-mobile/fenix#12114, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#13494, mozilla-mobile/fenix#15605
  • first_frame_pre_draw_nanos: the number of nanoseconds the application took to launch. This is the time difference between application launch(user pressing app_icon, launching a link) and until the first view is about to be drawn on the screen. If the time is not captured, this extra key will not be reported.
  • has_saved_instance_state: boolean value whether or not startup type has a savedInstance. using savedInstance, HomeActivity's previous state can be restored. This is an optional key since it is not applicable to all the cases. for example, when we are doing a hot start up, we cant have a savedInstanceState therefore we report only [APP_ICON, HOT] instead of [APP_ICON, HOT, false].
  • source: The method used to open Fenix. Possible values are app_icon, custom_tab, link or unknown. unknown is for startup sources where we can't pinpoint the cause. One UNKNOWN case is the app switcher where we don't know what variables to check to ensure this startup wasn't caused by something else.
  • type: the startup type for opening fenix. the application and HomeActivity either needs to be created or started again. possible values are cold, warm, hot or error. Error is for impossible cases. Please file a bug if you see the error case. app created AND HomeActivity created = cold app started AND HomeActivity created = warm app started AND HomeActivity started = hot app created AND HomeActivity started = error Some applications such as gmail launches the default browser in the background. So when we eventually click a link, browser is already started in the background. This means that custom_tab will mostly report warm startup type.
2021-06-01 2
events.app_received_intent event The system received an Intent for the HomeActivity. An intent is received an external entity wants to the app to display content. Intents can be received when the app is closed at which point the app will be opened or when the app is already opened at which point the already open app will make changes such as loading a url. This can be used loosely as a heuristic for when the user requested to open the app. The HomeActivity encompasses the home screen and browser screen but may include other screens. This differs from the app_opened probe because it measures all startups, not just cold startup. mozilla-mobile/fenix#11940/, mozilla-mobile/fenix#13958
  • source: The method used to open Fenix. Possible values are app_icon, custom_tab, link or unknown
2021-06-01
events.browser_menu_action event A browser menu item was tapped mozilla-mobile/fenix#1214, mozilla-mobile/fenix#5098, mozilla-mobile/fenix#6310, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • item: A string containing the name of the item the user tapped. These items include: Settings, Help, Desktop Site toggle on/off, Find in Page, New Tab, Private Tab, Share, Report Site Issue, Back/Forward button, Reload Button, Quit, Reader Mode On, Reader Mode Off, Open In app, Add To Top Sites, Add-ons Manager, Bookmarks, History
2021-07-01 2
events.copy_url_tapped event An event that indicates that a user has selected copy option when long pressing on url bar. mozilla-mobile/fenix#16915 2021-05-10 2
events.default_browser_changed event Indicates the default browser was changed mozilla-mobile/fenix#18895 2021-10-01 2
events.entered_url event A user entered a url mozilla-mobile/fenix#1067, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • autocomplete: A boolean that tells us whether the URL was autofilled by an Autocomplete suggestion
2021-07-01 2
events.opened_link event A user opened a link with Fenix mozilla-mobile/fenix#5975, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
events.performed_search event A user performed a search mozilla-mobile/fenix#1067, mozilla-mobile/fenix#1677, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • source: A string that tells us how the user performed the search. Possible values are: * default.action * default.suggestion * shortcut.action * shortcut.suggestion
2021-07-01 2
events.preference_toggled event A user toggled a boolean preference in settings mozilla-mobile/fenix#1896, mozilla-mobile/fenix#5704, mozilla-mobile/fenix#5886, mozilla-mobile/fenix#5975, mozilla-mobile/fenix#6352, mozilla-mobile/fenix#6601, mozilla-mobile/fenix#6746, mozilla-mobile/fenix#13958
  • enabled: Whether or not the preference is now enabled
  • preference_key: The preference key for the boolean (true/false) preference the user toggled. We currently track: show_search_suggestions, remote_debugging, telemetry, tracking_protection, search_bookmarks, search_browsing_history, show_clipboard_suggestions, show_search_shortcuts, open_links_in_a_private_tab (bug in implementation https://github.com/mozilla-mobile/fenix/issues/7384), pref_key_sync_logins, pref_key_sync_bookmarks, pref_key_sync_history, pref_key_show_voice_search, and pref_key_show_search_suggestions_in_private.
2021-06-01 1, 2
events.recently_closed_tabs_opened event An event that indicates that the user has accessed recently closed tabs list. mozilla-mobile/fenix#16739 2021-05-10 2
events.search_bar_tapped event A user tapped the search bar mozilla-mobile/fenix#1067, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • source: The view the user was on when they initiated the search (For example: Home or Browser)
2021-07-01 2
events.synced_tab_opened event An event that indicates that a synced tab was opened. mozilla-mobile/fenix#16727 2021-05-10 2
events.tab_counter_menu_action event A tab counter menu item was tapped mozilla-mobile/fenix#11533, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143
  • item: A string containing the name of the item the user tapped. These items are: New tab, New private tab, Close tab
2021-07-01 2
events.toolbar_menu_visible event The browser menu was displayed from toolbar menu mozilla-mobile/fenix#18895 2021-10-01 2
events.whats_new_tapped event A user opened the "what's new" page button mozilla-mobile/fenix#5090, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
experiments_default_browser.toolbar_menu_clicked event Set default browser was clicked from toolbar menu mozilla-mobile/fenix#18895 2021-10-01 2
find_in_page.closed event A user closed the find in page UI mozilla-mobile/fenix#1344, mozilla-mobile/fenix#15713 2021-08-01 2
find_in_page.opened event A user opened the find in page UI mozilla-mobile/fenix#1344, mozilla-mobile/fenix#15713 2021-08-01 2
find_in_page.searched_page event A user searched the page mozilla-mobile/fenix#1344, mozilla-mobile/fenix#15713 2021-08-01 2
history.opened event A user opened the history screen mozilla-mobile/fenix#3940, mozilla-mobile/fenix#15713 2021-08-01 2
history.opened_item event A user opened a history item mozilla-mobile/fenix#18261 2022-08-01 2
history.opened_item_in_new_tab event A user opened a history item in a new tab mozilla-mobile/fenix#18261 2022-08-01 2
history.opened_item_in_private_tab event A user opened a history item in a private tab mozilla-mobile/fenix#18261 2022-08-01 2
history.opened_items_in_new_tabs event A user opened multiple history items in new tabs [Review 1](https://gith ub.com/mozilla-mobile/fenix/pull/18261) 2022-08-01 2
history.opened_items_in_private_tabs event A user opened multiple history items in private tabs mozilla-mobile/fenix#18261 2022-08-01 2
history.removed event A user removed a history item mozilla-mobile/fenix#3940, mozilla-mobile/fenix#15713 2021-08-01 2
history.removed_all event A user removed all history items mozilla-mobile/fenix#3940, mozilla-mobile/fenix#15713 2021-08-01 2
history.shared event A user shared a history item mozilla-mobile/fenix#3940, mozilla-mobile/fenix#15713 2021-08-01 2
home_menu.settings_item_clicked event The user clicked the settings option in home menu. mozilla-mobile/fenix#18987 2021-10-01 2
home_screen.home_screen_displayed event The user clicked the settings option in home menu. mozilla-mobile/fenix#19025 2021-10-01 2
login_dialog.cancelled event The login dialog prompt was cancelled mozilla-mobile/fenix#13050 2021-08-01 2
login_dialog.displayed event The login dialog prompt was displayed mozilla-mobile/fenix#13050 2021-08-01 2
login_dialog.never_save event The login dialog prompt "never save" button was pressed mozilla-mobile/fenix#13050 2021-08-01 2
login_dialog.saved event The login dialog prompt "save" button was pressed mozilla-mobile/fenix#13050 2021-08-01 2
logins.copy_login event A user copied a piece of a login in saved logins mozilla-mobile/fenix#6352, mozilla-mobile/fenix#15713 2021-08-01 2
logins.delete_saved_login event A user confirms delete of a saved login mozilla-mobile/fenix/issues/11208, mozilla-mobile/fenix#15713 2021-08-01 2
logins.open_individual_login event A user accessed an individual login in saved logins mozilla-mobile/fenix#6352, mozilla-mobile/fenix#15713 2021-08-01 2
logins.open_login_editor event A user entered the edit screen for an individual saved login mozilla-mobile/fenix/issues/11208, mozilla-mobile/fenix#15713 2021-08-01 2
logins.open_logins event A user accessed Logins in Settings mozilla-mobile/fenix#6352, mozilla-mobile/fenix#15713 2021-08-01 2
logins.save_edited_login event A user saves changes made to an individual login mozilla-mobile/fenix/issues/11208, mozilla-mobile/fenix#15713 2021-08-01 2
logins.save_logins_setting_changed event A user changed their setting for asking to save logins mozilla-mobile/fenix#7767, mozilla-mobile/fenix#15713
  • setting: The new setting for saving logins the user selected. Either ask_to_save or never_save
2021-08-01 2
logins.view_password_login event A user viewed a password in an individual saved login mozilla-mobile/fenix#6352, mozilla-mobile/fenix#15713 2021-08-01 2
master_password.displayed event The master password migration dialog was displayed mozilla-mobile/fenix#14468, mozilla-mobile/fenix#18071 2021-09-01 2
master_password.migration event Logins were successfully migrated using a master password. mozilla-mobile/fenix#14468, mozilla-mobile/fenix#18071 2021-09-01 2
media_notification.pause event A user pressed the pause icon on the media notification mozilla-mobile/fenix#5520, mozilla-mobile/fenix#15713 2021-08-01 2
media_notification.play event A user pressed the play icon on the media notification mozilla-mobile/fenix#5520, mozilla-mobile/fenix#15713 2021-08-01 2
media_state.fullscreen event Video set to fullscreen. mozilla-mobile/fenix#16833 2021-08-01 2
media_state.pause event Media playback was paused. mozilla-mobile/fenix#6463, mozilla-mobile/fenix#15713 2021-08-01 2
media_state.picture_in_picture event Video set to picture in picture mode. mozilla-mobile/fenix#16833 2021-08-01 2
media_state.play event Media started playing. mozilla-mobile/fenix#6463, mozilla-mobile/fenix#15713 2021-08-01 2
media_state.stop event Media playback has ended. mozilla-mobile/fenix#6463, mozilla-mobile/fenix#15713 2021-08-01 2
onboarding.finish event The user taps starts browsing and ends the onboarding experience. mozilla-mobile/fenix#11867, mozilla-mobile/fenix#15713 2021-08-01 2
onboarding.fxa_auto_signin event The onboarding automatic sign in card was tapped. mozilla-mobile/fenix#11867, mozilla-mobile/fenix#15713 2021-08-01 2
onboarding.fxa_manual_signin event The onboarding manual sign in card was tapped. mozilla-mobile/fenix#11867, mozilla-mobile/fenix#15713 2021-08-01 2
onboarding.pref_toggled_private_browsing event The private browsing preference was selected from the onboarding card. mozilla-mobile/fenix#11867, mozilla-mobile/fenix#15713 2021-08-01 2
onboarding.pref_toggled_theme_picker event The device theme was chosen using the theme picker onboarding card. mozilla-mobile/fenix#11867, mozilla-mobile/fenix#15713
  • theme: A string that indicates the theme LIGHT, DARK, or FOLLOW DEVICE. Default: FOLLOW DEVICE
2021-08-01 2
onboarding.pref_toggled_toolbar_position event The toolbar position preference was chosen from the onboarding card. mozilla-mobile/fenix#11867, mozilla-mobile/fenix#15713
  • position: A string that indicates the position of the toolbar TOP or BOTTOM. Default: BOTTOM
2021-08-01 2
onboarding.pref_toggled_tracking_prot event The tracking protection preference was chosen from the onboarding card. mozilla-mobile/fenix#11867, mozilla-mobile/fenix#15713
  • setting: A string that indicates the Tracking Protection policy STANDARD or STRICT. Default: Toggle ON, STANDARD
2021-08-01 2
onboarding.privacy_notice event The onboarding privacy notice card was tapped. mozilla-mobile/fenix#11867, mozilla-mobile/fenix#15713 2021-08-01 2
pocket.pocket_top_site_clicked event A user clicked on the trending Pocket top site mozilla-mobile/fenix#8098, mozilla-mobile/fenix#15713 2021-08-01 2
pocket.pocket_top_site_removed event A user removed the trending Pocket top site mozilla-mobile/fenix#8098, mozilla-mobile/fenix#15713 2021-08-01 2
private_browsing_mode.notification_tapped event A user pressed the private browsing mode notification itself. mozilla-mobile/fenix#4968, mozilla-mobile/fenix#15713 2021-08-01 2
private_browsing_mode.snackbar_undo event A user pressed the "undo" button in the snackbar that is shown when the garbage icon is tapped. mozilla-mobile/fenix#4968, mozilla-mobile/fenix#15713 2021-08-01 2
private_browsing_shortcut.cfr_add_shortcut event A user pressed the "Add shortcut" button when the contextual feature recommender appeared. mozilla-mobile/fenix#5194, mozilla-mobile/fenix#15713 2021-08-01 2
private_browsing_shortcut.cfr_cancel event A user pressed the "No thanks" button when the contextual feature recommender appeared. mozilla-mobile/fenix#5194, mozilla-mobile/fenix#15713 2021-08-01 2
private_browsing_shortcut.create_shortcut event A user pressed the "Add private browsing shortcut" button in settings. mozilla-mobile/fenix#5194, mozilla-mobile/fenix#15713 2021-08-01 2
private_browsing_shortcut.pinned_shortcut_priv event A user pressed the pinned private shortcut in Android home screen, opening up a new private search. mozilla-mobile/fenix#5194, mozilla-mobile/fenix#15713 2021-08-01 2
private_browsing_shortcut.static_shortcut_priv event A user pressed the long-press shortcut "Open new private tab", opening up a new private search. mozilla-mobile/fenix#5194, mozilla-mobile/fenix#15713 2021-08-01 2
private_browsing_shortcut.static_shortcut_tab event A user pressed the long-press shortcut "Open new tab", opening up a new search. mozilla-mobile/fenix#5194, mozilla-mobile/fenix#15713 2021-08-01 2
progressive_web_app.background event A user puts the PWA into the background. mozilla-mobile/fenix#11859, mozilla-mobile/fenix#18071
  • time_ms: The current time in ms when the PWA was backgrounded.
2021-09-01 2
progressive_web_app.foreground event A user brings the PWA into the foreground. mozilla-mobile/fenix#11859, mozilla-mobile/fenix#18071
  • time_ms: The current time in ms when the PWA was brought to the foreground.
2021-09-01 2
progressive_web_app.homescreen_tap event A user taps on PWA homescreen icon mozilla-mobile/fenix#11859, mozilla-mobile/fenix#18071 2021-09-01 2
progressive_web_app.install_tap event A user installs a PWA. Could be a shortcut or added to homescreen. mozilla-mobile/fenix#11859, mozilla-mobile/fenix#18071 2021-09-01 2
reader_mode.appearance event A user tapped the appearance button mozilla-mobile/fenix#3941, mozilla-mobile/fenix#15713 2021-08-01 2
reader_mode.available event Reader mode is available for the current page mozilla-mobile/fenix#3941, mozilla-mobile/fenix#15713 2021-08-01 2
reader_mode.closed event A user closed reader mode mozilla-mobile/fenix#4328, mozilla-mobile/fenix#15713 2021-08-01 2
reader_mode.opened event A user opened reader mode mozilla-mobile/fenix#3941, mozilla-mobile/fenix#15713 2021-08-01 2
search_shortcuts.selected event A user selected a search shortcut engine to use mozilla-mobile/fenix#1202, mozilla-mobile/fenix#15713
  • engine: The name of the built-in search engine the user selected as a string
2021-08-01
search_suggestions.enable_in_private event A user enabled receiving search suggestions in private sessions mozilla-mobile/fenix#6746, mozilla-mobile/fenix#15713 2021-08-01 1, 2
search_widget.new_tab_button event A user pressed anywhere from the Firefox logo until the start of the microphone icon, opening a new tab search screen. mozilla-mobile/fenix#4714, mozilla-mobile/fenix#15713 2021-08-01 2
search_widget.voice_button event A user pressed the microphone icon, opening a new voice search screen. mozilla-mobile/fenix#4714, mozilla-mobile/fenix#15713 2021-08-01 2
set_default_newtab_experiment.close_experiment_card_clicked event Close experiment card was clicked from new tab screen. mozilla-mobile/fenix#18895 2021-10-01 2
set_default_newtab_experiment.set_default_browser_clicked event Set default browser was clicked from new tab screen. mozilla-mobile/fenix#18895 2021-10-01 2
set_default_setting_experiment.set_default_browser_clicked event Set default browser was clicked from settings screen. mozilla-mobile/fenix#19047 2021-10-01 2
sync_account.opened event A user opened the sync account page mozilla-mobile/fenix#2745, mozilla-mobile/fenix#15713 2021-08-01 2
sync_account.send_tab event A user sent the current tab to another FxA device mozilla-mobile/fenix#5106, mozilla-mobile/fenix#15713 2021-08-01 2
sync_account.sign_in_to_send_tab event A user pressed the "sign in to send tab" button inside the share tab menu mozilla-mobile/fenix#5106, mozilla-mobile/fenix#15713 2021-08-01 2
sync_account.sync_now event A user pressed the sync now button on the sync account page mozilla-mobile/fenix#2745, mozilla-mobile/fenix#15713 2021-08-01 2
sync_auth.closed event A user closed the sync page mozilla-mobile/fenix#2745, mozilla-mobile/fenix#15713 2021-08-01 2
sync_auth.opened event A user opened the sync authentication page mozilla-mobile/fenix#2745, mozilla-mobile/fenix#15713 2021-08-01 2
sync_auth.other_external event User authenticated via FxA using an unknown mechanism. "Known" mechanisms are currently sign-in, sign-up and pairing mozilla-mobile/fenix#4931, mozilla-mobile/fenix#15713 2021-08-01 1, 2
sync_auth.paired event User signed into FxA by pairing with a different Firefox browser, using a QR code mozilla-mobile/fenix#4931, mozilla-mobile/fenix#15713 2021-08-01 1, 2
sync_auth.recovered event Account manager automatically recovered FxA authentication state without direct user involvement mozilla-mobile/fenix#4931, mozilla-mobile/fenix#15713 2021-08-01 1, 2
sync_auth.scan_pairing event A user pressed the scan pairing button on the sync authentication page mozilla-mobile/fenix#2745, mozilla-mobile/fenix#15713 2021-08-01 2
sync_auth.sign_in event A user pressed the sign in button on the sync authentication page and was successfully signed in to FxA mozilla-mobile/fenix#2745, mozilla-mobile/fenix#15713 2021-08-01 2
sync_auth.sign_out event A user pressed the sign out button on the sync account page and was successfully signed out of FxA mozilla-mobile/fenix#2745, mozilla-mobile/fenix#15713 2021-08-01 2
sync_auth.sign_up event User registered a new Firefox Account, and was signed into it mozilla-mobile/fenix#4931, mozilla-mobile/fenix#15713 2021-08-01 1, 2
sync_auth.use_email event A user chose to use their email to sign in instead of scanning a QR code, counterpart to "scan_pairing" mozilla-mobile/fenix#9835, mozilla-mobile/fenix#15713 2021-08-01 2
sync_auth.use_email_problem event A user chose to use their email to sign in after an account problem mozilla-mobile/fenix#9835, mozilla-mobile/fenix#15713 2021-08-01 2
synced_tabs.synced_tabs_suggestion_clicked event The synced tab suggestion in awesomebar was clicked. mozilla-mobile/fenix#18172 2021-08-01 2
tab.media_pause event A user pressed the pause icon on a tab from the home screen mozilla-mobile/fenix#5266, mozilla-mobile/fenix#15713 2021-08-01 2
tab.media_play event A user pressed the play icon on a tab from the home screen mozilla-mobile/fenix#5266, mozilla-mobile/fenix#15713 2021-08-01 2
tabs.setting_opened event The tab settings were opened. mozilla-mobile/fenix#15811 2021-08-01 2
tabs_tray.cfr.dismiss event A user dismisses the tabs tray CFR. mozilla-mobile/fenix#17442, mozilla-mobile/fenix/issues/16485 2021-08-01 2
tabs_tray.cfr.go_to_settings event A user selects the CFR option to navigate to settings. mozilla-mobile/fenix#17442, mozilla-mobile/fenix/issues/16485 2021-08-01 2
tabs_tray.close_all_tabs event A user tapped the close all tabs button in the three dot menu within the tabs tray mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.closed event A user closed the tabs tray mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.closed_existing_tab event A user closed an existing tab mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.menu_opened event A user opened three three dot menu in the tabs tray mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.new_private_tab_tapped event A user opened a new private tab mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.new_tab_tapped event A user opened a new tab mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.normal_mode_tapped event A user switched to normal mode mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.opened event A user opened the tabs tray mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.opened_existing_tab event A user opened an existing tab mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.private_mode_tapped event A user switched to private mode mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.save_to_collection event A user tapped the save to collection button in the tabs tray mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.share_all_tabs event A user tapped the share all tabs button in the three dot menu within the tabs tray mozilla-mobile/fenix#12036, mozilla-mobile/fenix#15713 2021-08-01 2
tabs_tray.synced_mode_tapped event A user switched to synced mode mozilla-mobile/fenix#19004 2022-08-01 2
tip.closed event The tip was closed mozilla-mobile/fenix#9836, mozilla-mobile/fenix#15713
  • identifier: The identifier of the tip closed
2021-08-01 2
tip.displayed event The tip was displayed mozilla-mobile/fenix#9836, mozilla-mobile/fenix#15713
  • identifier: The identifier of the tip displayed
2021-08-01 2
tip.pressed event The tip's button was pressed mozilla-mobile/fenix#9836, mozilla-mobile/fenix#15713
  • identifier: The identifier of the tip the action was taken on
2021-08-01 2
toolbar_settings.changed_position event The user selected a new position for the toolbar mozilla-mobile/fenix#6608, mozilla-mobile/fenix#15713
  • position: A string that indicates the new position of the toolbar TOP or BOTTOM
2021-08-01 2
top_sites.long_press event A user long pressed on a top site mozilla-mobile/fenix#15136, mozilla-mobile/fenix#15713
  • type: The type of top site. Options are: "FRECENCY," "DEFAULT," or "PINNED."
2021-08-01 2
top_sites.open_default event A user opened a default top site mozilla-mobile/fenix#10752, mozilla-mobile/fenix#15713 2021-08-01 2
top_sites.open_frecency event A user opened a frecency top site mozilla-mobile/fenix#15136, mozilla-mobile/fenix#15713 2021-08-01 2
top_sites.open_google_search_attribution event A user opened the google top site mozilla-mobile/fenix#17637 2021-08-01 2
top_sites.open_in_new_tab event A user opens a new tab based on a top site item mozilla-mobile/fenix#7523, mozilla-mobile/fenix#15713 2021-08-01 2
top_sites.open_in_private_tab event A user opens a new private tab based on a top site item mozilla-mobile/fenix#7523, mozilla-mobile/fenix#15713 2021-08-01 2
top_sites.open_pinned event A user opened a pinned top site mozilla-mobile/fenix#15136, mozilla-mobile/fenix#15713 2021-08-01 2
top_sites.remove event A user removes a top site item mozilla-mobile/fenix#7523, mozilla-mobile/fenix#15713 2021-08-01 2
top_sites.swipe_carousel event A user swiped to change the page of the top sites carousel mozilla-mobile/fenix#15136, mozilla-mobile/fenix#15713
  • page: The page number the carousel is now on
2021-08-01 2
tracking_protection.etp_setting_changed event A user changed their tracking protection level setting to either strict, standard, or custom. mozilla-mobile/fenix#5414, mozilla-mobile/fenix#11383, mozilla-mobile/fenix#15713
  • etp_setting: The new setting for ETP: strict, standard, custom
2021-08-01 2
tracking_protection.etp_settings event A user opened tracking protection settings through settings. mozilla-mobile/fenix#5414, mozilla-mobile/fenix#15713 2021-08-01 2
tracking_protection.etp_shield event A user pressed the tracking protection shield icon in toolbar. mozilla-mobile/fenix#5414, mozilla-mobile/fenix#15713 2021-08-01 2
tracking_protection.etp_tracker_list event A user pressed into a list of categorized trackers in tracking protection panel. mozilla-mobile/fenix#5414, mozilla-mobile/fenix#15713 2021-08-01 2
tracking_protection.exception_added event A user added a tracking protection exception through the TP toggle in the panel. mozilla-mobile/fenix#5414, mozilla-mobile/fenix#15713 2021-08-01 2
tracking_protection.panel_settings event A user opened tracking protection settings from the panel. mozilla-mobile/fenix#5414, mozilla-mobile/fenix#15713 2021-08-01 2
user_specified_search_engines.custom_engine_added event A user added a new custom search engine mozilla-mobile/fenix#6918, mozilla-mobile/fenix#15713 2021-08-01 2
user_specified_search_engines.custom_engine_deleted event A user deleted a custom search engine mozilla-mobile/fenix#6918, mozilla-mobile/fenix#15713 2021-08-01 2
voice_search.tapped event A user selected the voice search button on the search screen. mozilla-mobile/fenix#10785, mozilla-mobile/fenix#15713 2021-08-01 2

first-session

This ping is intended to capture the source of the app install on the first session.

This ping includes the client id.

Data reviews for this ping:

Bugs related to this ping:

All Glean pings contain built-in metrics in the ping_info and client_info sections.

In addition to those built-in metrics, the following metrics are added to the ping:

Name Type Description Data reviews Extras Expiration Data Sensitivity
first_session.adgroup string The name of the AdGroup that was used to source this installation. mozilla-mobile/fenix#8074, mozilla-mobile/fenix#15713 2021-08-01 1, 2
first_session.campaign string The name of the campaign that is responsible for this installation. mozilla-mobile/fenix#8074, mozilla-mobile/fenix#15713 2021-08-01 1, 2
first_session.creative string The identifier of the creative material that the user interacted with. mozilla-mobile/fenix#8074, mozilla-mobile/fenix#15713 2021-08-01 1, 2
first_session.network string The name of the Network that sourced this installation. mozilla-mobile/fenix#8074, mozilla-mobile/fenix#15713 2021-08-01 1, 2
first_session.timestamp datetime The Glean generated date and time of the installation. This is unique per app install, though the rest of the data in this ping is from Adjust and will remain static across installs. mozilla-mobile/fenix#8074, mozilla-mobile/fenix#15713 2021-08-01 1, 2

metrics

This is a built-in ping that is assembled out of the box by the Glean SDK.

See the Glean SDK documentation for the metrics ping.

All Glean pings contain built-in metrics in the ping_info and client_info sections.

In addition to those built-in metrics, the following metrics are added to the ping:

Name Type Description Data reviews Extras Expiration Data Sensitivity
addons.enabled_addons string_list A list of all enabled add-ons on the device. mozilla-mobile/fenix#11080, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
addons.has_enabled_addons boolean Whether or not the user has enabled add-ons on the device. mozilla-mobile/fenix#8318, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
addons.has_installed_addons boolean Whether or not the user has installed add-ons on the device. mozilla-mobile/fenix#8318, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
addons.installed_addons string_list A list of all installed add-ons on the device. mozilla-mobile/fenix#11080, mozilla-mobile/fenix#13958, mozilla-mobile/fenix#18143 2021-07-01 2
browser.search.ad_clicks labeled_counter Records clicks of adverts on SERP pages. The key format is . mozilla-mobile/fenix#10112, mozilla-mobile/fenix#15713 2021-08-01 2
browser.search.in_content labeled_counter Records the type of interaction a user has on SERP pages. mozilla-mobile/fenix#10167, mozilla-mobile/fenix#15713 2021-08-01 2
browser.search.with_ads labeled_counter Records counts of SERP pages with adverts displayed. The key format is . mozilla-mobile/fenix#10112, mozilla-mobile/fenix#15713 2021-08-01 2
engine_tab.kill_background_age timing_distribution Measures the age of the engine session of a background tab at the time its content process got killed. mozilla-mobile/fenix#17864 2021-12-31 1
engine_tab.kill_foreground_age timing_distribution Measures the age of the engine session of a foreground (selected) tab at the time its content process got killed. mozilla-mobile/fenix#17864 2021-12-31 1
engine_tab.kills labeled_counter How often was the content process of a foreground (selected) or background tab killed. mozilla-mobile/fenix#17864
  • foreground
  • background
2021-12-31 1
events.normal_and_private_uri_count counter A counter of URIs visited by the user in the current session, including page reloads. This includes private browsing. This does not include background page requests and URIs from embedded pages but may be incremented without user interaction by website scripts that programmatically redirect to a new location. mozilla-mobile/fenix#17935 2022-08-01 2
events.total_uri_count counter A counter of URIs visited by the user in the current session, including page reloads. This does not include background page requests and URIs from embedded pages or private browsing but may be incremented without user interaction by website scripts that programmatically redirect to a new location. mozilla-mobile/fenix#1785, mozilla-mobile/fenix#8314, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.adjust_ad_group string A string containing the Adjust ad group ID from which the user installed Fenix. This will not send on the first session the user runs. If the install is organic, this will be empty. mozilla-mobile/fenix#9253, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.adjust_campaign string A string containing the Adjust campaign ID from which the user installed Fenix. This will not send on the first session the user runs. If the install is organic, this will be empty. mozilla-mobile/fenix#5579, mozilla-mobile/fenix#15713 2021-08-01 1
metrics.adjust_creative string A string containing the Adjust creative ID from which the user installed Fenix. This will not send on the first session the user runs. If the install is organic, this will be empty. mozilla-mobile/fenix#9253, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.adjust_network string A string containing the Adjust network ID from which the user installed Fenix. This will not send on the first session the user runs. If the install is organic, this will be empty. mozilla-mobile/fenix#9253, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.close_tab_setting string A string that indicates the setting for tab closing: MANUAL, ONE_DAY, ONE_WEEK, ONE_MONTH mozilla-mobile/fenix#15811 2021-08-01 2
metrics.default_browser boolean Is Fenix the default browser? mozilla-mobile/fenix#1067, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.default_moz_browser string The name of the default browser on device if and only if it's a Mozilla owned product mozilla-mobile/fenix#1953/, mozilla-mobile/fenix#5216, mozilla-mobile/fenix#15713 2021-08-01 1, 2
metrics.desktop_bookmarks_count counter A counter that indicates how many bookmarks a user has in the desktop folder. This value will only be set if the user has at least one bookmark. If they have 0, this ping will not get sent, resulting in a null value. To disambiguate between a failed desktop_bookmarks_count ping and 0 bookmarks, please see has_desktop_bookmarks. mozilla-mobile/fenix#16942, mozilla-mobile/fenix#16942 2021-08-01 2
metrics.distribution_id string A string containing the distribution identifier. This is currently used to identify installs from Mozilla Online. mozilla-mobile/fenix/issues/16075 never 1
metrics.has_desktop_bookmarks boolean A boolean that indicates if the user has bookmarks in the desktop folder mozilla-mobile/fenix#16942, mozilla-mobile/fenix#16942 2021-08-01 2
metrics.has_mobile_bookmarks boolean A boolean that indicates if the user has bookmarks in the mobile folder mozilla-mobile/fenix#16942, mozilla-mobile/fenix#16942 2021-08-01 2
metrics.has_open_tabs boolean A boolean that indicates if the user has any open NORMAL tabs. mozilla-mobile/fenix#12024, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.has_recent_pwas boolean A boolean that indicates if the user has recently used PWAs. See recently_used_pwa_count for the actual count. mozilla-mobile/fenix#11982, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.has_top_sites boolean A boolean that indicates if the user has top sites mozilla-mobile/fenix#9556, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.mobile_bookmarks_count counter A counter that indicates how many bookmarks a user has in the mobile folder. This value will only be set if the user has at least one bookmark. If they have 0, this ping will not get sent, resulting in a null value. To disambiguate between a failed mobile_bookmarks_count ping and 0 bookmarks, please see has_mobile_bookmarks. mozilla-mobile/fenix#16942, mozilla-mobile/fenix#16942 2021-08-01 2
metrics.mozilla_products string_list A list of all the Mozilla products installed on device. We currently scan for: Firefox, Firefox Beta, Firefox Aurora, Firefox Nightly, Firefox Fdroid, Firefox Lite, Reference Browser, Reference Browser Debug, Fenix, Focus, and Lockwise. mozilla-mobile/fenix#1953/, mozilla-mobile/fenix#5216, mozilla-mobile/fenix#15713 2021-08-01 1, 2
metrics.recently_used_pwa_count counter A counter that indicates how many PWAs a user has recently used. Threshold for "recency" set in HomeActivity#PWA_RECENTLY_USED_THRESHOLD. Currently we are not told by the OS when a PWA is removed by the user, so we use the "recently used" heuristic to judge how many PWAs are still active, as a proxy for "installed". This value will only be set if the user has at least one recently used PWA. If they have 0, this metric will not be sent, resulting in a null value during analysis on the server-side. To disambiguate between a failed recently_used_pwa_count metric and 0 recent PWAs, please see has_recent_pwas. mozilla-mobile/fenix#11982, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.search_count labeled_counter The labels for this counter are <search-engine-name>.<source>. If the search engine is bundled with Fenix search-engine-name will be the name of the search engine. If it's a custom search engine (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the value will be custom. source will be: action, suggestion, widget, shortcut, topsite (depending on the source from which the search started). Also added the other option for the source but it should never enter on this case. mozilla-mobile/fenix#1677, mozilla-mobile/fenix#5216, mozilla-mobile/fenix#7310, mozilla-mobile/fenix#15713 2021-08-01 1, 2
metrics.search_widget_installed boolean Whether or not the search widget is installed mozilla-mobile/fenix#10958, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.start_reason_activity_error boolean The AppStartReasonProvider.ActivityLifecycleCallbacks.onActivityCreated was unexpectedly called twice. We can use this metric to validate our assumptions about how these APIs are called. This probe can be removed once we validate these assumptions. mozilla-mobile/fenix#18632 2021-08-11 1
metrics.start_reason_process_error boolean The AppStartReasonProvider.ProcessLifecycleObserver.onCreate was unexpectedly called twice. We can use this metric to validate our assumptions about how these APIs are called. This probe can be removed once we validate these assumptions. mozilla-mobile/fenix#18632 2021-08-11 1
metrics.tab_view_setting string A string that indicates the setting for tab view: GRID, LIST mozilla-mobile/fenix#15811 2021-08-01 2
metrics.tabs_open_count counter A counter that indicates how many NORMAL tabs a user has open. This value will only be set if the user has at least one open tab. If they have 0, this ping will not get sent, resulting in a null value. To disambiguate between a failed tabs_open_count ping and 0 open tabs, please see has_open_tabs. mozilla-mobile/fenix#12024, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.toolbar_position string A string that indicates the new position of the toolbar TOP or BOTTOM mozilla-mobile/fenix#6608, mozilla-mobile/fenix#15713 2021-08-01 2
metrics.top_sites_count counter A counter that indicates how many top sites a user has. This value will only be set if the user has at least one top site. If they have 0, this ping will not get sent, resulting in a null value. To disambiguate between a failed top_sites_count ping and 0 top sites, please see has_top_sites. mozilla-mobile/fenix#9556, mozilla-mobile/fenix#15713 2021-08-01 2
perf.awesomebar.bookmark_suggestions timing_distribution Duration of a bookmarks awesomebar suggestion query. mozilla-mobile/fenix#10276 2021-11-15 1, 2
perf.awesomebar.clipboard_suggestions timing_distribution Duration of a clipboard awesomebar suggestion query. mozilla-mobile/fenix#10276 2021-11-15 1, 2
perf.awesomebar.history_suggestions timing_distribution Duration of a history awesomebar suggestion query. mozilla-mobile/fenix#10276 2021-11-15 1, 2
perf.awesomebar.search_engine_suggestions timing_distribution Duration of a search engine awesomebar suggestion query. mozilla-mobile/fenix#10276 2021-11-15 1, 2
perf.awesomebar.session_suggestions timing_distribution Duration of a session awesomebar suggestion query. mozilla-mobile/fenix#10276 2021-11-15 1, 2
perf.awesomebar.shortcuts_suggestions timing_distribution Duration of a shortcuts awesomebar suggestion query. mozilla-mobile/fenix#10276 2021-11-15 1, 2
perf.awesomebar.synced_tabs_suggestions timing_distribution Duration of a synced tabs awesomebar suggestion query. mozilla-mobile/fenix#10276 2021-11-15 1, 2
perf.startup.app_on_create_to_glean_init timing_distribution A subsection of the duration of FenixApplication.onCreate and thus the application_on_create probe from the start of the method through when initializeGlean is called. Note: initializeGlean is a no-op for Beta and Release builds which instead initialize it during MigratingFenixApplication, which we don't currently measure. mozilla-mobile/fenix#18525 2021-08-11 1
perf.startup.app_on_create_to_megazord_init timing_distribution A subsection of the duration of FenixApplication.onCreate and thus the application_on_create probe from after the app_on_create_to_glean_init probe until we block for the megazord to complete set up. mozilla-mobile/fenix#18525 2021-08-11 1
perf.startup.app_on_create_to_setup_in_main timing_distribution A subsection of the duration of FenixApplication.onCreate and thus the application_on_create probe from after the app_on_create_to_megazord_init probe until the end of setupInMainProcessOnly, which is expected to be the end of the onCreate call (unless the implementation later changes). mozilla-mobile/fenix#18525 2021-08-11 1
perf.startup.application_on_create timing_distribution The duration of FenixApplication.onCreate in the main process. This does not measure the duration of migration code (via MigratingFenixApplication included in the Beta and Release channels. mozilla-mobile/fenix#17973 2021-08-11 1
perf.startup.base_bfragment_on_create_view timing_distribution The duration of BaseBrowserFragment.onCreateView. mozilla-mobile/fenix#18558 2021-08-11 1
perf.startup.base_bfragment_on_view_created timing_distribution The duration of BaseBrowserFragment.onViewCreated. mozilla-mobile/fenix#18558 2021-08-11 1
perf.startup.cold_main_app_to_first_frame timing_distribution The duration from *Application's initializer to the first Android frame being drawn in a COLD MAIN start up. Notably, this duration omits the time from process start to the initializer (which includes a lengthy dex operation) and the time from the first frame to visual completeness. This probe doesn't measure Custom Tabs or other uses of ExternalAppBrowserActivity to simplify result analysis. The methodology for determining this measurement is imperfect to simplify implementation. Issues may include:
- Not measuring Beta and Release channels (due to MigrationDecisionActivity interrupting the logic).
- Not distinguishing between MAIN to homescreen, onboarding, session restore, others?
- Not choosing to record a MAIN based on what the user would see and thus the core code path (i.e. the thing we want to measure) but rather on the initial Intent state.

The hope is that these cases will not have a significant impact on the end results but, if they appear to, we can replace it with a more complex implementation.

Around April 8, 2021 the implementation was refactored. Functionally, it should be the same but it's noted just in case there are bugs.
mozilla-mobile/fenix#18632 2021-08-11 1
perf.startup.cold_unknwn_app_to_first_frame timing_distribution The duration from *Application's initializer to the first Android frame being drawn in a COLD start up where we can't say it was a MAIN or VIEW start up. The methodology for determining this measurement is imperfect to simplify implementation.

See the cold_main_app_to_first_frame probe docs for known issues and more details.

Around April 8, 2021 the implementation was refactored. Functionally, it should be the same but it's noted just in case there are bugs.
mozilla-mobile/fenix#18632 2021-08-11 1
perf.startup.cold_view_app_to_first_frame timing_distribution The duration from *Application's initializer to the first Android frame being drawn in a COLD VIEW start up. The methodology for determining this measurement is imperfect to simplify implementation. Issues may include:
-Including VIEW intents that aren't valid so take code paths similar to MAIN (this is speculative)

See the cold_main_app_to_first_frame probe docs for other possible known issues and more details.

Around April 8, 2021 the implementation was refactored. Functionally, it should be the same but it's noted just in case there are bugs.
mozilla-mobile/fenix#18632 2021-08-11 1
perf.startup.home_activity_on_create timing_distribution The duration of HomeActivity.onCreate. mozilla-mobile/fenix#17973 2021-08-11 1
perf.startup.home_activity_on_start timing_distribution The duration of HomeActivity.onStart. This may encapsulate HomeFragment or BrowserFragment creation, depending on the code path, so we expect this to take varying amounts of time. As such, this probe may not be easy to interpret directly but we believe collecting it may give us more information about different patterns we might see in performance data. mozilla-mobile/fenix#18558 2021-08-11 1
perf.startup.home_fragment_on_create_view timing_distribution The duration of HomeFragment.onCreateView. mozilla-mobile/fenix#18558 2021-08-11 1
perf.startup.home_fragment_on_view_created timing_distribution The duration of HomeFragment.onViewCreated. mozilla-mobile/fenix#18558 2021-08-11 1
perf.startup.startup_type labeled_counter Indicates how the browser was started. The label is divided into two variables. state is how cached the browser is when started. path is what code path we are expected to take. Together, they create a combined label: state_path. For brevity, the specific states are documented in the Fenix perf glossary.

This implementation is intended to be simple, not comprehensive. We list the implications below.

These ways of opening the app undesirably adds events to our primary buckets (non-unknown cases):
- App switcher cold/warm: cold/warm_ + duplicates path from previous launch
- Home screen shortcuts: *_view
- An Intent is sent internally that's uses ACTION_MAIN or ACTION_VIEW could be: *_main/view (unknown if this ever happens)
- A command-line launch uses ACTION_MAIN or ACTION_VIEW could be: *_main/view

These ways of opening the app undesirably do not add their events to our primary buckets:
- Close and reopen the app very quickly: no event is recorded.

These ways of opening the app don't affect our primary buckets:
- App switcher hot: hot_unknown
- PWA (all states): unknown_unknown
- Custom tab: unknown_view
- Cold start where a service or other non-activity starts the process (not manually tested) - this seems to happen if you have the homescreen widget: unknown_*
- Another activity is drawn before HomeActivity (e.g. widget voice search): unknown_*
- Widget text search: *_unknown

In addition to the events above, the unknown state may be chosen when we were unable to determine a cause due to implementation details or the API was used incorrectly. We may be able to record the events listed above into different buckets but we kept the implementation simple for now.

N.B.: for implementation simplicity, we duplicate the logic in app that determines path so it's not perfectly accurate. In one way, we record we is intended to happen rather than what actually happened (e.g. the user may click a link so we record VIEW but the app does a MAIN by going to the homescreen because the link was invalid).
mozilla-mobile/fenix#19028
  • cold_main
  • cold_view
  • cold_unknown
  • warm_main
  • warm_view
  • warm_unknown
  • hot_main
  • hot_view
  • hot_unknown
  • unknown_main
  • unknown_view
  • unknown_unknown
2021-10-09 2
preferences.accessibility_services string_list Whether or not the user has touch exploration or switch services enabled. These are built into the Android OS, not Fenix prefs. default: "" mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.open_links_in_a_private_tab string_list Whether or not the user has enabled open links in a private tab. default: false mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.open_links_in_app string_list Whether or not the user has the open links in apps feature enabled. default: false mozilla-mobile/fenix#11446, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.remote_debugging string_list Whether or not the user has remote debugging enabled default: false mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.search_bookmarks string_list Whether or not the user has enabled bookmark search suggestions default: true mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.search_browsing_history string_list Whether or not the user has enabled browsing history suggestions. default: true mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.search_suggestions_private string_list Whether or not the user has enabled showing search suggestions in private mode. default: false (we prompt the user, asking them to make a selection) mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.show_clipboard_suggestions string_list Whether or not the user has enabled clipboard search suggestions. default: true mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.show_search_shortcuts string_list Whether or not the user has enabled search shortcuts. default: true mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.show_search_suggestions string_list Whether or not the user has search suggestions enabled default: true mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.show_voice_search string_list Whether or not the user has enabled the voice search button. default: true mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.sync string_list Whether or not the user is signed into FxA default: false mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.sync_items string_list The list of items the user has chosen to sync with FxA. default: "" if the user is signed out. Otherwise defaults to whatever is set in their FxA account. New accounts set: [bookmarks, history, passwords, tabs] mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.telemetry string_list Whether or not the user has telemetry enabled. Note we should never receive a "false" value for this since telemetry would not send in that case. default: true mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.theme string_list The theme the user has enabled. "light," "dark," "system," or "battery" default: "system" for API 28+, else "light" mozilla-mobile/fenix#11446, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.toolbar_position string_list The position of the toolbar default: bottom (defaults to top if the user has accessibility services) mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
preferences.tracking_protection string_list What type of enhanced tracking protection the user has enabled. "standard," "strict," "custom," or "" (if disabled) default: "standard" mozilla-mobile/fenix#11211, mozilla-mobile/fenix#15713 2021-08-01 2
search.default_engine.code string If the search engine is pre-loaded with Fenix this value will be the search engine identifier. If it's a custom search engine (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the value will be "custom" mozilla-mobile/fenix#1606, mozilla-mobile/fenix#5216, mozilla-mobile/fenix#15713 2021-08-01 1, 2
search.default_engine.name string If the search engine is pre-loaded with Fenix this value will be the search engine name. If it's a custom search engine (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the value will be "custom" mozilla-mobile/fenix#1606, mozilla-mobile/fenix#5216, mozilla-mobile/fenix#15713 2021-08-01 1, 2
search.default_engine.submission_url string If the search engine is pre-loaded with Fenix this value will be he base URL we use to build the search query for the search engine. For example: https://mysearchengine.com/?query=%s. If it's a custom search engine (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the value will be "custom" mozilla-mobile/fenix#1606, mozilla-mobile/fenix#5216, mozilla-mobile/fenix#15713 2021-08-01 1, 2
storage.stats.app_bytes memory_distribution The size of the app's APK and related files as installed: this is expected to be larger than download size. This is the output of StorageStats.getAppBytes so see that for details. This value is only available on Android 8+. A similar value may be available on the Google Play dashboard: we can use this value to see if that value is reliable enough. mozilla-mobile/fenix#12876, mozilla-mobile/fenix#17704 2021-08-01 1, 2
storage.stats.cache_bytes memory_distribution The size of all cached data in the app. This is the output of StorageStats.getCacheBytes so see that for details. This value is only available on Android 8+. mozilla-mobile/fenix#12876, mozilla-mobile/fenix#17704 2021-08-01 1, 2
storage.stats.data_dir_bytes memory_distribution The size of all data minus cache_bytes. This is the output of StorageStats.getDataBytes except we subtract the value of cache_bytes so the cache is not measured redundantly; see that method for details. This value is only available on Android 8+. mozilla-mobile/fenix#12876, mozilla-mobile/fenix#17704 2021-08-01 1, 2
storage.stats.query_stats_duration timing_distribution How long it took to query the device for the StorageStats that contain the file size information. The docs say it may be expensive so we want to ensure it's not too expensive. This value is only available on Android 8+. mozilla-mobile/fenix#12876, mozilla-mobile/fenix#17704 2021-08-01 1, 2

startup-timeline

This ping is intended to provide an understanding of startup performance.

In addition to being captured on real devices, the ping data was prematurely optimized into this separate ping to be isolated from other metrics to be more easily captured by performance testing automation but that hasn't happened in practice. We would have removed it but implementation details don't make that possible: https://github.com/mozilla-mobile/fenix/issues/17972#issuecomment-781002987

This ping includes the client id.

Data reviews for this ping:

Bugs related to this ping:

All Glean pings contain built-in metrics in the ping_info and client_info sections.

In addition to those built-in metrics, the following metrics are added to the ping:

Name Type Description Data reviews Extras Expiration Data Sensitivity
startup.timeline.clock_ticks_per_second_v2 quantity The number of clock tick time units that occur in one second on this particular device. This value is expected to be used in conjunction with the framework_primary/secondary metrics. mozilla-mobile/fenix#9788, mozilla-mobile/fenix#15713, mozilla-mobile/fenix#18158
  • unit: clock ticks per second
2021-08-01 1
startup.timeline.framework_primary timespan The duration the Android framework takes to start before letting us run code in *Application.init when this device has clock_ticks_per_second_v2 equal to 100: if it's not equal to 100, then this value is captured in framework_secondary. We split this into two metrics to make it easier to analyze in GLAM. We split on 100 because when we did our initial brief analysis - https://sql.telemetry.mozilla.org/queries/75591 - the results for clocks ticks were overwhelmingly 100. The duration is calculated from appInitTimestamp - processStartTimestamp. processStartTimestamp is derived from the clock tick time unit, which is expected to be less granular than nanoseconds. Therefore, we convert and round our timestamps to clock ticks before computing the difference and convert back to nanoseconds to report. For debugging purposes, clock_ticks_per_second_v2, which may vary between devices, is also reported as a metric mozilla-mobile/fenix#9788, mozilla-mobile/fenix#15713, mozilla-mobile/fenix#18043 2021-08-01 1
startup.timeline.framework_secondary timespan The duration the Android framework takes to start before letting us run code in *Application.init when this device has clock_ticks_per_second_v2 not equal to 100. For more details on this metric, see framework_primary mozilla-mobile/fenix#18043 2021-08-01 1
startup.timeline.framework_start_error boolean An error when attempting to record framework_primary/secondary - the application init timestamp returned a negative value - which is likely indicative of a bug in the implementation. mozilla-mobile/fenix#9788, mozilla-mobile/fenix#15713 2021-08-01 1
startup.timeline.framework_start_read_error boolean An error when attempting to read stats from /proc pseudo-filesystem - privacy managers can block access to reading these files - the application will catch a file reading exception. mozilla-mobile/fenix#10481, mozilla-mobile/fenix#15713 2021-08-01 1

Data categories are defined here.