<!--
Copyright 2022 The Chromium Authors
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file.
-->
<!--
This file is used to generate a comprehensive list of Chrome OS Settings
histograms along with a detailed description for each histogram.
For best practices on writing histogram descriptions, see
https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md
Prefer owners from the OWNERS file in this directory. If you need a metrics
reviewer, please send CLs to [email protected] rather than to
specific individuals. These CLs will be automatically reassigned to a reviewer
within about 5 minutes. This approach helps the metrics team to load-balance
incoming reviews. Googlers can read more about this at go/gwsq-gerrit.
-->
<histogram-configuration>
<histograms>
<histogram
name="ChromeOS.Settings.Accessibility.AccessibilityMagnifierFollowsSts"
enum="BooleanToggled" expires_after="2024-10-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user changes the magnifier follows the word being read by
select-to-speak setting on the Accessibility page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Accessibility.CaretBlinkInterval" units="ms"
expires_after="2025-02-02">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The text caret blink interval in ms chosen by the user. Logged on change
from settings, from 12 possible values in a slider. The default value in
settings is 100% which corresponds to 500 ms. 0 ms means "do not
blink".
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Accessibility.ColorCorrection.FilterAmount"
units="%" expires_after="2024-10-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The color correction filter intensity chosen by the user. Logged on change
from settings. The default value in settings is 100%.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Accessibility.ColorCorrection.FilterType"
enum="ColorCorrectionFilterTypes" expires_after="2024-10-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The color correction filter type chosen by the user. Logged on change from
settings. The default value in settings is deuteranopia.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Accessibility.ConnectBrailleDisplay"
enum="BooleanConnected" expires_after="2025-01-05">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user tries to connect or disconnect a braille display from
the ChromeVox settings subpage within the Accessibility page, by clicking
the "connect" / "disconnect" button.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Accessibility.CursorColor.Enabled"
enum="BooleanToggled" expires_after="2024-10-16">
<!-- Kept separate from the generic accessibility settings metric because this
is not a simple toggle on/off presented to the user, but is a dropdown list
of color choices. -->
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user picks any colored cursor (toggled on) vs the black
cursor (toggled off) on the Accessibility page.
</summary>
</histogram>
<histogram
name="ChromeOS.Settings.Accessibility.FullscreenMagnifierFocusFollowing"
enum="BooleanToggled" expires_after="2025-02-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user changes the kFullscreenMagnifierFocusFollowing setting
on the Accessibility page.
</summary>
</histogram>
<histogram
name="ChromeOS.Settings.Accessibility.FullscreenMagnifierMouseFollowingMode"
enum="MagnifierMouseFollowingMode" expires_after="2024-10-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Recorded when a user changes the value of the
kFullscreenMagnifierMouseFollowingMode setting on the Accessibility page.
Records the value of the setting.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Accessibility.MagnifierFollowsChromeVox"
enum="BooleanToggled" expires_after="2024-10-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Recorded when a user changes the value of the kMagnifierFollowsChromeVox
setting on the Accessibility page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Accessibility.{SettingType}.Enabled"
enum="BooleanToggled" expires_after="2025-02-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user changes the setting on the Accessibility page for the
feature: {SettingType}
</summary>
<token key="SettingType">
<variant name="Autoclick"/>
<variant name="CaretBrowsing"/>
<variant name="CaretHighlight"/>
<variant name="ColorCorrection"
summary="ColorCorrection. Note that color correction settings can
also be enabled or disabled in quick settings."/>
<variant name="CursorHighlight"/>
<variant name="Dictation"/>
<variant name="DockedMagnifier"/>
<variant name="FlashNotifications"/>
<variant name="FocusHighlight"/>
<variant name="FullscreenMagnifier"/>
<variant name="HighContrast"/>
<variant name="LargeCursor"/>
<variant name="LiveCaption"/>
<variant name="MainNodeAnnotations"/>
<variant name="MonoAudio"/>
<variant name="OnScreenKeyboard"/>
<variant name="OOBEStartupSound"/>
<variant name="ReducedAnimations"/>
<variant name="SelectToSpeak"/>
<variant name="SpokenFeedback" summary="ChromeVox Spoken Feedback"/>
<variant name="StickyKeys"/>
<variant name="SwitchAccess"/>
</token>
</histogram>
<histogram name="ChromeOS.Settings.Apps.DoNotDisturbOnOff"
enum="BooleanToggled" expires_after="2025-01-26">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user changes the kDoNotDisturbOnOff setting in the
Notifications subpage of the Apps section.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Bluetooth.BluetoothOnOff"
enum="BooleanToggled" expires_after="2025-03-19">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users change the kBluetoothOnOff setting on the Bluetooth page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.BlurredWindowDuration" units="ms"
expires_after="2024-12-27">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The amount of time between when the settings window becomes blurred and when
the user focuses it again.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Device.ChargingSoundsButtonEnabled"
enum="BooleanEnabled" expires_after="2024-12-08">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user toggles the Charging sounds setting in the Audio subpage
of the Device section.
</summary>
</histogram>
<histogram
name="ChromeOS.Settings.Device.Keyboard.AutoBrightnessEnabled.Changed"
enum="BooleanToggled" expires_after="2025-03-01">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user toggles the keyboard auto-brightness setting via
the ChromeOS Settings app.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Device.Keyboard.BrightnessSliderAdjusted"
units="%" expires_after="2025-04-08">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user changes the keyboard brightness using slider in
keyboard settings. The value saved is the brightness percentage after
adjustment. Fires when adjustment is completed.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Device.KeyboardAutoRepeatEnabled"
enum="BooleanEnabled" expires_after="2024-05-05">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records value of keyboard auto-repeat Enabled setting at session startup.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Device.KeyboardAutoRepeat{Setting}"
units="ms" expires_after="2024-06-30">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records value of keyboard auto-repeat {Setting} setting at session startup.
</summary>
<token key="Setting">
<variant name="Delay"/>
<variant name="Interval"/>
</token>
</histogram>
<histogram name="ChromeOS.Settings.Device.KeyboardColorLinkClicks"
enum="Boolean" expires_after="2025-04-02">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user clicks the "Keyboard Color" link within
Keyboard Settings, that navigates to the Personalization Hub's RGB Keyboard
Control section. Fires upon link clicks.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Device.KeyboardFunctionKeys"
enum="BooleanToggled" expires_after="2024-12-15">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user changes the kKeyboardFunctionKeys setting on the Device
page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Device.LowBatterySoundButtonEnabled"
enum="BooleanEnabled" expires_after="2025-07-22">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user toggles the Low battery sound setting in the Audio
subpage of the Device section.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Device.TouchpadSpeedValue"
enum="TouchpadSensitivity" expires_after="2024-04-28">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users change the Touchpad Speed on the Device page. The value
saved is equal to the sensitivity value set on the slider, which ranges from
1 to 5.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Display" enum="DisplaySettingsType"
expires_after="2025-01-05">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Counts the number of times when users change the display settings via the
ChromeOS Settings app. This histogram counts display settings that apply to
both internal and external display, such as toggling mirror mode and unified
mode.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Display.Internal.AutoBrightnessEnabled"
enum="BooleanToggled" expires_after="2025-03-01">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user toggles the auto-brightness setting via the
ChromeOS Settings app.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Display.Internal.BrightnessSliderAdjusted"
units="%" expires_after="2025-03-01">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user changes the screen brightness for an internal
display. The value saved is the brightness percentage after adjustment.
Fires when adjustment is completed.
</summary>
</histogram>
<histogram
name="ChromeOS.Settings.Display.Internal.UserInitiated.AmbientLightSensorDisabledCause"
enum="UserInitiatedAmbientLightSensorDisabledCause"
expires_after="2025-05-01">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the cause when the ambient light sensor was disabled by the user,
whether explicitly via the settings app or implicitly through brightness
adjustments. This histogram is triggered each time the ambient light sensor
is disabled due to user actions.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Display.MirrorModeStatus"
enum="DisplaySettingsBoolean" expires_after="2024-12-28">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user toggles the display mirror mode setting via the
ChromeOS Settings app.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Display.NewDisplayConnected"
enum="DisplayType" expires_after="2025-01-05">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when an internal/external display is connected for the first time.
This is part of the metrics aiming to measure how well system provided
default display settings work, by calculating the percentage of users who
change the default settings after a display is connected for the first time.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Display.UnifiedModeStatus"
enum="DisplaySettingsBoolean" expires_after="2024-12-28">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user toggles the display unified mode setting via the
ChromeOS Settings app.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Display.{DisplayType}"
enum="DisplaySettingsType" expires_after="2025-01-05">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user changes the display settings of an {DisplayType}
display via the ChromeOS Settings app.
</summary>
<token key="DisplayType">
<variant name="External" summary="external"/>
<variant name="Internal" summary="internal"/>
</token>
</histogram>
<histogram name="ChromeOS.Settings.Display.{DisplayType}.NightLightSchedule"
enum="DisplaySettingsNightLightScheduleOption" expires_after="2025-02-23">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user changes the display night light schedule setting of
an {DisplayType} display via the ChromeOS Settings app.
</summary>
<token key="DisplayType">
<variant name="External" summary="external"/>
<variant name="Internal" summary="internal"/>
</token>
</histogram>
<histogram name="ChromeOS.Settings.Display.{DisplayType}.NightLightStatus"
enum="DisplaySettingsBoolean" expires_after="2025-02-23">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user toggles the display night light status setting of
an {DisplayType} display via the ChromeOS Settings app.
</summary>
<token key="DisplayType">
<variant name="External" summary="external"/>
<variant name="Internal" summary="internal"/>
</token>
</histogram>
<histogram name="ChromeOS.Settings.Display.{DisplayType}.Orientation"
enum="DisplaySettingsOrientationOption" expires_after="2024-12-28">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records each time a user changes the display orientation of an {DisplayType}
display via the ChromeOS Settings app.
</summary>
<token key="DisplayType">
<variant name="External" summary="external"/>
<variant name="Internal" summary="internal"/>
</token>
</histogram>
<histogram
name="ChromeOS.Settings.Display.{DisplayType}.UserOverrideDisplayDefaultSettings"
enum="DisplayDefaultSettingsMeasurement" expires_after="2025-03-31">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when user overrides the {DisplayType} display settings (e.g.
resolution, scaling) provided by default. Only record when the settings are
changed within an hour of the {DisplayType} display being connected for the
first time.
</summary>
<token key="DisplayType">
<variant name="External" summary="external"/>
<variant name="Internal" summary="internal"/>
</token>
</histogram>
<histogram
name="ChromeOS.Settings.Display.{DisplayType}.UserOverrideDisplayDefaultSettingsTimeElapsed.{DisplaySettings}"
units="minutes" expires_after="2025-01-05">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the time elapsed when user overrides the {DisplayType} display
{DisplaySettings} provided by default. Only record when an {DisplayType}
display is connected for the first time.
</summary>
<token key="DisplayType">
<variant name="External" summary="external"/>
<variant name="Internal" summary="internal"/>
</token>
<token key="DisplaySettings">
<variant name="Resolution" summary="resolution"/>
<variant name="Scaling" summary="scaling"/>
</token>
</histogram>
<histogram name="ChromeOS.Settings.Inputs.ShortcutReminderDismissed"
enum="SettingsInputsShortcutReminderState" expires_after="2023-11-12">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users dismiss the shortcut reminder banner in Chrome OS' Inputs
OS settings page. The value saved indicates the keyboard shortcuts that were
previously shown in the banner before the user dismissed the banner.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Keyboard.Modifiers.Hash" units="hash"
expires_after="2025-03-22">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the configured modifier remapping set for all modifiers as a hash.
See //ash/system/input_device_settings/keyboard_modifier_metrics_recorder.cc
for an explanation of the storage method and how to convert the hash to get
modifier data.
</summary>
</histogram>
<histogram
name="ChromeOS.Settings.Keyboard.Modifiers.{Modifier}RemappedTo.Changed"
enum="KeyboardModifierRemappingKeys" expires_after="2025-03-22">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the configured modifier remapping for the {Modifier} key when a user
changes the setting in the Settings SWA.
</summary>
<token key="Modifier">
<variant name="Alt"/>
<variant name="Assistant"/>
<variant name="Backspace"/>
<variant name="CapsLock"/>
<variant name="Control"/>
<variant name="Escape"/>
<variant name="ExternalCommand"/>
<variant name="ExternalMeta"/>
<variant name="Search"/>
</token>
</histogram>
<histogram
name="ChromeOS.Settings.Keyboard.Modifiers.{Modifier}RemappedTo.Started"
enum="KeyboardModifierRemappingKeys" expires_after="2025-03-22">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the configured modifier remapping for the {Modifier} key when a user
session is started. Only emitted once per user per session. Default values
are not recorded.
</summary>
<token key="Modifier">
<variant name="Alt"/>
<variant name="Assistant"/>
<variant name="Backspace"/>
<variant name="CapsLock"/>
<variant name="Control"/>
<variant name="Escape"/>
<variant name="ExternalCommand"/>
<variant name="ExternalMeta"/>
<variant name="Search"/>
</token>
</histogram>
<histogram
name="ChromeOS.Settings.Keyboard.UserInitiated.AmbientLightSensorDisabledCause"
enum="UserInitiatedAmbientLightSensorDisabledCause"
expires_after="2025-05-01">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the cause when the keyboard ambient light sensor was disabled by the
user, whether explicitly via the settings app or implicitly through keyboard
brightness adjustments. This histogram is triggered each time the keyboard
ambient light sensor is disabled due to user actions.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Languages.Interaction"
enum="SettingsLanguagesPageInteraction" expires_after="2025-01-05">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users interact with different element in the Chrome OS's
Languages OS settings page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Languages.OfferToTranslateCheckbox"
enum="BooleanChecked" expires_after="2022-10-12">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users check/uncheck "Offer to translate pages in this
language" checkbox in OS Settings
</summary>
</histogram>
<histogram base="true" name="ChromeOS.Settings.Languages.Toggle"
enum="BooleanToggled" expires_after="2024-02-25">
<!-- Name completed by histogram_suffixes name="SettingsLanguagesPageToggle" -->
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users interact with a toggle in the Chrome OS's Languages OS
settings page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.LoadCompletedTime" units="ms"
expires_after="2025-04-08">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The amount of time between the RenderFrameHost StartProvisionalLoad and
DocumentOnLoadCompleted events for the ChromeOS settings page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.LoadDocumentTime" units="ms"
expires_after="2025-02-02">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The amount of time between the RenderFrameHost StartProvisionalLoad and
DidFinishDocumentLoad events for the ChromeOS settings page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.MagicBoost.Enabled" enum="BooleanToggled"
expires_after="2025-03-31">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users interact with the MagicBoost toggle in the Chrome OS's
Search and Assistant setting.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.MagicBoost.HelpMeReadEnabled"
enum="BooleanToggled" expires_after="2025-03-31">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users interact with the Help Me Read toggle in the Chrome OS's
Search and Assistant setting.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.MagicBoost.HelpMeWriteEnabled"
enum="BooleanToggled" expires_after="2025-03-31">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users interact with the Help Me Write toggle in the Chrome OS's
Search and Assistant setting.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.NotificationPage.PermissionOnOff"
enum="BooleanToggled" expires_after="2023-08-08">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user changes the notification permission of any app in the
Notifications subpage of the Apps section.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.NumCharsOfQueries" units="characters"
expires_after="2025-03-19">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The number of characters for queries used to fetch results from the Settings
Search Mojo API.
</summary>
</histogram>
<histogram base="true" name="ChromeOS.Settings.NumClicksUntilChange"
units="clicks" expires_after="2024-12-29">
<!-- Name completed by histogram_suffixes name="OsSettingsChangeType" -->
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>The number of clicks before changing a setting.</summary>
</histogram>
<histogram base="true" name="ChromeOS.Settings.NumNavigationsUntilChange"
units="navigations" expires_after="2025-02-10">
<!-- Name completed by histogram_suffixes name="OsSettingsChangeType" -->
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>The number of navigations before changing a setting.</summary>
</histogram>
<histogram base="true" name="ChromeOS.Settings.NumSearchesUntilChange"
units="searches" expires_after="2025-01-02">
<!-- Name completed by histogram_suffixes name="OsSettingsChangeType" -->
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>The number of searches before changing a setting.</summary>
</histogram>
<histogram name="ChromeOS.Settings.NumSearchResultsFetched" units="results"
expires_after="2025-08-19">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The number of search results fetched each time a successful search request
is made to the Settings Search Mojo API.
</summary>
</histogram>
<histogram
name="ChromeOS.Settings.NumUniqueSettingsChanged.DeviceLifetime2.{Time}"
units="Unique Setting(s) Changed" expires_after="2025-01-26">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the total number of unique settings changed by a user over a
device's lifetime, regardless of whether they have changed a unique Setting
or not. The recording takes place periodically.
</summary>
<token key="Time">
<variant name="FirstWeek"
summary="Setting changed within the first week since the user has
completed OOBE."/>
<variant name="SubsequentWeeks"
summary="Setting changed after the first week since the user has
completed OOBE"/>
<variant name="Total"
summary="Total Settings changed within the lifetime of the device per
each user."/>
</token>
</histogram>
<histogram name="ChromeOS.Settings.NumUniqueSettingsChanged.PerSession"
units="UniqueChanges" expires_after="2025-02-10">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the number of unique settings changed by a user between opening and
closing the settings app. Records on each window close.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.OverscrollHistoryNavigation.Enabled"
enum="BooleanEnabled" expires_after="2025-02-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Logs whether the overscroll history navigation setting is enabled or
disabled when it is toggled in ChromeOS settings. Compare to the histogram
"Settings.OverscrollHistoryNavigation.Enabled" for other desktop
platforms.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.PathVisited"
enum="WebUIOSSettingsPathHashes" expires_after="2025-01-05">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Paths visited within chrome://os-settings. For evaluating popularity and
priorities for OS Settings UI.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.People.AddAccountCount" units="accounts"
expires_after="2025-03-19">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when users click the Add Account button on the People page. The
number of the account that would be added is saved, e.g. a sample of 2 means
the user entered the add account dialog for a 2nd account.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Privacy.PeripheralDataAccessProtection"
enum="BooleanEnabled" expires_after="2025-02-10">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when the users clicks on the Peripheral Data Access toggle. A true
value refers to the user enables peripheral data access protection (toggle
is turned on).
Data may be missing from 2022-11-30 to 2023-06-09.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Privacy.VerifiedAccessEnabled"
enum="BooleanEnabled" expires_after="2025-02-23">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the Enable Verified Access setting enabled/disabled value. This
metric is logged with every UMA upload in ProvideCurrentSessionData()
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Privacy.VerifiedAccessOnOff"
enum="BooleanToggled" expires_after="2024-12-24">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user toggles the Enable Verified Access setting under the
Security and Privacy section.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.RevenEnableHwDataUsage"
enum="BooleanToggled" expires_after="2024-09-06">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the result of whether users agree to send hardware data through the
settings screen on unmanaged ChromeOS Flex devices. This metric is logged
when "ChromeOS Flex hardware support and stability" setting is
enabled or disabled.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SearchLatency" units="ms"
expires_after="2024-12-27">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The time fetching search results from the Settings Search Mojo API. Recorded
when getSearchHandler().search() completes.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SearchRequests"
enum="OsSettingSearchRequestTypes" expires_after="2025-01-26">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The number of search requests made to the Settings Search Mojo API. For
search requests that succeeded with a response, the number of search
requests that had results which were discarded, and the number of search
requests that were shown to the user. Recorded when
getSearchHandler().search() completes.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SearchRequestsPerSession"
units="mojo search requests" expires_after="2025-03-19">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The number of search requests made to the Settings Search Mojo API in one
session of the settings app.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SearchResultPersonalizationSelected"
enum="PersonalizationSearchConceptId" expires_after="2023-08-27">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
External personalization search results clicked by user in the OS settings
search box.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SearchResultSectionSelected"
enum="OsSettingsSection" expires_after="2025-08-19">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Section search results clicked by user in the OS settings search box.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SearchResultSettingSelected"
enum="OsSetting" expires_after="2025-03-19">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Setting search results clicked by user in the OS settings search box.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SearchResultSubpageSelected"
enum="OsSettingsSubpage" expires_after="2024-11-03">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Subpage search results clicked by user in the OS settings search box.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SearchResultTypeSelected"
enum="OsSettingsSearchResultType" expires_after="2025-08-19">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Type of search results clicked by user in the OS settings search box.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SettingChanged" enum="OsSetting"
expires_after="2025-05-06">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records the the setting id when the user changes a setting. Note that some
of the values of the OsSetting enum aren't strictly settings (such as
kKeyboardShortcuts, which is just a hyperlink). All of the recorded values
appear in the settings page.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.SnapWindowSuggestions" enum="BooleanToggled"
expires_after="2025-02-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Records when a user changes the kSnapWindowSuggestions setting in the
Multitasking section of the System Preferences page.
</summary>
</histogram>
<histogram base="true" name="ChromeOS.Settings.TimeUntilChange" units="ms"
expires_after="2025-01-19">
<!-- Name completed by histogram_suffixes name="OsSettingsChangeType" -->
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The time spent on the settings page before changing a setting.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.TimeUntilInteractive" units="ms"
expires_after="2025-02-06">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The time until the ChromeOS Settings WebUI is loaded, rendered, and
interactive for users (as in they can change a setting). Automatically
logged each time the app is opened (if not closed before interactive).
</summary>
</histogram>
<histogram name="ChromeOS.Settings.UserActionOnSearchResultsShown"
enum="OsSettingSearchBoxUserAction" expires_after="2024-10-16">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The user action taken when search results exist and are displayed.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Wifi.AddNetwork"
enum="NetworkDiscoveryState" expires_after="2025-02-10">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Recorded when the user adds a WiFi network that has not been added before.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.Wifi.Hidden" enum="BooleanToggled"
expires_after="2025-02-10">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Recorded when the "Hidden" Wi-Fi network toggle is changed by the
user.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.WindowOpenDuration" units="ms"
expires_after="2025-01-26">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The amount of time between when a Chrome OS settings window is opened and
when it is closed.
</summary>
</histogram>
<histogram name="ChromeOS.Settings.WindowTotalActiveDuration" units="ms"
expires_after="2024-12-30">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The total time the Settings window is active in a session. The timer starts
once the user opens the page and stops once closed. If the user navigates to
another window or if the device goes into lock mode, the timer will pause
and it will resume once they navigate back to the Settings page. If user is
on Settings page and the device goes into sleep mode with lock disabled, the
timer continues and does not pause, which may lead to some outliers.
</summary>
</histogram>
</histograms>
</histogram-configuration>
Codebase Browser
chromium