1 // Copyright 2013 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #include "ash/metrics/user_metrics_recorder.h"
7 #include "ash/shelf/shelf_layout_manager.h"
8 #include "ash/shelf/shelf_view.h"
9 #include "ash/shelf/shelf_widget.h"
10 #include "ash/shell.h"
11 #include "ash/shell_window_ids.h"
12 #include "ash/wm/window_state.h"
13 #include "base/metrics/histogram.h"
14 #include "base/metrics/user_metrics.h"
15 #include "ui/aura/window.h"
21 // Time in seconds between calls to "RecordPeriodicMetrics".
22 const int kAshPeriodicMetricsTimeInSeconds
= 30 * 60;
24 enum ActiveWindowStateType
{
25 ACTIVE_WINDOW_STATE_TYPE_NO_ACTIVE_WINDOW
,
26 ACTIVE_WINDOW_STATE_TYPE_OTHER
,
27 ACTIVE_WINDOW_STATE_TYPE_MAXIMIZED
,
28 ACTIVE_WINDOW_STATE_TYPE_FULLSCREEN
,
29 ACTIVE_WINDOW_STATE_TYPE_SNAPPED
,
30 ACTIVE_WINDOW_STATE_TYPE_DOCKED
,
31 ACTIVE_WINDOW_STATE_TYPE_COUNT
34 ActiveWindowStateType
GetActiveWindowState() {
35 ActiveWindowStateType active_window_state_type
=
36 ACTIVE_WINDOW_STATE_TYPE_NO_ACTIVE_WINDOW
;
37 wm::WindowState
* active_window_state
= ash::wm::GetActiveWindowState();
38 if (active_window_state
) {
39 switch (active_window_state
->GetStateType()) {
40 case wm::WINDOW_STATE_TYPE_MAXIMIZED
:
41 active_window_state_type
= ACTIVE_WINDOW_STATE_TYPE_MAXIMIZED
;
43 case wm::WINDOW_STATE_TYPE_FULLSCREEN
:
44 active_window_state_type
= ACTIVE_WINDOW_STATE_TYPE_FULLSCREEN
;
46 case wm::WINDOW_STATE_TYPE_LEFT_SNAPPED
:
47 case wm::WINDOW_STATE_TYPE_RIGHT_SNAPPED
:
48 active_window_state_type
= ACTIVE_WINDOW_STATE_TYPE_SNAPPED
;
50 case wm::WINDOW_STATE_TYPE_DOCKED
:
51 case wm::WINDOW_STATE_TYPE_DOCKED_MINIMIZED
:
52 active_window_state_type
= ACTIVE_WINDOW_STATE_TYPE_DOCKED
;
54 case wm::WINDOW_STATE_TYPE_DEFAULT
:
55 case wm::WINDOW_STATE_TYPE_NORMAL
:
56 case wm::WINDOW_STATE_TYPE_MINIMIZED
:
57 case wm::WINDOW_STATE_TYPE_INACTIVE
:
58 case wm::WINDOW_STATE_TYPE_END
:
59 case wm::WINDOW_STATE_TYPE_AUTO_POSITIONED
:
60 active_window_state_type
= ACTIVE_WINDOW_STATE_TYPE_OTHER
;
64 return active_window_state_type
;
67 // Array of window container ids that contain visible windows to be counted for
68 // UMA statistics. Note the containers are ordered from top most visible
69 // container to the lowest to allow the |GetNumVisibleWindows| method to short
70 // circuit when processing a maximized or fullscreen window.
71 int kVisibleWindowContainerIds
[] = {kShellWindowId_PanelContainer
,
72 kShellWindowId_DockedContainer
,
73 kShellWindowId_AlwaysOnTopContainer
,
74 kShellWindowId_DefaultContainer
};
76 // Returns an approximate count of how many windows are currently visible in the
77 // primary root window.
78 int GetNumVisibleWindowsInPrimaryDisplay() {
79 int visible_window_count
= 0;
80 bool maximized_or_fullscreen_window_present
= false;
82 for (const int& current_container_id
: kVisibleWindowContainerIds
) {
83 if (maximized_or_fullscreen_window_present
)
86 const aura::Window::Windows
& children
=
87 Shell::GetContainer(Shell::GetInstance()->GetPrimaryRootWindow(),
88 current_container_id
)->children();
89 // Reverse iterate over the child windows so that they are processed in
90 // visible stacking order.
91 for (aura::Window::Windows::const_reverse_iterator it
= children
.rbegin(),
92 rend
= children
.rend();
94 const aura::Window
* child_window
= *it
;
95 const wm::WindowState
* child_window_state
=
96 wm::GetWindowState(child_window
);
98 if (!child_window
->IsVisible() || child_window_state
->IsMinimized())
101 // Only count activatable windows for 2 reasons:
102 // 1. Ensures that a browser window and its transient, modal child will
103 // only count as 1 visible window.
104 // 2. Prevents counting some windows in the
105 // kShellWindowId_DockedContainer that were not opened by the user.
106 if (child_window_state
->CanActivate())
107 ++visible_window_count
;
109 // Stop counting windows that will be hidden by maximized or fullscreen
110 // windows. Only windows in the kShellWindowId_DefaultContainer and
111 // kShellWindowId_AlwaysOnTopContainer can be maximized or fullscreened
112 // and completely obscure windows beneath them.
113 if ((kShellWindowId_DefaultContainer
== current_container_id
||
114 kShellWindowId_AlwaysOnTopContainer
== current_container_id
) &&
115 child_window_state
->IsMaximizedOrFullscreen()) {
116 maximized_or_fullscreen_window_present
= true;
121 return visible_window_count
;
126 UserMetricsRecorder::UserMetricsRecorder() {
127 timer_
.Start(FROM_HERE
,
128 base::TimeDelta::FromSeconds(kAshPeriodicMetricsTimeInSeconds
),
130 &UserMetricsRecorder::RecordPeriodicMetrics
);
133 UserMetricsRecorder::~UserMetricsRecorder() {
137 void UserMetricsRecorder::RecordUserMetricsAction(UserMetricsAction action
) {
139 case ash::UMA_ACCEL_KEYBOARD_BRIGHTNESS_DOWN_F6
:
141 base::UserMetricsAction("Accel_KeyboardBrightnessDown_F6"));
143 case ash::UMA_ACCEL_KEYBOARD_BRIGHTNESS_UP_F7
:
145 base::UserMetricsAction("Accel_KeyboardBrightnessUp_F7"));
147 case ash::UMA_ACCEL_LOCK_SCREEN_LOCK_BUTTON
:
149 base::UserMetricsAction("Accel_LockScreen_LockButton"));
151 case ash::UMA_ACCEL_LOCK_SCREEN_POWER_BUTTON
:
153 base::UserMetricsAction("Accel_LockScreen_PowerButton"));
155 case ash::UMA_ACCEL_MAXIMIZE_RESTORE_F4
:
157 base::UserMetricsAction("Accel_Maximize_Restore_F4"));
159 case ash::UMA_ACCEL_PREVWINDOW_F5
:
160 base::RecordAction(base::UserMetricsAction("Accel_PrevWindow_F5"));
162 case ash::UMA_ACCEL_EXIT_FIRST_Q
:
163 base::RecordAction(base::UserMetricsAction("Accel_Exit_First_Q"));
165 case ash::UMA_ACCEL_EXIT_SECOND_Q
:
166 base::RecordAction(base::UserMetricsAction("Accel_Exit_Second_Q"));
168 case ash::UMA_ACCEL_RESTART_POWER_BUTTON
:
170 base::UserMetricsAction("Accel_Restart_PowerButton"));
172 case ash::UMA_ACCEL_SHUT_DOWN_POWER_BUTTON
:
174 base::UserMetricsAction("Accel_ShutDown_PowerButton"));
176 case ash::UMA_CLOSE_THROUGH_CONTEXT_MENU
:
177 base::RecordAction(base::UserMetricsAction("CloseFromContextMenu"));
179 case ash::UMA_DRAG_MAXIMIZE_LEFT
:
180 base::RecordAction(base::UserMetricsAction("WindowDrag_MaximizeLeft"));
182 case ash::UMA_DRAG_MAXIMIZE_RIGHT
:
183 base::RecordAction(base::UserMetricsAction("WindowDrag_MaximizeRight"));
185 case ash::UMA_GESTURE_OVERVIEW
:
186 base::RecordAction(base::UserMetricsAction("Gesture_Overview"));
188 case ash::UMA_LAUNCHER_BUTTON_PRESSED_WITH_MOUSE
:
190 base::UserMetricsAction("Launcher_ButtonPressed_Mouse"));
192 case ash::UMA_LAUNCHER_BUTTON_PRESSED_WITH_TOUCH
:
194 base::UserMetricsAction("Launcher_ButtonPressed_Touch"));
196 case ash::UMA_LAUNCHER_CLICK_ON_APP
:
197 base::RecordAction(base::UserMetricsAction("Launcher_ClickOnApp"));
199 case ash::UMA_LAUNCHER_CLICK_ON_APPLIST_BUTTON
:
201 base::UserMetricsAction("Launcher_ClickOnApplistButton"));
203 case ash::UMA_LAUNCHER_LAUNCH_TASK
:
204 base::RecordAction(base::UserMetricsAction("Launcher_LaunchTask"));
206 case ash::UMA_LAUNCHER_SWITCH_TASK
:
207 base::RecordAction(base::UserMetricsAction("Launcher_SwitchTask"));
209 case UMA_MAXIMIZE_MODE_DISABLED
:
210 base::RecordAction(base::UserMetricsAction("Touchview_Disabled"));
212 case UMA_MAXIMIZE_MODE_ENABLED
:
213 base::RecordAction(base::UserMetricsAction("Touchview_Enabled"));
215 case UMA_MAXIMIZE_MODE_INITIALLY_DISABLED
:
217 base::UserMetricsAction("Touchview_Initially_Disabled"));
219 case ash::UMA_MOUSE_DOWN
:
220 base::RecordAction(base::UserMetricsAction("Mouse_Down"));
222 case ash::UMA_PANEL_MINIMIZE_CAPTION_CLICK
:
224 base::UserMetricsAction("Panel_Minimize_Caption_Click"));
226 case ash::UMA_PANEL_MINIMIZE_CAPTION_GESTURE
:
228 base::UserMetricsAction("Panel_Minimize_Caption_Gesture"));
230 case ash::UMA_SHELF_ALIGNMENT_SET_BOTTOM
:
232 base::UserMetricsAction("Shelf_AlignmentSetBottom"));
234 case ash::UMA_SHELF_ALIGNMENT_SET_LEFT
:
236 base::UserMetricsAction("Shelf_AlignmentSetLeft"));
238 case ash::UMA_SHELF_ALIGNMENT_SET_RIGHT
:
240 base::UserMetricsAction("Shelf_AlignmentSetRight"));
242 case ash::UMA_STATUS_AREA_AUDIO_CURRENT_INPUT_DEVICE
:
244 base::UserMetricsAction("StatusArea_Audio_CurrentInputDevice"));
246 case ash::UMA_STATUS_AREA_AUDIO_CURRENT_OUTPUT_DEVICE
:
248 base::UserMetricsAction("StatusArea_Audio_CurrentOutputDevice"));
250 case ash::UMA_STATUS_AREA_AUDIO_SWITCH_INPUT_DEVICE
:
252 base::UserMetricsAction("StatusArea_Audio_SwitchInputDevice"));
254 case ash::UMA_STATUS_AREA_AUDIO_SWITCH_OUTPUT_DEVICE
:
256 base::UserMetricsAction("StatusArea_Audio_SwitchOutputDevice"));
258 case ash::UMA_STATUS_AREA_BRIGHTNESS_CHANGED
:
260 base::UserMetricsAction("StatusArea_BrightnessChanged"));
262 case ash::UMA_STATUS_AREA_BLUETOOTH_CONNECT_KNOWN_DEVICE
:
264 base::UserMetricsAction("StatusArea_Bluetooth_Connect_Known"));
266 case ash::UMA_STATUS_AREA_BLUETOOTH_CONNECT_UNKNOWN_DEVICE
:
268 base::UserMetricsAction("StatusArea_Bluetooth_Connect_Unknown"));
270 case ash::UMA_STATUS_AREA_BLUETOOTH_DISABLED
:
272 base::UserMetricsAction("StatusArea_Bluetooth_Disabled"));
274 case ash::UMA_STATUS_AREA_BLUETOOTH_ENABLED
:
276 base::UserMetricsAction("StatusArea_Bluetooth_Enabled"));
278 case ash::UMA_STATUS_AREA_CAPS_LOCK_DETAILED
:
280 base::UserMetricsAction("StatusArea_CapsLock_Detailed"));
282 case ash::UMA_STATUS_AREA_CAPS_LOCK_DISABLED_BY_CLICK
:
284 base::UserMetricsAction("StatusArea_CapsLock_DisabledByClick"));
286 case ash::UMA_STATUS_AREA_CAPS_LOCK_ENABLED_BY_CLICK
:
288 base::UserMetricsAction("StatusArea_CapsLock_EnabledByClick"));
290 case ash::UMA_STATUS_AREA_CAPS_LOCK_POPUP
:
292 base::UserMetricsAction("StatusArea_CapsLock_Popup"));
294 case ash::UMA_STATUS_AREA_CONNECT_TO_CONFIGURED_NETWORK
:
296 base::UserMetricsAction("StatusArea_Network_ConnectConfigured"));
298 case ash::UMA_STATUS_AREA_CONNECT_TO_UNCONFIGURED_NETWORK
:
300 base::UserMetricsAction("StatusArea_Network_ConnectUnconfigured"));
302 case ash::UMA_STATUS_AREA_CONNECT_TO_VPN
:
304 base::UserMetricsAction("StatusArea_VPN_ConnectToNetwork"));
306 case ash::UMA_STATUS_AREA_CHANGED_VOLUME_MENU
:
308 base::UserMetricsAction("StatusArea_Volume_ChangedMenu"));
310 case ash::UMA_STATUS_AREA_CHANGED_VOLUME_POPUP
:
312 base::UserMetricsAction("StatusArea_Volume_ChangedPopup"));
314 case ash::UMA_STATUS_AREA_DETAILED_ACCESSABILITY
:
316 base::UserMetricsAction("StatusArea_Accessability_DetailedView"));
318 case ash::UMA_STATUS_AREA_DETAILED_AUDIO_VIEW
:
320 base::UserMetricsAction("StatusArea_Audio_Detailed"));
322 case ash::UMA_STATUS_AREA_DETAILED_BLUETOOTH_VIEW
:
324 base::UserMetricsAction("StatusArea_Bluetooth_Detailed"));
326 case ash::UMA_STATUS_AREA_DETAILED_BRIGHTNESS_VIEW
:
328 base::UserMetricsAction("StatusArea_Brightness_Detailed"));
330 case ash::UMA_STATUS_AREA_DETAILED_DRIVE_VIEW
:
332 base::UserMetricsAction("StatusArea_Drive_Detailed"));
334 case ash::UMA_STATUS_AREA_DETAILED_NETWORK_VIEW
:
336 base::UserMetricsAction("StatusArea_Network_Detailed"));
338 case ash::UMA_STATUS_AREA_DETAILED_VPN_VIEW
:
340 base::UserMetricsAction("StatusArea_VPN_Detailed"));
342 case ash::UMA_STATUS_AREA_DISABLE_AUTO_CLICK
:
344 base::UserMetricsAction("StatusArea_AutoClickDisabled"));
346 case ash::UMA_STATUS_AREA_DISABLE_HIGH_CONTRAST
:
348 base::UserMetricsAction("StatusArea_HighContrastDisabled"));
350 case ash::UMA_STATUS_AREA_DISABLE_LARGE_CURSOR
:
352 base::UserMetricsAction("StatusArea_LargeCursorDisabled"));
354 case ash::UMA_STATUS_AREA_DISABLE_MAGNIFIER
:
356 base::UserMetricsAction("StatusArea_MagnifierDisabled"));
358 case ash::UMA_STATUS_AREA_DISABLE_SPOKEN_FEEDBACK
:
360 base::UserMetricsAction("StatusArea_SpokenFeedbackDisabled"));
362 case ash::UMA_STATUS_AREA_DISABLE_VIRTUAL_KEYBOARD
:
364 base::UserMetricsAction("StatusArea_VirtualKeyboardDisabled"));
366 case ash::UMA_STATUS_AREA_DISABLE_WIFI
:
368 base::UserMetricsAction("StatusArea_Network_WifiDisabled"));
370 case ash::UMA_STATUS_AREA_DRIVE_CANCEL_OPERATION
:
372 base::UserMetricsAction("StatusArea_Drive_CancelOperation"));
374 case ash::UMA_STATUS_AREA_DRIVE_SETTINGS
:
376 base::UserMetricsAction("StatusArea_Drive_Settings"));
378 case ash::UMA_STATUS_AREA_ENABLE_AUTO_CLICK
:
380 base::UserMetricsAction("StatusArea_AutoClickEnabled"));
382 case ash::UMA_STATUS_AREA_ENABLE_HIGH_CONTRAST
:
384 base::UserMetricsAction("StatusArea_HighContrastEnabled"));
386 case ash::UMA_STATUS_AREA_ENABLE_LARGE_CURSOR
:
388 base::UserMetricsAction("StatusArea_LargeCursorEnabled"));
390 case ash::UMA_STATUS_AREA_ENABLE_MAGNIFIER
:
392 base::UserMetricsAction("StatusArea_MagnifierEnabled"));
394 case ash::UMA_STATUS_AREA_ENABLE_SPOKEN_FEEDBACK
:
396 base::UserMetricsAction("StatusArea_SpokenFeedbackEnabled"));
398 case ash::UMA_STATUS_AREA_ENABLE_VIRTUAL_KEYBOARD
:
400 base::UserMetricsAction("StatusArea_VirtualKeyboardEnabled"));
402 case ash::UMA_STATUS_AREA_ENABLE_WIFI
:
404 base::UserMetricsAction("StatusArea_Network_WifiEnabled"));
406 case ash::UMA_STATUS_AREA_IME_SHOW_DETAILED
:
408 base::UserMetricsAction("StatusArea_IME_Detailed"));
410 case ash::UMA_STATUS_AREA_IME_SWITCH_MODE
:
412 base::UserMetricsAction("StatusArea_IME_SwitchMode"));
414 case ash::UMA_STATUS_AREA_MENU_OPENED
:
416 base::UserMetricsAction("StatusArea_MenuOpened"));
418 case ash::UMA_STATUS_AREA_NETWORK_JOIN_OTHER_CLICKED
:
420 base::UserMetricsAction("StatusArea_Network_JoinOther"));
422 case ash::UMA_STATUS_AREA_NETWORK_SETTINGS_CLICKED
:
424 base::UserMetricsAction("StatusArea_Network_Settings"));
426 case ash::UMA_STATUS_AREA_SHOW_NETWORK_CONNECTION_DETAILS
:
428 base::UserMetricsAction("StatusArea_Network_ConnectionDetails"));
430 case ash::UMA_STATUS_AREA_SHOW_VPN_CONNECTION_DETAILS
:
432 base::UserMetricsAction("StatusArea_VPN_ConnectionDetails"));
434 case ash::UMA_STATUS_AREA_SIGN_OUT
:
436 base::UserMetricsAction("StatusArea_SignOut"));
438 case ash::UMA_STATUS_AREA_VPN_ADD_BUILT_IN_CLICKED
:
439 base::RecordAction(base::UserMetricsAction("StatusArea_VPN_AddBuiltIn"));
441 case ash::UMA_STATUS_AREA_VPN_ADD_THIRD_PARTY_CLICKED
:
443 base::UserMetricsAction("StatusArea_VPN_AddThirdParty"));
445 case ash::UMA_STATUS_AREA_VPN_DISCONNECT_CLICKED
:
446 base::RecordAction(base::UserMetricsAction("StatusArea_VPN_Disconnect"));
448 case ash::UMA_STATUS_AREA_VPN_SETTINGS_CLICKED
:
450 base::UserMetricsAction("StatusArea_VPN_Settings"));
452 case ash::UMA_TOGGLE_MAXIMIZE_CAPTION_CLICK
:
454 base::UserMetricsAction("Caption_ClickTogglesMaximize"));
456 case ash::UMA_TOGGLE_MAXIMIZE_CAPTION_GESTURE
:
458 base::UserMetricsAction("Caption_GestureTogglesMaximize"));
460 case ash::UMA_TOGGLE_SINGLE_AXIS_MAXIMIZE_BORDER_CLICK
:
462 base::UserMetricsAction(
463 "WindowBorder_ClickTogglesSingleAxisMaximize"));
465 case ash::UMA_TOUCHPAD_GESTURE_OVERVIEW
:
467 base::UserMetricsAction("Touchpad_Gesture_Overview"));
469 case ash::UMA_TOUCHSCREEN_TAP_DOWN
:
470 base::RecordAction(base::UserMetricsAction("Touchscreen_Down"));
472 case ash::UMA_TRAY_HELP
:
473 base::RecordAction(base::UserMetricsAction("Tray_Help"));
475 case ash::UMA_TRAY_LOCK_SCREEN
:
476 base::RecordAction(base::UserMetricsAction("Tray_LockScreen"));
478 case ash::UMA_TRAY_SHUT_DOWN
:
479 base::RecordAction(base::UserMetricsAction("Tray_ShutDown"));
481 case ash::UMA_WINDOW_APP_CLOSE_BUTTON_CLICK
:
482 base::RecordAction(base::UserMetricsAction("AppCloseButton_Clk"));
484 case ash::UMA_WINDOW_CLOSE_BUTTON_CLICK
:
485 base::RecordAction(base::UserMetricsAction("CloseButton_Clk"));
487 case ash::UMA_WINDOW_MAXIMIZE_BUTTON_CLICK_EXIT_FULLSCREEN
:
488 base::RecordAction(base::UserMetricsAction("MaxButton_Clk_ExitFS"));
490 case ash::UMA_WINDOW_MAXIMIZE_BUTTON_CLICK_RESTORE
:
492 base::UserMetricsAction("MaxButton_Clk_Restore"));
494 case ash::UMA_WINDOW_MAXIMIZE_BUTTON_CLICK_MAXIMIZE
:
496 base::UserMetricsAction("MaxButton_Clk_Maximize"));
498 case ash::UMA_WINDOW_MAXIMIZE_BUTTON_CLICK_MINIMIZE
:
499 base::RecordAction(base::UserMetricsAction("MinButton_Clk"));
501 case ash::UMA_WINDOW_MAXIMIZE_BUTTON_MAXIMIZE_LEFT
:
502 base::RecordAction(base::UserMetricsAction("MaxButton_MaxLeft"));
504 case ash::UMA_WINDOW_MAXIMIZE_BUTTON_MAXIMIZE_RIGHT
:
505 base::RecordAction(base::UserMetricsAction("MaxButton_MaxRight"));
507 case ash::UMA_WINDOW_OVERVIEW
:
509 base::UserMetricsAction("WindowSelector_Overview"));
511 case ash::UMA_WINDOW_OVERVIEW_ENTER_KEY
:
513 base::UserMetricsAction("WindowSelector_OverviewEnterKey"));
515 case ash::UMA_WINDOW_CYCLE
:
517 base::UserMetricsAction("WindowCycleController_Cycle"));
522 void UserMetricsRecorder::RecordPeriodicMetrics() {
523 ShelfLayoutManager
* manager
=
524 ShelfLayoutManager::ForShelf(Shell::GetPrimaryRootWindow());
526 UMA_HISTOGRAM_ENUMERATION("Ash.ShelfAlignmentOverTime",
527 manager
->SelectValueForShelfAlignment(
528 SHELF_ALIGNMENT_UMA_ENUM_VALUE_BOTTOM
,
529 SHELF_ALIGNMENT_UMA_ENUM_VALUE_LEFT
,
530 SHELF_ALIGNMENT_UMA_ENUM_VALUE_RIGHT
,
532 SHELF_ALIGNMENT_UMA_ENUM_VALUE_COUNT
);
535 UMA_HISTOGRAM_COUNTS_100("Ash.NumberOfVisibleWindowsInPrimaryDisplay",
536 GetNumVisibleWindowsInPrimaryDisplay());
538 UMA_HISTOGRAM_ENUMERATION("Ash.ActiveWindowShowTypeOverTime",
539 GetActiveWindowState(),
540 ACTIVE_WINDOW_STATE_TYPE_COUNT
);