Set up the infrastructure for Extension event metrics.

extensions/browser/extension_event_histogram_value.h

Index: extensions/browser/extension_event_histogram_value.h
diff --git a/extensions/browser/extension_event_histogram_value.h b/extensions/browser/extension_event_histogram_value.h
new file mode 100644
index 0000000000000000000000000000000000000000..13b9cb389ee95fb709cc295a84c271f2c88d7635
--- /dev/null
+++ b/extensions/browser/extension_event_histogram_value.h
@@ -0,0 +1,249 @@
+// Copyright 2015 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.
+
+#ifndef EXTENSIONS_BROWSER_EXTENSION_EVENT_HISTOGRAM_VALUE_H_
+#define EXTENSIONS_BROWSER_EXTENSION_EVENT_HISTOGRAM_VALUE_H_
+
+namespace extensions {
+namespace events {
+
+// TODO(kalman): I am still in the process of migrating Event construction away

[not at google - send to devlin, 2015/06/22 23:42:11]

And here.

+// from using "UNKNOWN" to their real histogram values. See crbug.com/503402.
+//
+// Short version:
+//  *Never* reorder or delete entries in the |HistogramValue| enumeration.
+//  When creating a new extension event, add a new entry at the end of the
+//  enum, just prior to ENUM_BOUNDARY.
+//
+// Long version: See extension_function_histogram_value.h
+enum HistogramValue {
+  UNKNOWN = 0,
+  ACTIVITY_LOG_PRIVATE_ON_EXTENSION_ACTIVITY,

[not at google - send to devlin, 2015/06/22 23:42:11]

I scraped this using the Docserver, and then realised I left out internal APIs.
People are adding APIs even now, so either way it's quickly going to get out of
sync.

For now that's ok because these aren't actually recorded anywhere, but before
submitting I'll regenerate this list. Then later on, when I turn on metrics,
I'll generate it again.

+  ALARMS_ON_ALARM,
+  APP_RUNTIME_ON_EMBED_REQUESTED,
+  APP_RUNTIME_ON_LAUNCHED,
+  APP_RUNTIME_ON_RESTARTED,
+  APP_WINDOW_ON_BOUNDS_CHANGED,
+  APP_WINDOW_ON_CLOSED,
+  APP_WINDOW_ON_FULLSCREENED,
+  APP_WINDOW_ON_MAXIMIZED,
+  APP_WINDOW_ON_MINIMIZED,
+  APP_WINDOW_ON_RESTORED,
+  AUDIO_ON_DEVICE_CHANGED,
+  AUDIO_ON_DEVICES_CHANGED,
+  AUDIO_ON_LEVEL_CHANGED,
+  AUDIO_ON_MUTE_CHANGED,
+  BLUETOOTH_LOW_ENERGY_ON_CHARACTERISTIC_VALUE_CHANGED,
+  BLUETOOTH_LOW_ENERGY_ON_DESCRIPTOR_VALUE_CHANGED,
+  BLUETOOTH_LOW_ENERGY_ON_SERVICE_ADDED,
+  BLUETOOTH_LOW_ENERGY_ON_SERVICE_CHANGED,
+  BLUETOOTH_LOW_ENERGY_ON_SERVICE_REMOVED,
+  BLUETOOTH_ON_ADAPTER_STATE_CHANGED,
+  BLUETOOTH_ON_DEVICE_ADDED,
+  BLUETOOTH_ON_DEVICE_CHANGED,
+  BLUETOOTH_ON_DEVICE_REMOVED,
+  BLUETOOTH_SOCKET_ON_ACCEPT,
+  BLUETOOTH_SOCKET_ON_ACCEPT_ERROR,
+  BLUETOOTH_SOCKET_ON_RECEIVE,
+  BLUETOOTH_SOCKET_ON_RECEIVE_ERROR,
+  BOOKMARKS_ON_CHANGED,
+  BOOKMARKS_ON_CHILDREN_REORDERED,
+  BOOKMARKS_ON_CREATED,
+  BOOKMARKS_ON_IMPORT_BEGAN,
+  BOOKMARKS_ON_IMPORT_ENDED,
+  BOOKMARKS_ON_MOVED,
+  BOOKMARKS_ON_REMOVED,
+  BRAILLE_DISPLAY_PRIVATE_ON_DISPLAY_STATE_CHANGED,
+  BRAILLE_DISPLAY_PRIVATE_ON_KEY_EVENT,
+  BROWSER_ACTION_ON_CLICKED,
+  COMMANDS_ON_COMMAND,
+  CONTEXT_MENUS_ON_CLICKED,
+  COOKIES_ON_CHANGED,
+  COPRESENCE_ON_MESSAGES_RECEIVED,
+  COPRESENCE_ON_STATUS_UPDATED,
+  DEBUGGER_ON_DETACH,
+  DEBUGGER_ON_EVENT,
+  DECLARATIVE_CONTENT_ON_PAGE_CHANGED,
+  DECLARATIVE_WEB_REQUEST_ON_MESSAGE,
+  DECLARATIVE_WEB_REQUEST_ON_REQUEST,
+  DEVELOPER_PRIVATE_ON_ITEM_STATE_CHANGED,
+  DEVELOPER_PRIVATE_ON_PROFILE_STATE_CHANGED,
+  DEVTOOLS_INSPECTED_WINDOW_ON_RESOURCE_ADDED,
+  DEVTOOLS_INSPECTED_WINDOW_ON_RESOURCE_CONTENT_COMMITTED,
+  DEVTOOLS_NETWORK_ON_NAVIGATED,
+  DEVTOOLS_NETWORK_ON_REQUEST_FINISHED,
+  DOWNLOADS_ON_CHANGED,
+  DOWNLOADS_ON_CREATED,
+  DOWNLOADS_ON_DETERMINING_FILENAME,
+  DOWNLOADS_ON_ERASED,
+  EXPERIMENTAL_DEVTOOLS_CONSOLE_ON_MESSAGE_ADDED,
+  EXTENSION_ON_REQUEST,
+  EXTENSION_ON_REQUEST_EXTERNAL,
+  FEEDBACK_PRIVATE_ON_FEEDBACK_REQUESTED,
+  FILE_BROWSER_HANDLER_ON_EXECUTE,
+  FILE_SYSTEM_ON_VOLUME_LIST_CHANGED,
+  FILE_SYSTEM_PROVIDER_ON_ABORT_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_ADD_WATCHER_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_CLOSE_FILE_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_CONFIGURE_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_COPY_ENTRY_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_CREATE_DIRECTORY_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_CREATE_FILE_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_DELETE_ENTRY_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_GET_METADATA_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_MOUNT_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_MOVE_ENTRY_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_OPEN_FILE_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_READ_DIRECTORY_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_READ_FILE_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_REMOVE_WATCHER_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_TRUNCATE_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_UNMOUNT_REQUESTED,
+  FILE_SYSTEM_PROVIDER_ON_WRITE_FILE_REQUESTED,
+  FONT_SETTINGS_ON_DEFAULT_FIXED_FONT_SIZE_CHANGED,
+  FONT_SETTINGS_ON_DEFAULT_FONT_SIZE_CHANGED,
+  FONT_SETTINGS_ON_FONT_CHANGED,
+  FONT_SETTINGS_ON_MINIMUM_FONT_SIZE_CHANGED,
+  GCM_ON_MESSAGE,
+  GCM_ON_MESSAGES_DELETED,
+  GCM_ON_SEND_ERROR,
+  HANGOUTS_PRIVATE_ON_HANGOUT_REQUESTED,
+  HID_ON_DEVICE_ADDED,
+  HID_ON_DEVICE_REMOVED,
+  HISTORY_ON_VISITED,
+  HISTORY_ON_VISIT_REMOVED,
+  IDENTITY_ON_SIGN_IN_CHANGED,
+  IDLE_ON_STATE_CHANGED,
+  INPUT_IME_ON_ACTIVATE,
+  INPUT_IME_ON_BLUR,
+  INPUT_IME_ON_CANDIDATE_CLICKED,
+  INPUT_IME_ON_DEACTIVATED,
+  INPUT_IME_ON_FOCUS,
+  INPUT_IME_ON_INPUT_CONTEXT_UPDATE,
+  INPUT_IME_ON_KEY_EVENT,
+  INPUT_IME_ON_MENU_ITEM_ACTIVATED,
+  INPUT_IME_ON_RESET,
+  INPUT_IME_ON_SURROUNDING_TEXT_CHANGED,
+  INSTANCE_ID_ON_TOKEN_REFRESH,
+  LOCATION_ON_LOCATION_ERROR,
+  LOCATION_ON_LOCATION_UPDATE,
+  LOG_PRIVATE_ON_CAPTURED_EVENTS,
+  MANAGEMENT_ON_DISABLED,
+  MANAGEMENT_ON_ENABLED,
+  MANAGEMENT_ON_INSTALLED,
+  MANAGEMENT_ON_UNINSTALLED,
+  MDNS_ON_SERVICE_LIST,
+  MEDIA_GALLERIES_ON_GALLERY_CHANGED,
+  MEDIA_GALLERIES_ON_SCAN_PROGRESS,
+  NETWORKING_CONFIG_ON_CAPTIVE_PORTAL_DETECTED,
+  NETWORKING_PRIVATE_ON_DEVICE_STATE_LIST_CHANGED,
+  NETWORKING_PRIVATE_ON_NETWORK_LIST_CHANGED,
+  NETWORKING_PRIVATE_ON_NETWORKS_CHANGED,
+  NETWORKING_PRIVATE_ON_PORTAL_DETECTION_COMPLETED,
+  NOTIFICATIONS_ON_BUTTON_CLICKED,
+  NOTIFICATIONS_ON_CLICKED,
+  NOTIFICATIONS_ON_CLOSED,
+  NOTIFICATIONS_ON_PERMISSION_LEVEL_CHANGED,
+  NOTIFICATIONS_ON_SHOW_SETTINGS,
+  OMNIBOX_ON_INPUT_CANCELLED,
+  OMNIBOX_ON_INPUT_CHANGED,
+  OMNIBOX_ON_INPUT_ENTERED,
+  OMNIBOX_ON_INPUT_STARTED,
+  PAGE_ACTION_ON_CLICKED,
+  PERMISSIONS_ON_ADDED,
+  PERMISSIONS_ON_REMOVED,
+  PRINTER_PROVIDER_ON_GET_CAPABILITY_REQUESTED,
+  PRINTER_PROVIDER_ON_GET_PRINTERS_REQUESTED,
+  PRINTER_PROVIDER_ON_GET_USB_PRINTER_INFO_REQUESTED,
+  PRINTER_PROVIDER_ON_PRINT_REQUESTED,
+  PROCESSES_ON_CREATED,
+  PROCESSES_ON_EXITED,
+  PROCESSES_ON_UNRESPONSIVE,
+  PROCESSES_ON_UPDATED,
+  PROCESSES_ON_UPDATED_WITH_MEMORY,
+  PROXY_ON_PROXY_ERROR,
+  RUNTIME_ON_BROWSER_UPDATE_AVAILABLE,
+  RUNTIME_ON_CONNECT,
+  RUNTIME_ON_CONNECT_EXTERNAL,
+  RUNTIME_ON_INSTALLED,
+  RUNTIME_ON_MESSAGE,
+  RUNTIME_ON_MESSAGE_EXTERNAL,
+  RUNTIME_ON_RESTART_REQUIRED,
+  RUNTIME_ON_STARTUP,
+  RUNTIME_ON_SUSPEND,
+  RUNTIME_ON_SUSPEND_CANCELED,
+  RUNTIME_ON_UPDATE_AVAILABLE,
+  SERIAL_ON_RECEIVE,
+  SERIAL_ON_RECEIVE_ERROR,
+  SESSIONS_ON_CHANGED,
+  SIGNED_IN_DEVICES_ON_DEVICE_INFO_CHANGE,
+  SOCKETS_TCP_ON_RECEIVE,
+  SOCKETS_TCP_ON_RECEIVE_ERROR,
+  SOCKETS_TCP_SERVER_ON_ACCEPT,
+  SOCKETS_TCP_SERVER_ON_ACCEPT_ERROR,
+  SOCKETS_UDP_ON_RECEIVE,
+  SOCKETS_UDP_ON_RECEIVE_ERROR,
+  STORAGE_ON_CHANGED,
+  SYNC_FILE_SYSTEM_ON_FILE_STATUS_CHANGED,
+  SYNC_FILE_SYSTEM_ON_SERVICE_STATUS_CHANGED,
+  SYSTEM_DISPLAY_ON_DISPLAY_CHANGED,
+  SYSTEM_STORAGE_ON_ATTACHED,
+  SYSTEM_STORAGE_ON_DETACHED,
+  TAB_CAPTURE_ON_STATUS_CHANGED,
+  TABS_ON_ACTIVATED,
+  TABS_ON_ACTIVE_CHANGED,
+  TABS_ON_ATTACHED,
+  TABS_ON_CREATED,
+  TABS_ON_DETACHED,
+  TABS_ON_HIGHLIGHT_CHANGED,
+  TABS_ON_HIGHLIGHTED,
+  TABS_ON_MOVED,
+  TABS_ON_REMOVED,
+  TABS_ON_REPLACED,
+  TABS_ON_SELECTION_CHANGED,
+  TABS_ON_UPDATED,
+  TABS_ON_ZOOM_CHANGE,
+  TTS_ENGINE_ON_PAUSE,
+  TTS_ENGINE_ON_RESUME,
+  TTS_ENGINE_ON_SPEAK,
+  TTS_ENGINE_ON_STOP,
+  USB_ON_DEVICE_ADDED,
+  USB_ON_DEVICE_REMOVED,
+  VPN_PROVIDER_ON_CONFIG_CREATED,
+  VPN_PROVIDER_ON_CONFIG_REMOVED,
+  VPN_PROVIDER_ON_PACKET_RECEIVED,
+  VPN_PROVIDER_ON_PLATFORM_MESSAGE,
+  VPN_PROVIDER_ON_UIEVENT,
+  WEB_NAVIGATION_ON_BEFORE_NAVIGATE,
+  WEB_NAVIGATION_ON_COMMITTED,
+  WEB_NAVIGATION_ON_COMPLETED,
+  WEB_NAVIGATION_ON_CREATED_NAVIGATION_TARGET,
+  WEB_NAVIGATION_ON_DOMCONTENT_LOADED,
+  WEB_NAVIGATION_ON_ERROR_OCCURRED,
+  WEB_NAVIGATION_ON_HISTORY_STATE_UPDATED,
+  WEB_NAVIGATION_ON_REFERENCE_FRAGMENT_UPDATED,
+  WEB_NAVIGATION_ON_TAB_REPLACED,
+  WEB_REQUEST_ON_AUTH_REQUIRED,
+  WEB_REQUEST_ON_BEFORE_REDIRECT,
+  WEB_REQUEST_ON_BEFORE_REQUEST,
+  WEB_REQUEST_ON_BEFORE_SEND_HEADERS,
+  WEB_REQUEST_ON_COMPLETED,
+  WEB_REQUEST_ON_ERROR_OCCURRED,
+  WEB_REQUEST_ON_HEADERS_RECEIVED,
+  WEB_REQUEST_ON_RESPONSE_STARTED,
+  WEB_REQUEST_ON_SEND_HEADERS,
+  WEBSTORE_ON_DOWNLOAD_PROGRESS,
+  WEBSTORE_ON_INSTALL_STAGE_CHANGED,
+  WINDOWS_ON_CREATED,
+  WINDOWS_ON_FOCUS_CHANGED,
+  WINDOWS_ON_REMOVED,
+  // Last entry: Add new entries above and ensure to update
+  // tools/metrics/histograms/histograms.xml.
+  ENUM_BOUNDARY
+};
+
+}  // namespace events
+}  // namespace extensions
+
+#endif  // EXTENSIONS_BROWSER_EXTENSION_EVENT_HISTOGRAM_VALUE_H_