blob: 10b668dff0da24d04edba5890bbd95cf6714f1c3 [file] [log] [blame]
<!--
Copyright 2020 The Chromium Authors. All rights reserved.
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 Ash 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
Please send CLs to chromium-metrics-reviews@google.com 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="Ash.Accelerators.Deprecated.ShowImeMenuBubble"
enum="DeprecatedAcceleratorUsage" expires_after="M77">
<owner>afakhry@chromium.org</owner>
<summary>
Showing the IME menu bubble has two accelerators: - Alt+Shift+K which is
deprecated. - Search+Shift+K which is new. This histogram shows the number
of times each accelerator (deprecated and new) is used.
</summary>
</histogram>
<histogram name="Ash.Accelerators.Deprecated.ShowTaskManager"
enum="DeprecatedAcceleratorUsage" expires_after="2021-07-15">
<owner>zentaro@chromium.org</owner>
<owner>cros-peripherals@chromium.org</owner>
<summary>
Opening the task manager has two accelerators: - Shift+Esc which is
deprecated. - Search+Esc which is new. This histogram shows the number of
times each accelerator (deprecated and new) is used.
</summary>
</histogram>
<histogram name="Ash.Accelerators.Deprecated.ToggleHighContrast"
enum="DeprecatedAcceleratorUsage" expires_after="M77">
<owner>afakhry@chromium.org</owner>
<summary>
Toggling the high contrast display mode has two accelerators: -
Search+Shift+H which is deprecated. - Ctrl+Search+H which is new. This
histogram shows the number of times each accelerator (deprecated and new) is
used.
</summary>
</histogram>
<histogram name="Ash.Accelerators.Rotation.Usage"
enum="ScreenRotationAcceleratorAction" expires_after="2021-03-15">
<owner>baileyberro@chromium.org</owner>
<summary>
Captures the result of a user using the rotation accelerator -
Ctrl+Shift+Refresh. This histogram shows how frequently users accidentally
hit the key combination.
</summary>
</histogram>
<histogram name="Ash.Accelerators.WindowSnap"
enum="WindowSnapAcceleratorAction" expires_after="2020-12-12">
<owner>amusbach@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>Captures usage of Alt+[ and Alt+].</summary>
</histogram>
<histogram name="Ash.ActiveWindowShowTypeOverTime" enum="ActiveWindowShowType"
expires_after="M85">
<owner>kuscher@google.com</owner>
<summary>
The show type of the active window tracked over time by logging on a regular
basis (30 minutes).
</summary>
</histogram>
<histogram name="Ash.AmbientMode.Activation.{TabletOrClamshell}"
enum="AmbientUiMode" expires_after="2021-05-01">
<owner>cowmoo@google.com</owner>
<owner>xiaohuic@chromium.org</owner>
<summary>
Recorded whenever Ambient mode is entered from {TabletOrClamshell}.
AmbientUiMode indicates whether the user entered Ambient mode from the lock
screen or from screen idle.
</summary>
<token key="TabletOrClamshell">
<variant name="ClamshellMode" summary="Clamshell mode"/>
<variant name="TabletMode" summary="Tablet mode"/>
</token>
</histogram>
<histogram name="Ash.AmbientMode.AnimationSmoothness.PhotoTransition" units="%"
expires_after="2021-05-01">
<owner>wutao@chromium.org</owner>
<owner>xiaohuic@chromium.org</owner>
<summary>
Emitted when the ambient mode photo transition animation completes to report
the smoothness of this animation. 100% represents ideally smooth 60 frames
per second.
</summary>
</histogram>
<histogram name="Ash.AmbientMode.Enabled" enum="BooleanEnabled"
expires_after="2021-05-01">
<owner>cowmoo@google.com</owner>
<owner>xiaohuic@chromium.org</owner>
<summary>
Among eligible users, whether the user has Ambient mode enabled. Recorded
once for every UMA upload. The set of eligible users includes all users with
profiles that can allow Ambient mode to be enabled. This is limited by
profile type, whether the user is primary, if the user has a supported
email, etc.
</summary>
</histogram>
<histogram name="Ash.AmbientMode.EngagementTime.{TabletOrClamshell}"
units="hours" expires_after="2021-05-01">
<owner>cowmoo@google.com</owner>
<owner>xiaohuic@chromium.org</owner>
<summary>
Among eligible users with ambient mode enabled, records the length of each
session. The metric is uploaded when ambient mode is ended.
</summary>
<token key="TabletOrClamshell">
<variant name="ClamshellMode" summary="Clamshell mode"/>
<variant name="TabletMode" summary="Tablet mode"/>
</token>
</histogram>
<histogram name="Ash.AmbientMode.PhotoSource" enum="AmbientModePhotoSource"
expires_after="2021-05-01">
<owner>cowmoo@google.com</owner>
<owner>xiaohuic@chromium.org</owner>
<summary>
Among eligible users with ambient mode enabled, records the source of
ambient mode photos. Recorded once for every UMA upload.
</summary>
</histogram>
<histogram base="true" name="Ash.Assistant.AnimationSmoothness" units="%"
expires_after="2021-07-20">
<!-- Name completed by histogram_suffixes name="AshAssistantAnimationSmoothness" -->
<owner>cowmoo@chromium.org</owner>
<owner>xiaohuic@chromium.org</owner>
<summary>
Relative smoothness of assistant related animations. 100% represents ideally
smooth 60 frames per second.
</summary>
</histogram>
<histogram name="Ash.BackGesture.EndScenarioType"
enum="BackGestureEndScenarioType" expires_after="2020-12-23">
<owner>minch@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
End scenario type while swiping back from the left side of the window in
tablet mode.
</summary>
</histogram>
<histogram name="Ash.BackGesture.StartScenarioType"
enum="BackGestureStartScenarioType" expires_after="2020-12-23">
<owner>minch@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Start scenario type while swiping back from the left side of the window in
tablet mode.
</summary>
</histogram>
<histogram name="Ash.BackGesture.UnderneathWindowType"
enum="BackGestureUnderneathWindowType" expires_after="2020-12-23">
<owner>minch@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Underneath window type while swiping back from the left side of the window
in tablet mode.
</summary>
</histogram>
<histogram name="Ash.CaptureModeController.ScreenshotsPerDay" units="int"
expires_after="2021-09-29">
<owner>afakhry@chromium.org</owner>
<owner>gzadina@google.com</owner>
<summary>
Records the number of screenshots that have been taken via the
CaptureModeController every 24 hours. Note that counts are not persisted
across crashes, restarts, or sessions so this is only intended to give a
rough approximation.
</summary>
</histogram>
<histogram name="Ash.CaptureModeController.ScreenshotsPerWeek" units="int"
expires_after="2021-09-29">
<owner>afakhry@chromium.org</owner>
<owner>gzadina@google.com</owner>
<summary>
Records the number of screenshots that have been taken via the
CaptureModeController every 7 days. Note that counts are not persisted
across crashes, restarts, or sessions so this is only intended to give a
rough approximation. This means that this metric will only be recorded in
sessions spanning at least 7 days.
</summary>
</histogram>
<histogram name="Ash.ClipboardHistory.ContextMenu.DisplayFormatDeleted"
enum="ClipboardHistoryDisplayFormat" expires_after="2021-09-01">
<owner>andrewxu@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
The format of the ClipboardHistoryItemView that was deleted from the
Clipboard History menu. Logged on ClipboardHistoryItemView::ButtonPressed().
</summary>
</histogram>
<histogram name="Ash.ClipboardHistory.ContextMenu.DisplayFormatPasted"
enum="ClipboardHistoryDisplayFormat" expires_after="2021-09-01">
<owner>andrewxu@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
The format of the ClipboardHistoryItemView that was pasted from the
Clipboard History menu. Logged on ClipboardHistoryItemView::ButtonPressed().
</summary>
</histogram>
<histogram name="Ash.ClipboardHistory.ContextMenu.DisplayFormatShown"
enum="ClipboardHistoryDisplayFormat" expires_after="2021-09-01">
<owner>andrewxu@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
The format of the view used to display clipboard data. Logged when the view
is created.
</summary>
</histogram>
<histogram name="Ash.ClipboardHistory.ContextMenu.MenuOptionSelected"
units="index" expires_after="2021-09-01">
<owner>andrewxu@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
The command ID index within the Clipboard History contextual menu that was
selected by the user. Recorded when the menu item is selected.
</summary>
</histogram>
<histogram name="Ash.ClipboardHistory.ContextMenu.NumberOfItemsShown"
units="Items Shown" expires_after="2021-09-01">
<owner>andrewxu@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
The number of clipboard history items shown in the clipboard history
contextual menu. Recorded when the clipboard history contextual menu model
is built.
</summary>
</histogram>
<histogram name="Ash.ClipboardHistory.ContextMenu.UserJourneyTime" units="ms"
expires_after="2021-09-01">
<owner>andrewxu@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
The length of the user journey of the context menu version of clipboard
history. Measured as time from starting to construct the menu, to time of
the menu being closed. Recorded every time the menu is closed, regardless of
whether the user selected one of the menu options.
</summary>
</histogram>
<histogram base="true" name="Ash.ContextualNudgeDismissContext"
enum="ContextualNudgeDismissContext" expires_after="M86">
<!-- Name completed by histogram_suffixes name="ContextualNudgesNames" -->
<owner>yulunwu@chromium.org</owner>
<owner>tbarzic@chromium.org</owner>
<summary>
Tracks the reason contextual nudges for user gesture education are
dismissed.
</summary>
</histogram>
<histogram base="true" name="Ash.ContextualNudgeDismissTime" units="ms"
expires_after="M86">
<!-- Name completed by histogram_suffixes name="ContextualNudgesNames" -->
<owner>yulunwu@chromium.org</owner>
<owner>tbarzic@chromium.org</owner>
<summary>
Tracks time between showing contextual nudge and gesture being performed.
</summary>
</histogram>
<histogram name="Ash.Desks.AnimationSmoothness.DeskActivation" units="%"
expires_after="M89">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<owner>mukai@chromium.org</owner>
<summary>
Emitted when the virtual desks activation animation completes to report the
smoothness of this animation when running on the display on which the active
window resides (if any) or the display of the primary root window. 100%
represents ideally smooth 60 frames per second.
</summary>
</histogram>
<histogram name="Ash.Desks.AnimationSmoothness.DeskEndGesture" units="%"
expires_after="2021-09-16">
<owner>afakhry@chromium.org</owner>
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
When a four finger touchpad swipe has ended, an animation to the nearest
desk will occur. This histogram is emitted when that animation finishes.
100% represents ideally smooth 60 frames per second.
</summary>
</histogram>
<histogram name="Ash.Desks.AnimationSmoothness.DeskRemoval" units="%"
expires_after="M89">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<owner>mukai@chromium.org</owner>
<summary>
Emitted when the virtual desks removal animation completes to report the
smoothness of this animation when running on the display on which the active
window resides (if any) or the display of the primary root window. 100%
represents ideally smooth 60 frames per second.
</summary>
</histogram>
<histogram name="Ash.Desks.DesksCount2" units="units"
expires_after="2020-12-06">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Emitted when there's a change in the virtual desks count whether due to desk
creation or removal. Specifies the number of available desks. It is not
emitted for the first-ever created default desk.
</summary>
</histogram>
<histogram name="Ash.Desks.DesksSwitch" enum="DesksSwitchSource"
expires_after="2021-04-11">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Emitted when the active desk is changed to specify the source of this
action, i.e. whether due to new-desk shortcut, desk removed, window
activated, switch-desk shortcut, or a press on the desk mini_view.
</summary>
</histogram>
<histogram name="Ash.Desks.MoveWindowFromActiveDesk"
enum="DesksMoveWindowFromActiveDeskSource" expires_after="2021-02-21">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Emitted when a window is moved from the current active desk to another desk.
Specifies the source of this action, i.e. whether to window drag-and-drop,
or keyboard shortcut.
</summary>
</histogram>
<histogram name="Ash.Desks.NewDesk2" enum="DesksCreationRemovalSource"
expires_after="2021-04-11">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Emitted when a virtual desk is created to specify the source of this action,
i.e. whether from the new-desk button, keyboard shortcut, or due to desks
restore. It is not emitted for the first-ever created default desk.
</summary>
</histogram>
<histogram name="Ash.Desks.NumberOfWindowsOnDesk_1" units="units"
expires_after="2021-04-11">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
The number of windows on the first desk. Emitted when a desk is removed, or
a window is moved to another desk.
</summary>
</histogram>
<histogram name="Ash.Desks.NumberOfWindowsOnDesk_2" units="units"
expires_after="2021-04-11">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
The number of windows on the second desk. Emitted when a desk is removed, or
a window is moved to another desk.
</summary>
</histogram>
<histogram name="Ash.Desks.NumberOfWindowsOnDesk_3" units="units"
expires_after="2021-04-11">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
The number of windows on the third desk. Emitted when a desk is removed, or
a window is moved to another desk.
</summary>
</histogram>
<histogram name="Ash.Desks.NumberOfWindowsOnDesk_4" units="units"
expires_after="2021-04-11">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
The number of windows on the fourth desk. Emitted when a desk is removed, or
a window is moved to another desk.
</summary>
</histogram>
<histogram name="Ash.Desks.PresentationTime.UpdateGesture" units="ms"
expires_after="2021-09-16">
<owner>afakhry@chromium.org</owner>
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Presentation time in ms when a four finger swipe is being used to change
desks. One full swipe results in multiple emissions of this metric; once
everytime the fingers change location on the trackpad. Presentation time is
the time it takes from when the software recognizes the touchpad swipe to
when the next frame is displayed on the screen.
</summary>
</histogram>
<histogram name="Ash.Desks.PresentationTime.UpdateGesture.MaxLatency"
units="ms" expires_after="2021-09-16">
<owner>afakhry@chromium.org</owner>
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
The largest presentation time value in ms for a single four finger swipe to
change desks. One full swipe results in one emission of this metric; its the
largest value of Ash.Desks.PresentationTime.UpdateGesture which is emitted
multiple times during a single full swipe. Presentation time is the time it
takes from when the software recognizes the touchpad swipe to when the next
frame is displayed on the frame.
</summary>
</histogram>
<histogram name="Ash.Desks.RemoveDesk" enum="DesksCreationRemovalSource"
expires_after="2021-01-03">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Emitted when a virtual desk is removed to specify the source of this remove
operation, i.e. whether from the close-desk button, or keyboard shortcut.
</summary>
</histogram>
<histogram name="Ash.Desktop.TimeBetweenNavigateToTaskSwitches" units="seconds"
expires_after="2021-03-15">
<owner>tbuckley@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
The number of seconds between task window activations triggered by users
clicking or tapping on a window, as recorded by the Desktop_SwitchTask user
action. Recorded on Chrome OS only. Task switches from other sources are
ignored and do not affect this metric. In other words, if a user performs
the following steps (1) click on task window 'A' (2) Alt+Tab to task 'Z'(3)
click on task window 'B', then this will result in a sample recorded for the
time delta between activating task window 'A'and 'B'.
</summary>
</histogram>
<histogram name="Ash.Display.InternalDisplay.ActiveEffectiveResolution"
enum="EffectiveResolution" expires_after="2021-09-01">
<owner>malaykeshav@chromium.org</owner>
<owner>oshima@chromium.org</owner>
<summary>
The effective resolution of the internal display after device scale factor
and display zoom level has been applied. This is the exact value matching
the display's effective resolution. This is emitted at regular intervals.
</summary>
</histogram>
<histogram name="Ash.Display.PrimaryDisplayZoomAtStartup" units="%"
expires_after="2020-09-06">
<owner>jamescook@chromium.org</owner>
<owner>jessejames@chromium.org</owner>
<owner>cros-system-services@google.com</owner>
<summary>
The display zoom setting for the primary display, recorded on startup.
</summary>
</histogram>
<histogram name="Ash.DisplayChangeDialog.Saved" enum="BooleanSaved"
expires_after="2020-06-30">
<owner>zentaro@chromium.org</owner>
<owner>cros-peripherals@google.com</owner>
<summary>
Emitted when the user chooses an option on the Display Change Dialog that is
shown when a user changes the resolution of an external display.
</summary>
</histogram>
<histogram name="Ash.DisplayColorManager.HasColorCorrectionMatrix"
enum="Boolean" expires_after="M77">
<owner>mcasas@chromium.org</owner>
<owner>dcastagna@chromium.org</owner>
<summary>
Whether a display has a &quot;CTM&quot; matrix properties that can be used
to set a color transform matrix. Recorded every time there is a display
configuration update.
</summary>
</histogram>
<histogram name="Ash.DisplayColorManager.IccFileDownloaded"
enum="BooleanDownloaded" expires_after="M77">
<owner>mcasas@chromium.org</owner>
<owner>dcastagna@chromium.org</owner>
<summary>
This boolean keeps track if an ICC file was downloaded correctly (if true)
or a local file was reused instead.
</summary>
</histogram>
<histogram name="Ash.DisplayColorManager.ValidDisplayColorSpace" enum="Boolean"
expires_after="M77">
<owner>mcasas@chromium.org</owner>
<owner>dcastagna@chromium.org</owner>
<summary>
This boolean keeps track if a Display update (i.e. when connecting a new
one) carried valid ColorSpace information.
</summary>
</histogram>
<histogram name="Ash.DisplayColorManager.ValidProductId" enum="Boolean"
expires_after="M77">
<owner>mcasas@chromium.org</owner>
<owner>dcastagna@chromium.org</owner>
<summary>
Whether we could parse a valid product id from a display EDID. Recorded
every time there is a display configuration update.
</summary>
</histogram>
<histogram name="Ash.Dock.Action" enum="DockedAction" expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>wutao@chromium.org</owner>
<summary>
User-initiated action taken that affects docked windows such as docking,
undocking, minimizing, restoring, closing or just dragging a docked window.
</summary>
</histogram>
<histogram name="Ash.Dock.ActionSource" enum="DockedActionSource"
expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>wutao@chromium.org</owner>
<summary>
Source (mouse, touch, keyboard or unknown) of the user-initiated action for
docked windows.
</summary>
</histogram>
<histogram name="Ash.Dock.ItemsAll" units="units" expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>wutao@chromium.org</owner>
<summary>
Number of all docked windows or panels including hidden or minimized.
Recorded on every user action that interacts with docked windows.
</summary>
</histogram>
<histogram name="Ash.Dock.ItemsLarge" units="units" expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>wutao@chromium.org</owner>
<summary>
Number of large (wider than dock maximum width) windows that had to be
shrunk to get docked among the visible docked windows. Recorded on every
user action that interacts with docked windows.
</summary>
</histogram>
<histogram name="Ash.Dock.ItemsPanels" units="units" expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>wutao@chromium.org</owner>
<summary>
Number of docked visible panels. Recorded on every user action that
interacts with docked windows.
</summary>
</histogram>
<histogram name="Ash.Dock.ItemsVisible" units="units" expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>wutao@chromium.org</owner>
<summary>
Number of visible docked windows or panels. Recorded on every user action
that interacts with docked windows.
</summary>
</histogram>
<histogram name="Ash.Dock.TimeBetweenUse" units="seconds" expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>wutao@chromium.org</owner>
<summary>
Time elapsed between instances of docking, undocking or any other action
affecting docked state of a window.
</summary>
</histogram>
<histogram name="Ash.Dock.Width" units="pixels" expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>wutao@chromium.org</owner>
<summary>
Width of the docked area in pixels. Recorded every time it changes after a
user window resize operation is completed.
</summary>
</histogram>
<histogram name="Ash.DragWindowFromShelf.PresentationTime" units="ms"
expires_after="2021-02-03">
<owner>tbarzic@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
Presentation time in ms when a window is dragged from the bottom of the
shelf. Recorded when the drag action is in progress.
</summary>
</histogram>
<histogram name="Ash.DragWindowFromShelf.PresentationTime.MaxLatency"
units="ms" expires_after="2021-02-03">
<owner>tbarzic@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
Maximum latency of the presentation time in ms when a window is dragged from
the bottom of the shelf. Recorded when the drag action is finished.
</summary>
</histogram>
<histogram name="Ash.Homescreen.AnimationSmoothness" units="%"
expires_after="2020-08-01">
<owner>sammiequon@chromium.org</owner>
<owner>tbarzic@chromium.org</owner>
<summary>
Relative smoothness of animations when performing tablet mode homescreen
animations, recorded when the animation completes. 100% represents ideally
smooth 60 frames per second.
</summary>
</histogram>
<histogram name="Ash.HotseatGesture" enum="HotseatInAppGesture"
expires_after="2021-04-04">
<owner>andrewxu@chromium.org</owner>
<owner>tbarzic@chromium.org</owner>
<summary>Gestures supported by the in-app hotseat.</summary>
</histogram>
<histogram base="true" name="Ash.HotseatTransition.AnimationSmoothness"
units="%" expires_after="2020-10-11">
<!-- Name completed by histogram suffixes
name="HotseatTransitionType" -->
<owner>anasalazar@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
Tracks the animation smoothness for the ShelfWidget's animating background
during transitions of the hotseat to shown, extended, and hidden hotseat
states. Check Ash.HotseatWidgetAnimation.AnimationSmoothness for smoothness
of the HotseatWidget.
</summary>
</histogram>
<histogram name="Ash.HotseatTransition.Drag.PresentationTime" units="ms"
expires_after="2021-04-11">
<owner>anasalazar@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
Presentation time in ms of the hotseat when it changes between the hidden
and the extended state as a result of a drag action. Recorded when the drag
action is in progress.
</summary>
</histogram>
<histogram name="Ash.HotseatTransition.Drag.PresentationTime.MaxLatency"
units="ms" expires_after="2021-07-15">
<owner>anasalazar@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
Maximum latency of the presentation time in ms of the hotseat when it
changes between the hidden and the extended state as a result of a drag
action. Recorded when the drag action is finished.
</summary>
</histogram>
<histogram base="true" name="Ash.HotseatWidgetAnimation.AnimationSmoothness"
units="%" expires_after="2021-08-04">
<!-- Name completed by histogram suffixes
name="HotseatTransitionType" -->
<!-- Name completed by histogram suffixes
name="HotseatWidgetElement" -->
<owner>anasalazar@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
Tracks the animation smoothness for the bounds animation of the hotseat
widget's elements during transitions of the hotseat to shown, extended, and
hidden hotseat states. Check Ash.HotseatTransition.AnimationSmoothness for
smoothness of the shelf's animating background.
</summary>
</histogram>
<histogram name="Ash.ImmersiveFullscreen.WindowType" enum="WindowType"
expires_after="M77">
<obsolete>
Removed 10/2020 in Issue 1138662 - its recording code was deleted. This
histogram entry was added long time ago, likely when immersive fullscreen
was first added (circa 2014), and there is no records of what was learned.
</obsolete>
<owner>kuscher@google.com</owner>
<summary>
The type of the window which is put into immersive fullscreen. Immersive
fullscreen is entered via the F4 key.
</summary>
</histogram>
<histogram name="Ash.InteractiveWindowResize.TimeToPresent" units="ms"
expires_after="2021-02-14">
<owner>oshima@chromium.org</owner>
<owner>mukai@chromium.org</owner>
<summary>
Time between when the size of a window changes during an interactive window
resize and the results are drawn (presented) on screen. This is recorded for
each movement of the mouse/pointer that results in a resize.
</summary>
</histogram>
<histogram name="Ash.InteractiveWindowResize.TimeToPresent.MaxLatency"
units="ms" expires_after="2020-12-10">
<owner>oshima@chromium.org</owner>
<owner>mukai@chromium.org</owner>
<summary>
Maximum time between when the size of a window changes during an interactive
window resize and the results are drawn (presented) on screen. This is
recorded for each movement of the mouse/pointer that results in a resize.
</summary>
</histogram>
<histogram name="Ash.Login.Lock.AuthMethod.Switched"
enum="AuthMethodSwitchType" expires_after="2021-03-15">
<owner>rsorokin@chromium.org</owner>
<owner>cros-oac@google.com</owner>
<summary>
The count of auth method switching actions in ChromeOS lock screen.
</summary>
</histogram>
<histogram name="Ash.Login.Lock.AuthMethod.Used.ClamShellMode"
enum="AuthMethod" expires_after="2021-03-15">
<owner>rsorokin@chromium.org</owner>
<owner>cros-oac@google.com</owner>
<summary>
The usage of different auth methods (PIN / Password / Smartlock /
Fingerprint) in ChromeOS lock screen clamshell mode.
</summary>
</histogram>
<histogram name="Ash.Login.Lock.AuthMethod.Used.TabletMode" enum="AuthMethod"
expires_after="2021-03-15">
<owner>rsorokin@chromium.org</owner>
<owner>cros-oac@google.com</owner>
<summary>
The usage of different auth methods (PIN / Password / Smartlock /
Fingerprint) in ChromeOS lock screen tablet mode.
</summary>
</histogram>
<histogram name="Ash.Login.Lock.NbPasswordAttempts.UntilFailure"
units="attempts" expires_after="2021-05-27">
<owner>tellier@google.com</owner>
<owner>cros-oac@google.com</owner>
<summary>
The number of incorrect passwords entered in Chrome OS login/lock screen
until the user gives up (user signs out the current session or shuts down
the device).
</summary>
</histogram>
<histogram name="Ash.Login.Lock.NbPasswordAttempts.UntilSuccess"
units="attempts" expires_after="2021-05-27">
<owner>tellier@google.com</owner>
<owner>cros-oac@google.com</owner>
<summary>
The number of incorrect passwords entered in Chrome OS login/lock screen
until a successful attempt.
</summary>
</histogram>
<histogram name="Ash.Login.Lock.UserClicks" enum="LockScreenUserClickTarget"
expires_after="2021-03-15">
<owner>rsorokin@chromium.org</owner>
<owner>cros-oac@google.com</owner>
<summary>
The numbers of times that users click on the shelf buttons, trays and lock
screen note on the ChromeOS lock screen.
</summary>
</histogram>
<histogram name="Ash.Login.Login.MigrationBanner" enum="BooleanShown"
expires_after="2021-03-15">
<owner>rsorokin@chromium.org</owner>
<owner>cros-oac@google.com</owner>
<summary>
Whether the cryptohome migration banner was shown on the Chrome OS login
screen.
</summary>
</histogram>
<histogram name="Ash.Login.Login.UserClicks" enum="LoginScreenUserClickTarget"
expires_after="2021-03-15">
<owner>rsorokin@chromium.org</owner>
<owner>cros-oac@google.com</owner>
<summary>
The numbers of times that users click on the shelf buttons and trays on the
ChromeOS login screen.
</summary>
</histogram>
<histogram name="Ash.Login.OOBE.UserClicks" enum="OobeUserClickTarget"
expires_after="2021-02-14">
<owner>raleksandrov@google.com</owner>
<owner>cros-oac@google.com</owner>
<summary>What shelf buttons or trays are clicked in the OOBE.</summary>
</histogram>
<histogram name="Ash.Login.PinAutosubmit.Backfill"
enum="PinAutosubmitBackfillEvent" expires_after="2021-03-30">
<owner>rrsilva@google.com</owner>
<owner>cros-oac@google.com</owner>
<summary>
The result of the PIN auto submit 'Backfill' operation. Users updating to
M86 with an existing PIN will have their preference regarding auto submit
'backfilled' to either enabled or disabled.
</summary>
</histogram>
<histogram base="true" name="Ash.NavigationWidget.AnimationSmoothness"
units="%" expires_after="2021-05-31">
<!-- Name completed by histogram suffixes
name="HotseatTransitionType" -->
<!-- Name completed by histogram suffixes
name="NavigationWidgetElement" -->
<owner>anasalazar@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
Relative smoothness of animations of the navigation widget's elements, which
are the widget itself and its child views. 100% represents ideally smooth 60
frames per second. 50% represents only 30 frames per second is achieved
during the animations. Recorded every time an animation is triggered in the
Navigation Widget. We record this metric for each element separately.
</summary>
</histogram>
<histogram name="Ash.NightLight.AutoNightLightNotificationShown"
enum="BooleanShown" expires_after="2020-12-02">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>Emitted when the Auto Night Light notification is shown.</summary>
</histogram>
<histogram name="Ash.NightLight.AutoNightLightNotificationState"
enum="AshAutoNightLightNotificationState" expires_after="2020-12-02">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Emitted when the user interacts with the Auto Night Light notification to
report the state of the notification as a result of this interaction.
</summary>
</histogram>
<histogram name="Ash.NightLight.DisplayCrtcCtmSupport"
enum="AshNightLightDisplayCrtcCtmSupportType" expires_after="2021-02-10">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
The type of CRTC color transorm matrix support for the currently connected
displays. Emitted when cursor compositing status is refreshed, but only when
Night Light is on. The cursor compositing status is refreshed whenever there
is a change in Night Light status or color temperature.
</summary>
</histogram>
<histogram name="Ash.NightLight.ScheduleType" enum="AshNightLightScheduleType"
expires_after="2021-04-11">
<owner>afakhry@chromium.org</owner>
<summary>
The selected Night Light schedule type. Emitted when the user changes the
Night Light schedule type from the Display System Settings.
</summary>
</histogram>
<histogram name="Ash.NightLight.Temperature"
enum="AshNightLightTemperatureRanges" expires_after="2021-02-07">
<owner>afakhry@chromium.org</owner>
<summary>
The ranges in which the selected values of the Night Light color temperature
reside. Emitted when the user drags the Night Light color temperature slider
to change its value from the Display System Settings.
</summary>
</histogram>
<histogram name="Ash.NumberOfVisibleWindowsInPrimaryDisplay" units="Windows"
expires_after="2021-04-04">
<owner>jamescook@chromium.org</owner>
<summary>
An upper bound on the number of windows visible to the user on the primary
display. Determined by processing the windows in increasing z-order and
counting all non-minimized windows until a maximized or fullscreen window is
processed. This metric is logged periodically every 30 minutes.
</summary>
</histogram>
<histogram base="true" name="Ash.Overview.AnimationSmoothness.Close" units="%"
expires_after="2021-12-31">
<!-- Name completed by histogram_suffixes
name="TabletOrClamshellMode" -->
<owner>omrilio@chromium.org</owner>
<owner>oshima@chromium.org</owner>
<summary>
Relative smoothness of animations when closing a window, recorded when the
animation completes. 100% represents ideally smooth 60 frames per second.
</summary>
</histogram>
<histogram base="true" name="Ash.Overview.AnimationSmoothness.Enter" units="%"
expires_after="2021-12-31">
<!-- Name completed by histogram_suffixes
name="OverviewAnimationMode" -->
<owner>omrilio@chromium.org</owner>
<owner>oshima@chromium.org</owner>
<summary>
Relative smoothness of animations when entering overview mode, recorded when
the animation completes. 100% represents ideally smooth 60 frames per
second.
</summary>
</histogram>
<histogram base="true" name="Ash.Overview.AnimationSmoothness.Exit" units="%"
expires_after="2021-12-31">
<!-- Name completed by histogram_suffixes
name="OverviewAnimationMode" -->
<owner>omrilio@chromium.org</owner>
<owner>oshima@chromium.org</owner>
<summary>
Relative smoothness of animations when exiting overview mode, recorded when
the animation completes. 100% represents ideally smooth 60 frames per
second.
</summary>
</histogram>
<histogram name="Ash.Overview.Scroll.PresentationTime.MaxLatency.TabletMode"
units="ms" expires_after="2021-12-31">
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Maximum latency of the presentation time for scrolling the overview grid in
overview mode for a scrolling session.
</summary>
</histogram>
<histogram name="Ash.Overview.Scroll.PresentationTime.TabletMode" units="ms"
expires_after="2021-12-31">
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Presentation time for scrolling the overview grid in overview mode. Each
time the grid is updated by a scroll, the time it takes to update the new
visuals onto the screen is updated.
</summary>
</histogram>
<histogram base="true" name="Ash.Overview.WindowDrag.PresentationTime"
units="ms" expires_after="2021-12-31">
<!-- Name completed by histogram_suffixes
name="TabletOrClamshellMode" -->
<owner>omrilio@chromium.org</owner>
<owner>oshima@chromium.org</owner>
<summary>Presentation time for dragging a window in overview mode.</summary>
</histogram>
<histogram base="true"
name="Ash.Overview.WindowDrag.PresentationTime.MaxLatency" units="ms"
expires_after="2021-12-31">
<!-- Name completed by histogram_suffixes
name="TabletOrClamshellMode" -->
<owner>omrilio@chromium.org</owner>
<owner>oshima@chromium.org</owner>
<summary>
Maximum latency of the presentation time for dragging a window in overview
mode.
</summary>
</histogram>
<histogram name="Ash.Overview.WindowDrag.Workflow" enum="OverviewDragAction"
expires_after="2020-12-12">
<owner>amusbach@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
Recorded when a drag from overview (not from the top or shelf) is completed,
and when an overview item is closed by vertically swiping or flinging (even
if you fling without dragging).
</summary>
</histogram>
<histogram name="Ash.PersistentWindow.NumOfWindowsRestored" units="units"
expires_after="M82">
<owner>zentaro@chromium.org</owner>
<owner>baileyberro@chromium.org</owner>
<summary>
The number of windows restored in multi-display scenario, such as due to
disconnecting and reconnecting display, enabling and disabling mirror mode,
entering and leaving dock mode. Zero is not recorded.
</summary>
</histogram>
<histogram name="Ash.PhoneHub.InterstitialScreenEvent.{ScreenName}"
enum="PhoneHubInterstitialScreenEvent" expires_after="2021-10-31">
<!-- Name completed by histogram_suffixes name="PhoneHubInterstitialScreen" -->
<owner>tengs@chromium.org</owner>
<owner>khorimoto@chromium.org</owner>
<summary>Events for the given PhoneHub interstitial screen.</summary>
<token key="ScreenName">
<variant name="BluetoothOrWifiDisabled"/>
<variant name="ConnectionError"/>
<variant name="InitialConnecting"/>
<variant name="NotificationOptIn"/>
<variant name="Onboarding.ExistingMultideviceUser"/>
<variant name="Onboarding.NewMultideviceUser"/>
<variant name="Reconnecting"/>
</token>
</histogram>
<histogram name="Ash.Pip.AndroidPipUseTime" units="ms"
expires_after="2021-06-16">
<owner>takise@chromium.org</owner>
<owner>linben@chromium.org</owner>
<summary>How long Android PIP was used for, upon ending the session.</summary>
</histogram>
<histogram name="Ash.Pip.Events" enum="AshPipEvents" expires_after="2021-06-16">
<owner>takise@chromium.org</owner>
<owner>linben@chromium.org</owner>
<summary>
Various individiual Picture-in-picture related events. See AshPipEvents.
</summary>
</histogram>
<histogram name="Ash.Pip.FreeResizeFinishArea" units="%"
expires_after="2021-06-16">
<owner>takise@chromium.org</owner>
<owner>linben@chromium.org</owner>
<summary>
Area of a Picture-in-picture window when ending a free-resize, as a
percentage of the area it takes up on the display it is on.
</summary>
</histogram>
<histogram name="Ash.Pip.FreeResizeInitialArea" units="%"
expires_after="2021-06-16">
<owner>takise@chromium.org</owner>
<owner>linben@chromium.org</owner>
<summary>
Initial area of a Picture-in-picture window when beginning a free-resize, as
a percentage of the area it takes up on the display it is on.
</summary>
</histogram>
<histogram name="Ash.Pip.Position" enum="AshPipPosition"
expires_after="2021-06-16">
<owner>takise@chromium.org</owner>
<owner>linben@chromium.org</owner>
<summary>
The position that a Picture-in-picture window was moved to by a user drag.
</summary>
</histogram>
<histogram name="Ash.PowerButtonScreenshot.DelayBetweenAccelKeyPressed"
units="ms" expires_after="2020-11-15">
<owner>zentaro@chromium.org</owner>
<owner>baileyberro@chromium.org</owner>
<summary>
Record the delay when power button and volume down key are both pressed,
which indicates user might want to use accelerator to take screenshot. This
will help us determine the best chord delay among metrics.
</summary>
</histogram>
<histogram name="Ash.Rotation.AnimationSmoothness" units="%"
expires_after="2021-07-26">
<owner>oshima@chromium.org</owner>
<owner>wutao@chromium.org</owner>
<summary>
Relative smoothness of animations when rotating screen. 100% represents
ideally smooth 60 frames per second. 50% represents only 30 frames per
second is achieved during the animations. 0% should not happen. This metric
is recorded exactly once when the user rotates the screen.
</summary>
</histogram>
<histogram name="Ash.ScreenshotController.ScreenshotsPerDay" units="int"
expires_after="2021-09-29">
<owner>xiyuan@chromium.org</owner>
<owner>gzadina@google.com</owner>
<summary>
Records the number of screenshots that have been taken via the
ScreenshotController every 24 hours. Note that counts are not persisted
across crashes, restarts, or sessions so this is only intended to give a
rough approximation.
</summary>
</histogram>
<histogram name="Ash.ScreenshotController.ScreenshotsPerWeek" units="int"
expires_after="2021-09-29">
<owner>xiyuan@chromium.org</owner>
<owner>gzadina@google.com</owner>
<summary>
Records the number of screenshots that have been taken via the
ScreenshotController every 7 days. Note that counts are not persisted across
crashes, restarts, or sessions so this is only intended to give a rough
approximation. This means that this metric will only be recorded in sessions
spanning at least 7 days.
</summary>
</histogram>
<histogram name="Ash.Shelf.Menu.NumItemsEnabledUponSelection" units="Count"
expires_after="2021-01-26">
<owner>anasalazar@google.com</owner>
<owner>mmourgos@google.com</owner>
<summary>
Tracks the number of menu items that are enabled in a shelf item's secondary
menu. This metric is only recorded when a menu item is selected.
</summary>
</histogram>
<histogram name="Ash.Shelf.Menu.SelectedMenuItemIndex" units="Index"
expires_after="2021-01-26">
<owner>anasalazar@google.com</owner>
<owner>mmourgos@google.com</owner>
<summary>
Tracks the index of the selected menu item in a shelf item's secondary menu.
This metric is only recorded when a menu item is selected.
</summary>
</histogram>
<histogram name="Ash.Shelf.NavigationButtonsInTabletMode.ReasonShown"
enum="ReasonToShowShelfNavigationButtons" expires_after="2021-05-01">
<owner>tbarzic@chromium.org</owner>
<owner>gzadina@google.com</owner>
<summary>
The reason shelf navigation buttons are shown in tablet mode. The buttons
are shown when the device is in tablet mode only if certain accessibility
settings are enabled. This histogram records which accessibility setting
caused the buttons to be shown. Shown when navigation buttons visibility
changes in tablet mode, and only if HideShelfControlsInTabletMode feature is
enabled.
</summary>
</histogram>
<histogram name="Ash.Shelf.NumberOfItems" units="Icons"
expires_after="2021-01-17">
<owner>anasalazar@google.com</owner>
<owner>mmourgos@google.com</owner>
<summary>
The number of icons in the shelf, not including the App Launcher icon. This
metric is recorded every 30 minutes.
</summary>
</histogram>
<histogram name="Ash.Shelf.NumberOfPinnedItems" units="Icons"
expires_after="2021-04-11">
<owner>anasalazar@google.com</owner>
<owner>mmourgos@google.com</owner>
<summary>
The number of pinned icons in the shelf, not including the App Launcher
icon. This metric is recorded every 30 minutes.
</summary>
</histogram>
<histogram name="Ash.Shelf.NumberOfUnpinnedItems" units="Icons"
expires_after="2021-03-21">
<owner>anasalazar@google.com</owner>
<owner>mmourgos@google.com</owner>
<summary>
The number of unpinned icons in the shelf. This metric is recorded every 30
minutes.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Assistant.CircledPercentage" units="%"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The percentage of the screen area circled by the Assistant pen. Recorded
when the &quot;closed shape&quot; gesture is recognized.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Assistant.GestureDuration" units="ms"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The duration of an Assistant pen gesture. Recorded at the end of every
gesture.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Assistant.GestureInterval" units="ms"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The interval between subsequent Assistant pen gestures within a session.
Session is defined as the period while the Assistant tool is enabled.
Recorded at the end of each gesture except for the first one in the session.
The interval is computed excluding the gesture duration.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Assistant.GesturesPerSession" units="units"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The number of Assistant pen gestures per session. Session is defined as the
period while the Assistant tool is enabled. Recorded at the end of the
session.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Assistant.GesturesPerSession.Recognized"
units="units" expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The number of recognized Assistant pen gestures per session. Session is
defined as the period while the Assistant tool is enabled. Recorded at the
end of the session.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Assistant.GestureType"
enum="AssistantGestureType" expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The type of the Assistant pen gesture. Recorded at the end of each gesture.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Assistant.HighlighterLength" units="dp"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The length of a recognized &quot;horizontal stroke&quot; Assistant pen
gesture. Recorded at the and of the gesture.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.InAssistantMode" units="ms"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The amount of time spent in Palette Assistant mode. Recorded when the
Assistant mode is exited.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.InLaserPointerMode" units="ms"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The amount of time spend in Palette Laser pointer mode. Recorded when the
Laser pointer mode is exited.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.InMagnifyMode" units="ms"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The amount of time spend in Palette Magnify mode. Recorded when the Magnify
mode is exited.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.ModeCancellation"
enum="PaletteModeCancelType" expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
Tracks the number of times a palette mode is explicitly cancelled or
switched out of.
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Usage" enum="PaletteTrayOptions"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
Recorded every time that the palette option has been selected from the
palette that has been opened manually (not via a stylus eject event).
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Usage.AutoOpened" enum="PaletteTrayOptions"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
Recorded every time that the palette option has been selected from the
palette that has been opened automatically (by a stylus eject event).
</summary>
</histogram>
<histogram name="Ash.Shelf.Palette.Usage.Shortcut" enum="PaletteTrayOptions"
expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
Recorded every time that the palette option has been selected by means other
that the palette menu (e.g. stylus barrel button or a keyboard accelerator).
</summary>
</histogram>
<histogram name="Ash.Shelf.TimeBetweenNavigateToTaskSwitches" units="seconds"
expires_after="M81">
<owner>tbuckley@chromium.org</owner>
<summary>
The number of seconds between contiguous task switch user actions triggered
by the Shelf buttons where the user activates a different user-predictable
task. Task switches from other sources are ignored and do not affect this
metric. In other words, if a user performs the following steps (1) launch
task 'A' from the Shelf (2) Alt+Tab to task 'Z' (3) launch task 'B' from the
Shelf, then this will result in a sample recorded for the time delta between
launching tasks 'A' and 'B'.
</summary>
</histogram>
<histogram name="Ash.Shelf.TimeBetweenWindowMinimizedAndActivatedActions"
units="ms" expires_after="2020-06-28">
<owner>tbuckley@chromium.org</owner>
<summary>
Tracks the amount of time between a window being minimized by the shelf and
subsequently activated. In other words this metric is only recorded if a
shelf button pressed action causes a window to be minimized and the very
next shelf button pressed action causes the same window to be activated.
</summary>
</histogram>
<histogram name="Ash.Shelf.UkmLogger.HasNightLightSchedule" enum="Boolean"
expires_after="2020-09-27">
<owner>wrong@chromium.org</owner>
<owner>jiameng@chromium.org</owner>
<summary>
Whether or not the user had set up a night light schedule at the time of
night light event logging.
</summary>
</histogram>
<histogram name="Ash.Shelf.UkmLogger.NumAvailableBluetoothDevices"
units="count" expires_after="2020-09-27">
<owner>wrong@chromium.org</owner>
<owner>jiameng@chromium.org</owner>
<summary>
The number of Bluetooth devices available at the time of Bluetooth event
logging.
</summary>
</histogram>
<histogram name="Ash.ShelfAlignmentOverTime" enum="ShelfAlignmentValue"
expires_after="2020-11-22">
<owner>kuscher@google.com</owner>
<summary>
The current state of the shelf (alignment) tracked over time by logging on a
regular basis (30 minutes), this is used instead of log in or shelf usage to
track users that do not lock/unlock or log in frequently and use a small
number of browser instances or otherwise infrequently interact with the
shelf launcher.
</summary>
</histogram>
<histogram name="Ash.ShelfAlignmentUsage" enum="ShelfAlignmentValue"
expires_after="never">
<!-- expires-never: Monitors core shelf behavior/usage (the shelf alignment) -->
<owner>kuscher@google.com</owner>
<owner>tbarzic@chromium.org</owner>
<summary>
The current state of the shelf (alignment) when the shelf launcher is used
to launch an app/window/etc, this is used instead of log in to give data on
users that do not lock/unlock or log in frequently.
</summary>
</histogram>
<histogram name="Ash.ShelfIcon.AnimationSmoothness" units="%"
expires_after="2021-03-30">
<owner>andrewxu@chromium.org</owner>
<owner>newcomer@chromium.org</owner>
<summary>
Relative smoothness of animations of the shelf icons. 100% represents
ideally smooth 60 frames per second. Recorded when shelf icon animations are
completed, including icon move, icon fade-in and icon fade-out.
</summary>
</histogram>
<histogram name="Ash.SplitView.TimeInMultiDisplaySplitView" units="ms"
expires_after="2020-12-12">
<owner>amusbach@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
The amount of time that the user spent in multi-display split view mode,
meaning that split view is active on more than one display. The time is
measured from when the number of displays in split view becomes more than
one to when it drops back down to one.
</summary>
</histogram>
<histogram name="Ash.SplitView.TimeInSplitView" units="ms" expires_after="M92">
<owner>xdai@chromium.org</owner>
<summary>
The amount of time that the user spent in split view mode. The time is
measured from the moment a window is snapped to one side of the screen to
when split view mode is ended.
</summary>
</histogram>
<histogram name="Ash.SplitViewResize.AnimationSmoothness.DividerAnimation"
units="%" expires_after="2021-06-15">
<owner>sammiequon@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
Relative smoothness of animation when releasing the split view divider,
recorded when the animation completes. 100% represents ideally smooth 60
frames per second.
</summary>
</histogram>
<histogram base="true" name="Ash.SplitViewResize.PresentationTime" units="ms"
expires_after="2020-12-12">
<!-- Name completed by histogram_suffixes name="SplitViewResizeModes" -->
<owner>amusbach@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<owner>omrilio@chromium.org</owner>
<owner>oshima@chromium.org</owner>
<summary>
Presentation time while resizing one or two split view windows.
</summary>
</histogram>
<histogram base="true" name="Ash.SplitViewResize.PresentationTime.MaxLatency"
units="ms" expires_after="2020-12-12">
<!-- Name completed by histogram_suffixes name="SplitViewResizeModes" -->
<owner>amusbach@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<owner>omrilio@chromium.org</owner>
<owner>oshima@chromium.org</owner>
<summary>
Maximum latency of the presentation time while resizing one or two split
view windows.
</summary>
</histogram>
<histogram name="Ash.SwipeDownDrag.Tab.PresentationTime.MaxLatency.TabletMode"
units="ms" expires_after="2021-10-18">
<owner>xdai@chromium.org</owner>
<owner>omrilio@chromium.org</owner>
<summary>
Maximum latency of the presentation timestamp while dragging a tab in tablet
mode.
</summary>
</histogram>
<histogram name="Ash.SwipeDownDrag.Tab.PresentationTime.TabletMode" units="ms"
expires_after="2021-10-18">
<owner>xdai@chromium.org</owner>
<owner>omrilio@chromium.org</owner>
<summary>Presentation time while dragging a tab in tablet mode.</summary>
</histogram>
<histogram
name="Ash.SwipeDownDrag.Window.PresentationTime.MaxLatency.TabletMode"
units="ms" expires_after="2021-10-18">
<owner>xdai@chromium.org</owner>
<owner>omrilio@chromium.org</owner>
<summary>
Maximum latency of the presentation timestamp while dragging maximized
window in tablet mode.
</summary>
</histogram>
<histogram name="Ash.SwipeDownDrag.Window.PresentationTime.TabletMode"
units="ms" expires_after="2021-10-18">
<owner>xdai@chromium.org</owner>
<owner>omrilio@chromium.org</owner>
<summary>
Presentation time while dragging maximized window in tablet mode.
</summary>
</histogram>
<histogram name="Ash.SwipeHomeToOverviewGesture"
enum="SwipeHomeToOverviewResult" expires_after="2021-04-04">
<owner>andrewxu@chromium.org</owner>
<owner>tbarzic@chromium.org</owner>
<summary>
Boolean indicating whether a swipe from hotseat on home screen resulted in a
transition to overview.
</summary>
</histogram>
<histogram name="Ash.SystemMenu.DefaultView.VisibleRows"
enum="SystemMenuDefaultViewRows" expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The visible rows displayed in the system menu's default view. Recorded each
time the menu is opened.
</summary>
</histogram>
<histogram name="Ash.SystemMenu.PercentageOfWorkAreaHeightCoveredByMenu"
units="%" expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The height of the system menu divided by the height of the Ash desktop work
area; a value over 100% indicates that a portion of the system menu is not
visible to the user. Recorded each time the menu is opened.
</summary>
</histogram>
<histogram name="Ash.SystemMenu.Rows" units="rows" expires_after="2021-07-27">
<owner>tengs@chromium.org</owner>
<owner>gzadina@chromium.org</owner>
<summary>
The number of user-visible rows in the system menu's default view. Recorded
each time the menu is opened.
</summary>
</histogram>
<histogram name="Ash.TabletMode.AnimationSmoothness.Enter" units="%"
expires_after="2021-02-21">
<owner>oshima@chromium.org</owner>
<owner>sammiequon@chromium.org</owner>
<summary>
Relative smoothness of animations when entering tablet mode, recorded when
the animation completes. 100% represents ideally smooth 60 frames per
second.
</summary>
</histogram>
<histogram name="Ash.TabletMode.AnimationSmoothness.Exit" units="%"
expires_after="2021-02-14">
<owner>oshima@chromium.org</owner>
<owner>sammiequon@chromium.org</owner>
<summary>
Relative smoothness of animations when exiting tablet mode, recorded when
the animation completes. 100% represents ideally smooth 60 frames per
second.
</summary>
</histogram>
<histogram name="Ash.TimeBetweenTaskSwitches" units="seconds"
expires_after="M81">
<owner>tbuckley@google.com</owner>
<summary>
The number of seconds between contiguous task switch user actions triggered
by any of the other task switch actions that are tracked. (e.g.,
Ash.Shelf.TimeBetweenNavigateToTaskSwitches,
Ash.Tab.TimeBetweenSwitchToExistingTabUserActions,
Ash.WindowCycleController.TimeBetweenTaskSwitches,
Ash.AppList.TimeBetweenTaskSwitches,
Ash.WindowSelector.TimeBetweenActiveWindowChanges, etc). Note the
Ash.AppList.TimeBetweenTaskSwitches and
Ash.Tab.TimeBetweenSwitchToExistingTabUserActions histograms were deprecated
and removed in 10/2016.
</summary>
</histogram>
<histogram name="Ash.TouchMoveSteps" units="pixels" expires_after="M85">
<owner>kuscher@google.com</owner>
<owner>rbyers@chromium.org</owner>
<summary>The distance between touch-move events.</summary>
</histogram>
<histogram name="Ash.TouchStartAfterEnd" units="ms" expires_after="M77">
<owner>kuscher@google.com</owner>
<summary>
The interval between the end of a touch-sequence and the start of the next
touch-sequence.
</summary>
</histogram>
<histogram name="Ash.TouchView.LidAngle" units="degrees"
expires_after="2021-03-15">
<owner>oshima@chromium.org</owner>
<summary>
Chrome OS only. The computed angle between the lid and the keyboard panel.
These values are imprecise and may be tens of degrees off from reality.
Reported once per hour that the system is awake, and not reported if the
system doesn't have two accelerometers.
</summary>
</histogram>
<histogram name="Ash.TouchView.TouchViewActive" units="ms"
expires_after="2021-04-11">
<owner>girard@chromium.org</owner>
<summary>
The length of time that TouchView is active, for each activation.
</summary>
</histogram>
<histogram name="Ash.TouchView.TouchViewActivePercentage" units="%"
expires_after="2021-04-04">
<owner>girard@chromium.org</owner>
<summary>The proportion of time spent in TouchView during a session.</summary>
</histogram>
<histogram name="Ash.TouchView.TouchViewActiveTotal" units="minutes"
expires_after="2021-04-04">
<owner>girard@chromium.org</owner>
<summary>The total time that TouchView is active during a session.</summary>
</histogram>
<histogram name="Ash.TouchView.TouchViewInactive" units="ms"
expires_after="2021-03-15">
<owner>girard@chromium.org</owner>
<summary>The length of time between TouchView activations.</summary>
</histogram>
<histogram name="Ash.TouchView.TouchViewInactiveTotal" units="minutes"
expires_after="2021-02-14">
<owner>girard@chromium.org</owner>
<summary>
The total time that TouchView is not active during a session.
</summary>
</histogram>
<histogram name="Ash.Wallpaper.ColorExtractionResult2"
enum="WallpaperColorExtractionResult" expires_after="M92">
<owner>newcomer@chromium.org</owner>
<owner>tbuckley@chromium.org</owner>
<summary>
Tracks the success rate for wallpaper color extraction. Recorded each time
the wallpaper image changes for each extracted wallpaper prominent color.
</summary>
</histogram>
<histogram name="Ash.Wallpaper.CustomLayout" enum="WallpaperLayout"
expires_after="M92">
<owner>xdai@chromium.org</owner>
<summary>
The custom wallpaper layout type. Recorded when the user sets a new custom
wallpaper or changes the existing custom wallpaper's layout.
</summary>
</histogram>
<histogram name="Ash.Wallpaper.Source" enum="WallpaperType" expires_after="M92">
<owner>xdai@chromium.org</owner>
<summary>
Recorded when a new wallpaper is set, either by the built-in Wallpaper
Picker App, or by a third party App. Note the wallpaper change triggered by
Sync file system event doesn't count.
</summary>
</histogram>
<histogram name="Ash.Wallpaper.Type" enum="WallpaperType" expires_after="M92">
<owner>kuscher@google.com</owner>
<summary>The wallpaper type. Recorded at user login.</summary>
</histogram>
<histogram name="Ash.Window.AnimationSmoothness.CrossFade" units="%"
expires_after="2021-03-28">
<owner>wutao@chromium.org</owner>
<summary>
Relative smoothness of cross fade animation when setting window bounds. 100%
represents ideally smooth 60 frames per second. 50% represents when only 30
frames per second is achieved during the animations. 0% should not happen.
This metric is recorded exactly once when SetBoundsDirectCrossFade is
called, such as when window is maximized.
</summary>
</histogram>
<histogram name="Ash.Window.AnimationSmoothness.CrossFade.DragMaximize"
units="%" expires_after="2021-06-18">
<owner>sammiequon@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
When dragging a maximized window, the window will shrink to restore bounds.
Dragging the window back to the top of the screen will expand the window.
This histogram will be recorded to measure the smoothenss of the expand
animation. 100% represents ideally smooth 60 frames per second. 50%
represents when only 30 frames per second is achieved during the animations.
0% should not happen.
</summary>
</histogram>
<histogram name="Ash.Window.AnimationSmoothness.CrossFade.DragUnmaximize"
units="%" expires_after="2021-06-18">
<owner>sammiequon@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
When dragging a maximized window, the window will shrink to restore bounds.
This histogram will be recorded to measure the smoothness of the shrink
animation. 100% represents ideally smooth 60 frames per second. 50%
represents when only 30 frames per second is achieved during the animations.
0% should not happen.
</summary>
</histogram>
<histogram name="Ash.Window.AnimationSmoothness.Hide" units="%"
expires_after="2021-07-01">
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Relative smoothness of hiding window animation. 100% represents ideally
smooth 60 frames per second. 50% represents when only 30 frames per second
is achieved during the animations. 0% should not happen. This metric is
recorded exactly once when AnimateHideWindowCommon is called, such as when
window is closed.
</summary>
</histogram>
<histogram name="Ash.Window.AnimationSmoothness.Snap" units="%"
expires_after="2021-07-01">
<owner>oshima@chromium.org</owner>
<owner>sammiequon@chromium.org</owner>
<summary>
Relative smoothness of snapping window animation. 100% represents ideally
smooth 60 frames per second. 50% represents when only 30 frames per second
is achieved during the animations. 0% should not happen. This metric is
recorded exactly once when a window is snapped to the left or right in
clamshell mode using the alt + [ or ] accelerator, but only if the size of
the window's bounds change.
</summary>
</histogram>
<histogram name="Ash.WindowCycleController.DesksSwitchDistance" units="units"
expires_after="2021-02-21">
<owner>afakhry@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
Emitted when the user ends window cycling via Alt-Tab, if and only if user
had 2 or more desks and a new window was activated, to report the distance
between the active desks before and after window cycling. A distance of 0
means no desks switch occurred.
</summary>
</histogram>
<histogram name="Ash.WindowCycleController.Items" units="items"
expires_after="2021-03-15">
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
The number of windows in the Alt+Tab selector. Only recorded once when
cycling starts, not every time when Tab is pressed without releasing Alt.
</summary>
</histogram>
<histogram name="Ash.WindowCycleController.TimeBetweenTaskSwitches"
units="seconds" expires_after="2021-03-15">
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<owner>xdai@chromium.org</owner>
<summary>
The number of seconds between task switches triggered by the next window and
previous window accelerator keys (ie Alt+Tab, Alt+Shift+Tab).
</summary>
</histogram>
<histogram name="Ash.WindowCycleView.AnimationSmoothness.Container" units="%"
expires_after="2020-12-22">
<owner>yjliu@chromium.org</owner>
<owner>chromeos-wmp@google.com</owner>
<summary>
Relative smoothness of showing window animation when the window cycle view
moves the next window into position when alt + tab is pressed. 100%
represents ideally smooth 60 frames per second. 50% represents when only 30
frames per second is achieved during the animations. 0% should not happen.
</summary>
</histogram>
<histogram name="Ash.WindowCycleView.AnimationSmoothness.Show" units="%"
expires_after="2021-03-15">
<owner>yjliu@chromium.org</owner>
<owner>chromeos-wmp@google.com</owner>
<summary>
Relative smoothness of showing window animation when the window cycle view
starts. 100% represents ideally smooth 60 frames per second. 50% represents
when only 30 frames per second is achieved during the animations. 0% should
not happen.
</summary>
</histogram>
<histogram name="Ash.WindowDragFromShelfResult" enum="ShelfWindowDragResult"
expires_after="2021-04-04">
<owner>andrewxu@chromium.org</owner>
<owner>tbarzic@chromium.org</owner>
<summary>
The final state after window drag gesture that started from the system shelf
in tablet mode.
</summary>
</histogram>
<histogram name="Ash.WindowManager.Lock.Success" units="ms" expires_after="M77">
<owner>jdufault@chromium.org</owner>
<summary>
How long it took for the screen lock process to complete. This does not
include timeouts.
</summary>
</histogram>
<histogram name="Ash.WindowManager.Lock.Timeout" units="ms" expires_after="M77">
<owner>jdufault@chromium.org</owner>
<summary>
How long it took for the screen lock process to complete, for timeouts only.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.ArrowKeyPresses" units="units"
expires_after="M81">
<owner>flackr@chromium.org</owner>
<summary>
The number of times the arrow keys are pressed in overview mode per session,
i.e. between bringing up overview mode and ending it. This is only measured
for the sessions that end by selecting a window with the enter key.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.Items" units="units"
expires_after="2020-10-04">
<owner>flackr@chromium.org</owner>
<owner>kuscher@google.com</owner>
<summary>
The number of items (single windows or groups of windows such as panels) in
the overview mode, present at the start of each session.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.ItemsWhenTextFilteringUsed" units="items"
expires_after="M77">
<owner>flackr@chromium.org</owner>
<summary>
The number of items showing in overview mode at the moment when an item is
selected or when selection is canceled. Only recorded if the text filtering
textfield contains a non-empty string.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.KeyPressesOverItemsRatio" units="%"
expires_after="2020-03-01">
<owner>flackr@chromium.org</owner>
<summary>
The ratio between the arrow key presses and the number of overview items,
expressed as a percentage for a single session.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.OverviewClosedItems" units="units"
expires_after="2020-01-26">
<owner>flackr@chromium.org</owner>
<summary>
The number of items closed from the window overview for a single session.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.SelectionDepth" units="items"
expires_after="2021-09-29">
<owner>sammiequon@chromium.org</owner>
<owner>tclaiborne@chromium.org</owner>
<summary>
When a window is selected in overview mode, records that window's position
in the global MRU ordering. 1 represents the most-recently used window, 2
represents the next most-recently used window, and so on.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.TextFilteringStringLength"
units="characters" expires_after="M77">
<owner>flackr@chromium.org</owner>
<summary>
The length of the string entered into the text filtering textfield at the
moment when an item is selected or when selection is canceled.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.TextFilteringTextfieldCleared"
units="units" expires_after="M77">
<owner>flackr@chromium.org</owner>
<summary>
The number of times the text filtering textfield has had all of its text
removed within a single overview mode session. Measured from the time
overview mode is invoked to when an item is selected or when selection is
canceled.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.TimeBetweenActiveWindowChanges"
units="seconds" expires_after="M81">
<owner>tbuckley@chromium.org</owner>
<summary>
The amount of time between endings of overview mode sessions which were
caused by the user selecting a window which was not previously active. Only
recorded on the second and later times after startup that the user selected
a window which was not previously active.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.TimeBetweenUse" units="ms"
expires_after="M82">
<owner>flackr@chromium.org</owner>
<owner>kuscher@google.com</owner>
<summary>
The amount of time between uses of overview mode, recorded when overview
mode is entered. Only recorded on the second and later times after startup
that the user entered overview mode.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.TimeInOverview" units="ms"
expires_after="2020-10-18">
<owner>flackr@chromium.org</owner>
<owner>kuscher@google.com</owner>
<summary>
The amount of time spent in overview mode. Overview mode is engaged by
pressing the overview button. The time is measured from the moment the
windows begin animating to a thumbnail size preview to when a window is
selected or selection is canceled.
</summary>
</histogram>
<histogram name="Ash.WindowSelector.TimeInOverviewWithTextFiltering" units="ms"
expires_after="M85">
<owner>flackr@chromium.org</owner>
<summary>
The amount of time spent in overview mode when text filtering is used. The
time is measured from the moment the windows begin animating to a thumbnail
size preview to when a window is selected or selection is canceled. Only
recorded if the text filtering textfield contains a non-empty string.
</summary>
</histogram>
<histogram
name="Ash.WorkspaceWindowResizer.TabDragging.PresentationTime.ClamshellMode"
units="ms" expires_after="2021-02-03">
<owner>yichenz@chromium.org</owner>
<owner>chromeos-wmp@google.com</owner>
<summary>
Presentation time in ms when a tab is dragged in clamshell mode. Each time
the tab is dragged within a display, the time it takes to present the new
frame on screen is recorded.
</summary>
</histogram>
<histogram
name="Ash.WorkspaceWindowResizer.TabDragging.PresentationTime.MaxLatency.ClamshellMode"
units="ms" expires_after="2021-02-03">
<owner>yichenz@chromium.org</owner>
<owner>chromeos-wmp@google.com</owner>
<summary>
Maximum presentation time recorded during the tab dragging session.
</summary>
</histogram>
</histograms>
</histogram-configuration>