| // Copyright 2014 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. |
| // |
| // Stores information about the user's brower and system configuration. |
| // The system configuration fields are recorded once per client session. |
| |
| syntax = "proto2"; |
| |
| option optimize_for = LITE_RUNTIME; |
| |
| package metrics; |
| |
| // Next tag: 19 |
| message SystemProfileProto { |
| // The time when the client was compiled/linked, in seconds since the epoch. |
| optional int64 build_timestamp = 1; |
| |
| // A version number string for the application. |
| // Most commonly this is the browser version number found in a user agent |
| // string, and is typically a 4-tuple of numbers separated by periods. In |
| // cases where the user agent version might be ambiguous (example: Linux 64- |
| // bit build, rather than 32-bit build, or a Windows version used in some |
| // special context, such as ChromeFrame running in IE), then this may include |
| // some additional postfix to provide clarification not available in the UA |
| // string. |
| // |
| // An example of a browser version 4-tuple is "5.0.322.0". Currently used |
| // postfixes are: |
| // |
| // "-64": a 64-bit build |
| // "-F": Chrome is running under control of ChromeFrame |
| // "-devel": this is not an official build of Chrome |
| // |
| // A full version number string could look similar to: |
| // "5.0.322.0-F-devel". |
| // |
| // This value, when available, is more trustworthy than the UA string |
| // associated with the request; and including the postfix, may be more |
| // specific. |
| optional string app_version = 2; |
| |
| // The brand code or distribution tag assigned to a partner, if available. |
| // Brand codes are only available on Windows. Not every Windows install |
| // though will have a brand code. |
| optional string brand_code = 12; |
| |
| // The possible channels for an installation, from least to most stable. |
| enum Channel { |
| CHANNEL_UNKNOWN = 0; // Unknown channel -- perhaps an unofficial build? |
| CHANNEL_CANARY = 1; |
| CHANNEL_DEV = 2; |
| CHANNEL_BETA = 3; |
| CHANNEL_STABLE = 4; |
| } |
| optional Channel channel = 10; |
| |
| // The date the user enabled UMA, in seconds since the epoch. |
| // If the user has toggled the UMA enabled state multiple times, this will |
| // be the most recent date on which UMA was enabled. |
| // For privacy, this is rounded to the nearest hour. |
| optional int64 uma_enabled_date = 3; |
| |
| // The time when the client was installed, in seconds since the epoch. |
| // For privacy, this is rounded to the nearest hour. |
| optional int64 install_date = 16; |
| |
| // The user's selected application locale, i.e. the user interface language. |
| // The locale includes a language code and, possibly, also a country code, |
| // e.g. "en-US". |
| optional string application_locale = 4; |
| |
| // Information on the user's operating system. |
| message OS { |
| // The user's operating system. |
| optional string name = 1; |
| |
| // The version of the OS. The meaning of this field is OS-dependent. |
| optional string version = 2; |
| |
| // The fingerprint of the build. This field is used only on Android. |
| optional string fingerprint = 3; |
| } |
| optional OS os = 5; |
| |
| // Next tag for Hardware: 16 |
| // Information on the user's hardware. |
| message Hardware { |
| // The CPU architecture (x86, PowerPC, x86_64, ...) |
| optional string cpu_architecture = 1; |
| |
| // The amount of RAM present on the system, in megabytes. |
| optional int64 system_ram_mb = 2; |
| |
| // The base memory address that chrome.dll was loaded at. |
| // (Logged only on Windows.) |
| optional int64 dll_base = 3; |
| |
| // The Chrome OS device hardware class ID is a unique string associated with |
| // each Chrome OS device product revision generally assigned at hardware |
| // qualification time. The hardware class effectively identifies the |
| // configured system components such as CPU, WiFi adapter, etc. |
| // |
| // An example of such a hardware class is "IEC MARIO PONY 6101". An |
| // internal database associates this hardware class with the qualified |
| // device specifications including OEM information, schematics, hardware |
| // qualification reports, test device tags, etc. |
| optional string hardware_class = 4; |
| |
| // The number of physical screens. |
| optional int32 screen_count = 5; |
| |
| // The screen dimensions of the primary screen, in pixels. |
| optional int32 primary_screen_width = 6; |
| optional int32 primary_screen_height = 7; |
| |
| // The device scale factor of the primary screen. |
| optional float primary_screen_scale_factor = 12; |
| |
| // Max DPI for any attached screen. (Windows only) |
| optional float max_dpi_x = 9; |
| optional float max_dpi_y = 10; |
| |
| // Information on the CPU obtained by CPUID. |
| message CPU { |
| // A 12 character string naming the vendor, e.g. "GeniuneIntel". |
| optional string vendor_name = 1; |
| |
| // The signature reported by CPUID (from EAX). |
| optional uint32 signature = 2; |
| } |
| optional CPU cpu = 13; |
| |
| // Information on the GPU |
| message Graphics { |
| // The GPU manufacturer's vendor id. |
| optional uint32 vendor_id = 1; |
| |
| // The GPU manufacturer's device id for the chip set. |
| optional uint32 device_id = 2; |
| |
| // The driver version on the GPU. |
| optional string driver_version = 3; |
| |
| // The driver date on the GPU. |
| optional string driver_date = 4; |
| |
| // The GPU performance statistics. |
| // See http://src.chromium.org/viewvc/chrome/trunk/src/content/public/common/gpu_performance_stats.h?view=markup |
| // for details. Currently logged only on Windows. |
| message PerformanceStatistics { |
| optional float graphics_score = 1; |
| optional float gaming_score = 2; |
| optional float overall_score = 3; |
| } |
| optional PerformanceStatistics performance_statistics = 5; |
| |
| // The GL_VENDOR string. An example of a gl_vendor string is |
| // "Imagination Technologies". "" if we are not using OpenGL. |
| optional string gl_vendor = 6; |
| |
| // The GL_RENDERER string. An example of a gl_renderer string is |
| // "PowerVR SGX 540". "" if we are not using OpenGL. |
| optional string gl_renderer = 7; |
| } |
| optional Graphics gpu = 8; |
| |
| // Information about Bluetooth devices paired with the system. |
| message Bluetooth { |
| // Whether Bluetooth is present on this system. |
| optional bool is_present = 1; |
| |
| // Whether Bluetooth is enabled on this system. |
| optional bool is_enabled = 2; |
| |
| // Describes a paired device. |
| message PairedDevice { |
| // Assigned class of the device. This is a bitfield according to the |
| // Bluetooth specification available at the following URL: |
| // https://www.bluetooth.org/en-us/specification/assigned-numbers-overview/baseband |
| optional uint32 bluetooth_class = 1; |
| |
| // Decoded device type. |
| enum Type { |
| DEVICE_UNKNOWN = 0; |
| DEVICE_COMPUTER = 1; |
| DEVICE_PHONE = 2; |
| DEVICE_MODEM = 3; |
| DEVICE_AUDIO = 4; |
| DEVICE_CAR_AUDIO = 5; |
| DEVICE_VIDEO = 6; |
| DEVICE_PERIPHERAL = 7; |
| DEVICE_JOYSTICK = 8; |
| DEVICE_GAMEPAD = 9; |
| DEVICE_KEYBOARD = 10; |
| DEVICE_MOUSE = 11; |
| DEVICE_TABLET = 12; |
| DEVICE_KEYBOARD_MOUSE_COMBO = 13; |
| } |
| optional Type type = 2; |
| |
| // Vendor prefix of the Bluetooth address, these are OUI registered by |
| // the IEEE and are encoded with the first byte in bits 16-23, the |
| // second byte in bits 8-15 and the third byte in bits 0-7. |
| // |
| // ie. Google's OUI (00:1A:11) is encoded as 0x00001A11 |
| optional uint32 vendor_prefix = 4; |
| |
| // The Vendor ID of a device, returned in vendor_id below, can be |
| // either allocated by the Bluetooth SIG or USB IF, providing two |
| // completely overlapping namespaces for identifiers. |
| // |
| // This field should be read along with vendor_id to correctly |
| // identify the vendor. For example Google is identified by either |
| // vendor_id_source = VENDOR_ID_BLUETOOTH, vendor_id = 0x00E0 or |
| // vendor_id_source = VENDOR_ID_USB, vendor_id = 0x18D1. |
| // |
| // If the device does not support the Device ID specification the |
| // unknown value will be set. |
| enum VendorIDSource { |
| VENDOR_ID_UNKNOWN = 0; |
| VENDOR_ID_BLUETOOTH = 1; |
| VENDOR_ID_USB = 2; |
| } |
| optional VendorIDSource vendor_id_source = 8; |
| |
| // Vendor ID of the device, where available. |
| optional uint32 vendor_id = 5; |
| |
| // Product ID of the device, where available. |
| optional uint32 product_id = 6; |
| |
| // Device ID of the device, generally the release or version number in |
| // BCD format, where available. |
| optional uint32 device_id = 7; |
| } |
| repeated PairedDevice paired_device = 3; |
| } |
| optional Bluetooth bluetooth = 11; |
| |
| // Whether the internal display produces touch events. Omitted if unknown. |
| // Logged on ChromeOS only. |
| optional bool internal_display_supports_touch = 14; |
| |
| // Vendor ids and product ids of external touchscreens. |
| message TouchScreen { |
| // Touch screen vendor id. |
| optional uint32 vendor_id = 1; |
| // Touch screen product id. |
| optional uint32 product_id = 2; |
| } |
| // Lists vendor and product ids of external touchscreens. |
| // Logged on ChromeOS only. |
| repeated TouchScreen external_touchscreen = 15; |
| } |
| optional Hardware hardware = 6; |
| |
| // Information about the network connection. |
| message Network { |
| // Set to true if connection_type changed during the lifetime of the log. |
| optional bool connection_type_is_ambiguous = 1; |
| |
| // See net::NetworkChangeNotifier::ConnectionType. |
| enum ConnectionType { |
| CONNECTION_UNKNOWN = 0; |
| CONNECTION_ETHERNET = 1; |
| CONNECTION_WIFI = 2; |
| CONNECTION_2G = 3; |
| CONNECTION_3G = 4; |
| CONNECTION_4G = 5; |
| CONNECTION_BLUETOOTH = 6; |
| } |
| // The connection type according to NetworkChangeNotifier. |
| optional ConnectionType connection_type = 2; |
| |
| // Set to true if wifi_phy_layer_protocol changed during the lifetime of the log. |
| optional bool wifi_phy_layer_protocol_is_ambiguous = 3; |
| |
| // See net::WifiPHYLayerProtocol. |
| enum WifiPHYLayerProtocol { |
| WIFI_PHY_LAYER_PROTOCOL_NONE = 0; |
| WIFI_PHY_LAYER_PROTOCOL_ANCIENT = 1; |
| WIFI_PHY_LAYER_PROTOCOL_A = 2; |
| WIFI_PHY_LAYER_PROTOCOL_B = 3; |
| WIFI_PHY_LAYER_PROTOCOL_G = 4; |
| WIFI_PHY_LAYER_PROTOCOL_N = 5; |
| WIFI_PHY_LAYER_PROTOCOL_UNKNOWN = 6; |
| } |
| // The physical layer mode of the associated wifi access point, if any. |
| optional WifiPHYLayerProtocol wifi_phy_layer_protocol = 4; |
| } |
| optional Network network = 13; |
| |
| // Information on the Google Update install that is managing this client. |
| message GoogleUpdate { |
| // Whether the Google Update install is system-level or user-level. |
| optional bool is_system_install = 1; |
| |
| // The date at which Google Update last started performing an automatic |
| // update check, in seconds since the Unix epoch. |
| optional int64 last_automatic_start_timestamp = 2; |
| |
| // The date at which Google Update last successfully sent an update check |
| // and recieved an intact response from the server, in seconds since the |
| // Unix epoch. (The updates don't need to be successfully installed.) |
| optional int64 last_update_check_timestamp = 3; |
| |
| // Describes a product being managed by Google Update. (This can also |
| // describe Google Update itself.) |
| message ProductInfo { |
| // The current version of the product that is installed. |
| optional string version = 1; |
| |
| // The date at which Google Update successfully updated this product, |
| // stored in seconds since the Unix epoch. This is updated when an update |
| // is successfully applied, or if the server reports that no update |
| // is available. |
| optional int64 last_update_success_timestamp = 2; |
| |
| // The result reported by the product updater on its last run. |
| enum InstallResult { |
| INSTALL_RESULT_SUCCESS = 0; |
| INSTALL_RESULT_FAILED_CUSTOM_ERROR = 1; |
| INSTALL_RESULT_FAILED_MSI_ERROR = 2; |
| INSTALL_RESULT_FAILED_SYSTEM_ERROR = 3; |
| INSTALL_RESULT_EXIT_CODE = 4; |
| } |
| optional InstallResult last_result = 3; |
| |
| // The error code reported by the product updater on its last run. This |
| // will typically be a error code specific to the product installer. |
| optional int32 last_error = 4; |
| |
| // The extra error code reported by the product updater on its last run. |
| // This will typically be a Win32 error code. |
| optional int32 last_extra_error = 5; |
| } |
| optional ProductInfo google_update_status = 4; |
| optional ProductInfo client_status = 5; |
| } |
| optional GoogleUpdate google_update = 11; |
| |
| // Information on all installed plugins. |
| message Plugin { |
| // The plugin's self-reported name and filename (without path). |
| optional string name = 1; |
| optional string filename = 2; |
| |
| // The plugin's version. |
| optional string version = 3; |
| |
| // True if the plugin is disabled. |
| // If a client has multiple local Chrome user accounts, this is logged based |
| // on the first user account launched during the current session. |
| optional bool is_disabled = 4; |
| |
| // True if the plugin is PPAPI. |
| optional bool is_pepper = 5; |
| } |
| repeated Plugin plugin = 7; |
| |
| // Figures that can be used to generate application stability metrics. |
| // All values are counts of events since the last time that these |
| // values were reported. |
| // Next tag: 24 |
| message Stability { |
| // Total amount of time that the program was running, in seconds, |
| // since the last time a log was recorded, as measured using a client-side |
| // clock implemented via TimeTicks, which guarantees that it is monotonic |
| // and does not jump if the user changes his/her clock. The TimeTicks |
| // implementation also makes the clock not count time the computer is |
| // suspended. |
| optional int64 incremental_uptime_sec = 1; |
| |
| // Total amount of time that the program was running, in seconds, |
| // since startup, as measured using a client-side clock implemented |
| // via TimeTicks, which guarantees that it is monotonic and does not |
| // jump if the user changes his/her clock. The TimeTicks implementation |
| // also makes the clock not count time the computer is suspended. |
| // This field was added for M-35. |
| optional int64 uptime_sec = 23; |
| |
| // Page loads along with renderer crashes and hangs, since page load count |
| // roughly corresponds to usage. |
| optional int32 page_load_count = 2; |
| optional int32 renderer_crash_count = 3; |
| optional int32 renderer_hang_count = 4; |
| |
| // Number of renderer crashes that were for extensions. |
| // TODO(isherman): Figure out whether this is also counted in |
| // |renderer_crash_count|. |
| optional int32 extension_renderer_crash_count = 5; |
| |
| // Number of non-renderer child process crashes. |
| optional int32 child_process_crash_count = 6; |
| |
| // Number of times the browser has crashed while logged in as the "other |
| // user" (guest) account. |
| // Logged on ChromeOS only. |
| optional int32 other_user_crash_count = 7; |
| |
| // Number of times the kernel has crashed. |
| // Logged on ChromeOS only. |
| optional int32 kernel_crash_count = 8; |
| |
| // Number of times the system has shut down uncleanly. |
| // Logged on ChromeOS only. |
| optional int32 unclean_system_shutdown_count = 9; |
| |
| // |
| // All the remaining fields in the Stability are recorded at most once per |
| // client session. |
| // |
| |
| // The number of times the program was launched. |
| // This will typically be equal to 1. However, it is possible that Chrome |
| // was unable to upload stability metrics for previous launches (e.g. due to |
| // crashing early during startup), and hence this value might be greater |
| // than 1. |
| optional int32 launch_count = 15; |
| // The number of times that it didn't exit cleanly (which we assume to be |
| // mostly crashes). |
| optional int32 crash_count = 16; |
| |
| // The number of times the program began, but did not complete, the shutdown |
| // process. (For example, this may occur when Windows is shutting down, and |
| // it only gives the process a few seconds to clean up.) |
| optional int32 incomplete_shutdown_count = 17; |
| |
| // The number of times the program was able register with breakpad crash |
| // services. |
| optional int32 breakpad_registration_success_count = 18; |
| |
| // The number of times the program failed to register with breakpad crash |
| // services. If crash registration fails then when the program crashes no |
| // crash report will be generated. |
| optional int32 breakpad_registration_failure_count = 19; |
| |
| // The number of times the program has run under a debugger. This should |
| // be an exceptional condition. Running under a debugger prevents crash |
| // dumps from being generated. |
| optional int32 debugger_present_count = 20; |
| |
| // The number of times the program has run without a debugger attached. |
| // This should be most common scenario and should be very close to |
| // |launch_count|. |
| optional int32 debugger_not_present_count = 21; |
| |
| // Stability information for all installed plugins. |
| message PluginStability { |
| // The relevant plugin's information (name, etc.) |
| optional Plugin plugin = 1; |
| |
| // The number of times this plugin's process was launched. |
| optional int32 launch_count = 2; |
| |
| // The number of times this plugin was instantiated on a web page. |
| // This will be >= |launch_count|. |
| // (A page load with multiple sections drawn by this plugin will |
| // increase this count multiple times.) |
| optional int32 instance_count = 3; |
| |
| // The number of times this plugin process crashed. |
| // This value will be <= |launch_count|. |
| optional int32 crash_count = 4; |
| |
| // The number of times this plugin could not be loaded. |
| optional int32 loading_error_count = 5; |
| } |
| repeated PluginStability plugin_stability = 22; |
| } |
| optional Stability stability = 8; |
| |
| // Description of a field trial or experiment that the user is currently |
| // enrolled in. |
| // All metrics reported in this upload can potentially be influenced by the |
| // field trial. |
| message FieldTrial { |
| // The name of the field trial, as a 32-bit identifier. |
| // Currently, the identifier is a hash of the field trial's name. |
| optional fixed32 name_id = 1; |
| |
| // The user's group within the field trial, as a 32-bit identifier. |
| // Currently, the identifier is a hash of the group's name. |
| optional fixed32 group_id = 2; |
| } |
| repeated FieldTrial field_trial = 9; |
| |
| // Number of users currently signed into a multiprofile session. |
| // A zero value indicates that the user count changed while the log is open. |
| // Logged only on ChromeOS. |
| optional uint32 multi_profile_user_count = 17; |
| |
| // Information about extensions that are installed, masked to provide better |
| // privacy. Only extensions from a single profile are reported; this will |
| // generally be the profile used when the browser is started. The profile |
| // reported on will remain consistent at least until the browser is |
| // relaunched (or the profile is deleted by the user). |
| // |
| // Each client first picks a value for client_key derived from its UMA |
| // client_id: |
| // client_key = client_id % 4096 |
| // Then, each installed extension is mapped into a hash bucket according to |
| // bucket = CityHash64(StringPrintf("%d:%s", |
| // client_key, extension_id)) % 1024 |
| // The client reports the set of hash buckets occupied by all installed |
| // extensions. If multiple extensions map to the same bucket, that bucket is |
| // still only reported once. |
| repeated int32 occupied_extension_bucket = 18; |
| } |