1 // Copyright 2014 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 // Stores information about the user's brower and system configuration.
6 // The system configuration fields are recorded once per client session.
10 option optimize_for = LITE_RUNTIME;
15 message SystemProfileProto {
16 // The time when the client was compiled/linked, in seconds since the epoch.
17 optional int64 build_timestamp = 1;
19 // A version number string for the application.
20 // Most commonly this is the browser version number found in a user agent
21 // string, and is typically a 4-tuple of numbers separated by periods. In
22 // cases where the user agent version might be ambiguous (example: Linux 64-
23 // bit build, rather than 32-bit build, or a Windows version used in some
24 // special context, such as ChromeFrame running in IE), then this may include
25 // some additional postfix to provide clarification not available in the UA
28 // An example of a browser version 4-tuple is "5.0.322.0". Currently used
31 // "-64": a 64-bit build
32 // "-F": Chrome is running under control of ChromeFrame
33 // "-devel": this is not an official build of Chrome
35 // A full version number string could look similar to:
36 // "5.0.322.0-F-devel".
38 // This value, when available, is more trustworthy than the UA string
39 // associated with the request; and including the postfix, may be more
41 optional string app_version = 2;
43 // The brand code or distribution tag assigned to a partner, if available.
44 // Brand codes are only available on Windows. Not every Windows install
45 // though will have a brand code.
46 optional string brand_code = 12;
48 // The possible channels for an installation, from least to most stable.
50 CHANNEL_UNKNOWN = 0; // Unknown channel -- perhaps an unofficial build?
56 optional Channel channel = 10;
58 // The date the user enabled UMA, in seconds since the epoch.
59 // If the user has toggled the UMA enabled state multiple times, this will
60 // be the most recent date on which UMA was enabled.
61 // For privacy, this is rounded to the nearest hour.
62 optional int64 uma_enabled_date = 3;
64 // The time when the client was installed, in seconds since the epoch.
65 // For privacy, this is rounded to the nearest hour.
66 optional int64 install_date = 16;
68 // The user's selected application locale, i.e. the user interface language.
69 // The locale includes a language code and, possibly, also a country code,
71 optional string application_locale = 4;
73 // Information on the user's operating system.
75 // The user's operating system.
76 optional string name = 1;
78 // The version of the OS. The meaning of this field is OS-dependent.
79 optional string version = 2;
81 // The fingerprint of the build. This field is used only on Android.
82 optional string fingerprint = 3;
86 // Next tag for Hardware: 16
87 // Information on the user's hardware.
89 // The CPU architecture (x86, PowerPC, x86_64, ...)
90 optional string cpu_architecture = 1;
92 // The amount of RAM present on the system, in megabytes.
93 optional int64 system_ram_mb = 2;
95 // The base memory address that chrome.dll was loaded at.
96 // (Logged only on Windows.)
97 optional int64 dll_base = 3;
99 // The Chrome OS device hardware class ID is a unique string associated with
100 // each Chrome OS device product revision generally assigned at hardware
101 // qualification time. The hardware class effectively identifies the
102 // configured system components such as CPU, WiFi adapter, etc.
104 // An example of such a hardware class is "IEC MARIO PONY 6101". An
105 // internal database associates this hardware class with the qualified
106 // device specifications including OEM information, schematics, hardware
107 // qualification reports, test device tags, etc.
108 optional string hardware_class = 4;
110 // The number of physical screens.
111 optional int32 screen_count = 5;
113 // The screen dimensions of the primary screen, in pixels.
114 optional int32 primary_screen_width = 6;
115 optional int32 primary_screen_height = 7;
117 // The device scale factor of the primary screen.
118 optional float primary_screen_scale_factor = 12;
120 // Max DPI for any attached screen. (Windows only)
121 optional float max_dpi_x = 9;
122 optional float max_dpi_y = 10;
124 // Information on the CPU obtained by CPUID.
126 // A 12 character string naming the vendor, e.g. "GeniuneIntel".
127 optional string vendor_name = 1;
129 // The signature reported by CPUID (from EAX).
130 optional uint32 signature = 2;
132 optional CPU cpu = 13;
134 // Information on the GPU
136 // The GPU manufacturer's vendor id.
137 optional uint32 vendor_id = 1;
139 // The GPU manufacturer's device id for the chip set.
140 optional uint32 device_id = 2;
142 // The driver version on the GPU.
143 optional string driver_version = 3;
145 // The driver date on the GPU.
146 optional string driver_date = 4;
148 // The GPU performance statistics.
149 // See http://src.chromium.org/viewvc/chrome/trunk/src/content/public/common/gpu_performance_stats.h?view=markup
150 // for details. Currently logged only on Windows.
151 message PerformanceStatistics {
152 optional float graphics_score = 1;
153 optional float gaming_score = 2;
154 optional float overall_score = 3;
156 optional PerformanceStatistics performance_statistics = 5;
158 // The GL_VENDOR string. An example of a gl_vendor string is
159 // "Imagination Technologies". "" if we are not using OpenGL.
160 optional string gl_vendor = 6;
162 // The GL_RENDERER string. An example of a gl_renderer string is
163 // "PowerVR SGX 540". "" if we are not using OpenGL.
164 optional string gl_renderer = 7;
166 optional Graphics gpu = 8;
168 // Information about Bluetooth devices paired with the system.
170 // Whether Bluetooth is present on this system.
171 optional bool is_present = 1;
173 // Whether Bluetooth is enabled on this system.
174 optional bool is_enabled = 2;
176 // Describes a paired device.
177 message PairedDevice {
178 // Assigned class of the device. This is a bitfield according to the
179 // Bluetooth specification available at the following URL:
180 // https://www.bluetooth.org/en-us/specification/assigned-numbers-overview/baseband
181 optional uint32 bluetooth_class = 1;
183 // Decoded device type.
190 DEVICE_CAR_AUDIO = 5;
192 DEVICE_PERIPHERAL = 7;
195 DEVICE_KEYBOARD = 10;
198 DEVICE_KEYBOARD_MOUSE_COMBO = 13;
200 optional Type type = 2;
202 // Vendor prefix of the Bluetooth address, these are OUI registered by
203 // the IEEE and are encoded with the first byte in bits 16-23, the
204 // second byte in bits 8-15 and the third byte in bits 0-7.
206 // ie. Google's OUI (00:1A:11) is encoded as 0x00001A11
207 optional uint32 vendor_prefix = 4;
209 // The Vendor ID of a device, returned in vendor_id below, can be
210 // either allocated by the Bluetooth SIG or USB IF, providing two
211 // completely overlapping namespaces for identifiers.
213 // This field should be read along with vendor_id to correctly
214 // identify the vendor. For example Google is identified by either
215 // vendor_id_source = VENDOR_ID_BLUETOOTH, vendor_id = 0x00E0 or
216 // vendor_id_source = VENDOR_ID_USB, vendor_id = 0x18D1.
218 // If the device does not support the Device ID specification the
219 // unknown value will be set.
220 enum VendorIDSource {
221 VENDOR_ID_UNKNOWN = 0;
222 VENDOR_ID_BLUETOOTH = 1;
225 optional VendorIDSource vendor_id_source = 8;
227 // Vendor ID of the device, where available.
228 optional uint32 vendor_id = 5;
230 // Product ID of the device, where available.
231 optional uint32 product_id = 6;
233 // Device ID of the device, generally the release or version number in
234 // BCD format, where available.
235 optional uint32 device_id = 7;
237 repeated PairedDevice paired_device = 3;
239 optional Bluetooth bluetooth = 11;
241 // Whether the internal display produces touch events. Omitted if unknown.
242 // Logged on ChromeOS only.
243 optional bool internal_display_supports_touch = 14;
245 // Vendor ids and product ids of external touchscreens.
246 message TouchScreen {
247 // Touch screen vendor id.
248 optional uint32 vendor_id = 1;
249 // Touch screen product id.
250 optional uint32 product_id = 2;
252 // Lists vendor and product ids of external touchscreens.
253 // Logged on ChromeOS only.
254 repeated TouchScreen external_touchscreen = 15;
256 optional Hardware hardware = 6;
258 // Information about the network connection.
260 // Set to true if connection_type changed during the lifetime of the log.
261 optional bool connection_type_is_ambiguous = 1;
263 // See net::NetworkChangeNotifier::ConnectionType.
264 enum ConnectionType {
265 CONNECTION_UNKNOWN = 0;
266 CONNECTION_ETHERNET = 1;
271 CONNECTION_BLUETOOTH = 6;
273 // The connection type according to NetworkChangeNotifier.
274 optional ConnectionType connection_type = 2;
276 // Set to true if wifi_phy_layer_protocol changed during the lifetime of the log.
277 optional bool wifi_phy_layer_protocol_is_ambiguous = 3;
279 // See net::WifiPHYLayerProtocol.
280 enum WifiPHYLayerProtocol {
281 WIFI_PHY_LAYER_PROTOCOL_NONE = 0;
282 WIFI_PHY_LAYER_PROTOCOL_ANCIENT = 1;
283 WIFI_PHY_LAYER_PROTOCOL_A = 2;
284 WIFI_PHY_LAYER_PROTOCOL_B = 3;
285 WIFI_PHY_LAYER_PROTOCOL_G = 4;
286 WIFI_PHY_LAYER_PROTOCOL_N = 5;
287 WIFI_PHY_LAYER_PROTOCOL_UNKNOWN = 6;
289 // The physical layer mode of the associated wifi access point, if any.
290 optional WifiPHYLayerProtocol wifi_phy_layer_protocol = 4;
292 // Describe wifi access point information.
293 message WifiAccessPoint {
294 // Vendor prefix of the access point's BSSID, these are OUIs
295 // (Organizationally Unique Identifiers) registered by
296 // the IEEE and are encoded with the first byte in bits 16-23, the
297 // second byte in bits 8-15 and the third byte in bits 0-7.
298 optional uint32 vendor_prefix = 1;
300 // Access point seurity mode definitions.
302 SECURITY_UNKNOWN = 0;
310 // The security mode of the access point.
311 optional SecurityMode security_mode = 2;
313 // Vendor specific information.
314 message VendorInformation {
315 // The model number, for example "0".
316 optional string model_number = 1;
318 // The model name (sometimes the same as the model_number),
319 // for example "WZR-HP-AG300H".
320 optional string model_name = 2;
322 // The device name (sometimes the same as the model_number),
323 // for example "Dummynet"
324 optional string device_name = 3;
326 // The list of vendor-specific OUIs (Organziationally Unqiue
327 // Identifiers). These are provided by the vendor through WPS
328 // (Wireless Provisioning Service) information elements, which
329 // identifies the content of the element.
330 repeated uint32 element_identifier = 4;
332 // The wireless access point vendor information.
333 optional VendorInformation vendor_info = 3;
335 // Information of the wireless AP that device is connected to.
336 optional WifiAccessPoint access_point_info = 5;
338 optional Network network = 13;
340 // Information on the Google Update install that is managing this client.
341 message GoogleUpdate {
342 // Whether the Google Update install is system-level or user-level.
343 optional bool is_system_install = 1;
345 // The date at which Google Update last started performing an automatic
346 // update check, in seconds since the Unix epoch.
347 optional int64 last_automatic_start_timestamp = 2;
349 // The date at which Google Update last successfully sent an update check
350 // and recieved an intact response from the server, in seconds since the
351 // Unix epoch. (The updates don't need to be successfully installed.)
352 optional int64 last_update_check_timestamp = 3;
354 // Describes a product being managed by Google Update. (This can also
355 // describe Google Update itself.)
356 message ProductInfo {
357 // The current version of the product that is installed.
358 optional string version = 1;
360 // The date at which Google Update successfully updated this product,
361 // stored in seconds since the Unix epoch. This is updated when an update
362 // is successfully applied, or if the server reports that no update
364 optional int64 last_update_success_timestamp = 2;
366 // The result reported by the product updater on its last run.
368 INSTALL_RESULT_SUCCESS = 0;
369 INSTALL_RESULT_FAILED_CUSTOM_ERROR = 1;
370 INSTALL_RESULT_FAILED_MSI_ERROR = 2;
371 INSTALL_RESULT_FAILED_SYSTEM_ERROR = 3;
372 INSTALL_RESULT_EXIT_CODE = 4;
374 optional InstallResult last_result = 3;
376 // The error code reported by the product updater on its last run. This
377 // will typically be a error code specific to the product installer.
378 optional int32 last_error = 4;
380 // The extra error code reported by the product updater on its last run.
381 // This will typically be a Win32 error code.
382 optional int32 last_extra_error = 5;
384 optional ProductInfo google_update_status = 4;
385 optional ProductInfo client_status = 5;
387 optional GoogleUpdate google_update = 11;
389 // Information on all installed plugins.
391 // The plugin's self-reported name and filename (without path).
392 optional string name = 1;
393 optional string filename = 2;
395 // The plugin's version.
396 optional string version = 3;
398 // True if the plugin is disabled.
399 // If a client has multiple local Chrome user accounts, this is logged based
400 // on the first user account launched during the current session.
401 optional bool is_disabled = 4;
403 // True if the plugin is PPAPI.
404 optional bool is_pepper = 5;
406 repeated Plugin plugin = 7;
408 // Figures that can be used to generate application stability metrics.
409 // All values are counts of events since the last time that these
410 // values were reported.
413 // Total amount of time that the program was running, in seconds,
414 // since the last time a log was recorded, as measured using a client-side
415 // clock implemented via TimeTicks, which guarantees that it is monotonic
416 // and does not jump if the user changes his/her clock. The TimeTicks
417 // implementation also makes the clock not count time the computer is
419 optional int64 incremental_uptime_sec = 1;
421 // Total amount of time that the program was running, in seconds,
422 // since startup, as measured using a client-side clock implemented
423 // via TimeTicks, which guarantees that it is monotonic and does not
424 // jump if the user changes his/her clock. The TimeTicks implementation
425 // also makes the clock not count time the computer is suspended.
426 // This field was added for M-35.
427 optional int64 uptime_sec = 23;
429 // Page loads along with renderer crashes and hangs, since page load count
430 // roughly corresponds to usage.
431 optional int32 page_load_count = 2;
432 optional int32 renderer_crash_count = 3;
433 optional int32 renderer_hang_count = 4;
435 // Number of renderer crashes that were for extensions.
436 // TODO(isherman): Figure out whether this is also counted in
437 // |renderer_crash_count|.
438 optional int32 extension_renderer_crash_count = 5;
440 // Number of non-renderer child process crashes.
441 optional int32 child_process_crash_count = 6;
443 // Number of times the browser has crashed while logged in as the "other
444 // user" (guest) account.
445 // Logged on ChromeOS only.
446 optional int32 other_user_crash_count = 7;
448 // Number of times the kernel has crashed.
449 // Logged on ChromeOS only.
450 optional int32 kernel_crash_count = 8;
452 // Number of times the system has shut down uncleanly.
453 // Logged on ChromeOS only.
454 optional int32 unclean_system_shutdown_count = 9;
457 // All the remaining fields in the Stability are recorded at most once per
461 // The number of times the program was launched.
462 // This will typically be equal to 1. However, it is possible that Chrome
463 // was unable to upload stability metrics for previous launches (e.g. due to
464 // crashing early during startup), and hence this value might be greater
466 optional int32 launch_count = 15;
467 // The number of times that it didn't exit cleanly (which we assume to be
469 optional int32 crash_count = 16;
471 // The number of times the program began, but did not complete, the shutdown
472 // process. (For example, this may occur when Windows is shutting down, and
473 // it only gives the process a few seconds to clean up.)
474 optional int32 incomplete_shutdown_count = 17;
476 // The number of times the program was able register with breakpad crash
478 optional int32 breakpad_registration_success_count = 18;
480 // The number of times the program failed to register with breakpad crash
481 // services. If crash registration fails then when the program crashes no
482 // crash report will be generated.
483 optional int32 breakpad_registration_failure_count = 19;
485 // The number of times the program has run under a debugger. This should
486 // be an exceptional condition. Running under a debugger prevents crash
487 // dumps from being generated.
488 optional int32 debugger_present_count = 20;
490 // The number of times the program has run without a debugger attached.
491 // This should be most common scenario and should be very close to
493 optional int32 debugger_not_present_count = 21;
495 // Stability information for all installed plugins.
496 message PluginStability {
497 // The relevant plugin's information (name, etc.)
498 optional Plugin plugin = 1;
500 // The number of times this plugin's process was launched.
501 optional int32 launch_count = 2;
503 // The number of times this plugin was instantiated on a web page.
504 // This will be >= |launch_count|.
505 // (A page load with multiple sections drawn by this plugin will
506 // increase this count multiple times.)
507 optional int32 instance_count = 3;
509 // The number of times this plugin process crashed.
510 // This value will be <= |launch_count|.
511 optional int32 crash_count = 4;
513 // The number of times this plugin could not be loaded.
514 optional int32 loading_error_count = 5;
516 repeated PluginStability plugin_stability = 22;
518 optional Stability stability = 8;
520 // Description of a field trial or experiment that the user is currently
522 // All metrics reported in this upload can potentially be influenced by the
525 // The name of the field trial, as a 32-bit identifier.
526 // Currently, the identifier is a hash of the field trial's name.
527 optional fixed32 name_id = 1;
529 // The user's group within the field trial, as a 32-bit identifier.
530 // Currently, the identifier is a hash of the group's name.
531 optional fixed32 group_id = 2;
533 repeated FieldTrial field_trial = 9;
535 // Information about the A/V output device(s) (typically just a TV).
536 // However, a configuration may have one or more intermediate A/V devices
537 // between the source device and the TV (e.g. an A/V receiver, video
539 message ExternalAudioVideoDevice {
540 // The manufacturer name (possibly encoded as a 3-letter code, e.g. "YMH"
542 optional string manufacturer_name = 1;
544 // The model name (e.g. "RX-V1900"). Some devices may report generic names
545 // like "receiver" or use the full manufacturer name (e.g "PHILIPS").
546 optional string model_name = 2;
548 // The product code (e.g. "0218").
549 optional string product_code = 3;
551 // The device types. A single device can have multiple types (e.g. a set-top
552 // box could be both a tuner and a player). The same type may even be
553 // repeated (e.g a device that reports two tuners).
555 AV_DEVICE_TYPE_UNKNOWN = 0;
556 AV_DEVICE_TYPE_TV = 1;
557 AV_DEVICE_TYPE_RECORDER = 2;
558 AV_DEVICE_TYPE_TUNER = 3;
559 AV_DEVICE_TYPE_PLAYER = 4;
560 AV_DEVICE_TYPE_AUDIO_SYSTEM = 5;
562 repeated AVDeviceType av_device_type = 4;
564 // The year of manufacture.
565 optional int32 manufacture_year = 5;
567 // The week of manufacture.
568 // Note: per the Wikipedia EDID article, numbering for this field may not
569 // be consistent between manufacturers.
570 optional int32 manufacture_week = 6;
572 // Max horizontal resolution in pixels.
573 optional int32 horizontal_resolution = 7;
575 // Max vertical resolution in pixels.
576 optional int32 vertical_resolution = 8;
578 // Audio capabilities of the device.
579 // Ref: http://en.wikipedia.org/wiki/Extended_display_identification_data
580 message AudioDescription {
583 AUDIO_FORMAT_UNKNOWN = 0;
584 AUDIO_FORMAT_LPCM = 1;
585 AUDIO_FORMAT_AC_3 = 2;
586 AUDIO_FORMAT_MPEG1 = 3;
587 AUDIO_FORMAT_MP3 = 4;
588 AUDIO_FORMAT_MPEG2 = 5;
589 AUDIO_FORMAT_AAC = 6;
590 AUDIO_FORMAT_DTS = 7;
591 AUDIO_FORMAT_ATRAC = 8;
592 AUDIO_FORMAT_ONE_BIT = 9;
593 AUDIO_FORMAT_DD_PLUS = 10;
594 AUDIO_FORMAT_DTS_HD = 11;
595 AUDIO_FORMAT_MLP_DOLBY_TRUEHD = 12;
596 AUDIO_FORMAT_DST_AUDIO = 13;
597 AUDIO_FORMAT_MICROSOFT_WMA_PRO = 14;
599 optional AudioFormat audio_format = 1;
601 // Number of channels (e.g. 1, 2, 8, etc.).
602 optional int32 num_channels = 2;
604 // Supported sample frequencies in Hz (e.g. 32000, 44100, etc.).
605 // Multiple frequencies may be specified.
606 repeated int32 sample_frequency_hz = 3;
608 // Maximum bit rate in bits/s.
609 optional int32 max_bit_rate_per_second = 4;
611 // Bit depth (e.g. 16, 20, 24, etc.).
612 optional int32 bit_depth = 5;
614 repeated AudioDescription audio_description = 9;
616 // The position in AV setup.
617 // A value of 0 means this device is the TV.
618 // A value of 1 means this device is directly connected to one of
620 // Values > 1 indicate there are 1 or more devices between this device
622 optional int32 position_in_setup = 10;
624 // Whether this device is in the path to the TV.
625 optional bool is_in_path_to_tv = 11;
627 // The CEC version the device supports.
628 // CEC stands for Consumer Electronics Control, a part of the HDMI
629 // specification. Not all HDMI devices support CEC.
630 // Only devices that support CEC will report a value here.
631 optional int32 cec_version = 12;
633 // This message reports CEC commands seen by a device.
634 // After each log is sent, this information is cleared and gathered again.
635 // By collecting CEC status information by opcode we can determine
636 // which CEC features can be supported.
638 // The CEC command opcode. CEC supports up to 256 opcodes.
639 // We add only one CECCommand message per unique opcode. Only opcodes
640 // seen by the device will be reported. The remainder of the message
641 // accumulates status for this opcode (and device).
642 optional int32 opcode = 1;
644 // The total number of commands received from the external device.
645 optional int32 num_received_direct = 2;
647 // The number of commands received from the external device as part of a
648 // broadcast message.
649 optional int32 num_received_broadcast = 3;
651 // The total number of commands sent to the external device.
652 optional int32 num_sent_direct = 4;
654 // The number of commands sent to the external device as part of a
655 // broadcast message.
656 optional int32 num_sent_broadcast = 5;
658 // The number of aborted commands for unknown reasons.
659 optional int32 num_aborted_unknown_reason = 6;
661 // The number of aborted commands because of an unrecognized opcode.
662 optional int32 num_aborted_unrecognized = 7;
664 repeated CECCommand cec_command = 13;
666 repeated ExternalAudioVideoDevice external_audio_video_device = 14;
668 // Information about the current wireless access point. Collected directly
669 // from the wireless access point via standard apis if the device is
670 // connected to the Internet wirelessly. Introduced for Chrome on TV devices
671 // but also can be collected by ChromeOS, Android or other clients.
672 message ExternalAccessPoint {
673 // The manufacturer name, for example "ASUSTeK Computer Inc.".
674 optional string manufacturer = 1;
676 // The model name, for example "Wi-Fi Protected Setup Router".
677 optional string model_name = 2;
679 // The model number, for example "RT-N16".
680 optional string model_number = 3;
682 // The device name (sometime same as model_number), for example "RT-N16".
683 optional string device_name = 4;
685 optional ExternalAccessPoint external_access_point = 15;
687 // Number of users currently signed into a multiprofile session.
688 // A zero value indicates that the user count changed while the log is open.
689 // Logged only on ChromeOS.
690 optional uint32 multi_profile_user_count = 17;
692 // Information about extensions that are installed, masked to provide better
693 // privacy. Only extensions from a single profile are reported; this will
694 // generally be the profile used when the browser is started. The profile
695 // reported on will remain consistent at least until the browser is
696 // relaunched (or the profile is deleted by the user).
698 // Each client first picks a value for client_key derived from its UMA
700 // client_key = client_id % 4096
701 // Then, each installed extension is mapped into a hash bucket according to
702 // bucket = CityHash64(StringPrintf("%d:%s",
703 // client_key, extension_id)) % 1024
704 // The client reports the set of hash buckets occupied by all installed
705 // extensions. If multiple extensions map to the same bucket, that bucket is
706 // still only reported once.
707 repeated int32 occupied_extension_bucket = 18;
709 // The state of loaded extensions for this system. The system can have either
710 // no applicable extensions, extensions only from the webstore and verified by
711 // the webstore, extensions only from the webstore but not verified, or
712 // extensions not from the store. If there is a single off-store extension,
713 // then HAS_OFFSTORE is reported. This should be kept in sync with the
714 // corresponding enum in chrome/browser/metrics/extensions_metrics_provider.cc
715 enum ExtensionsState {
717 NO_OFFSTORE_VERIFIED = 1;
718 NO_OFFSTORE_UNVERIFIED = 2;
721 optional ExtensionsState offstore_extensions_state = 19;