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;
272 // The connection type according to NetworkChangeNotifier.
273 optional ConnectionType connection_type = 2;
275 // Set to true if wifi_phy_layer_protocol changed during the lifetime of the log.
276 optional bool wifi_phy_layer_protocol_is_ambiguous = 3;
278 // See net::WifiPHYLayerProtocol.
279 enum WifiPHYLayerProtocol {
280 WIFI_PHY_LAYER_PROTOCOL_NONE = 0;
281 WIFI_PHY_LAYER_PROTOCOL_ANCIENT = 1;
282 WIFI_PHY_LAYER_PROTOCOL_A = 2;
283 WIFI_PHY_LAYER_PROTOCOL_B = 3;
284 WIFI_PHY_LAYER_PROTOCOL_G = 4;
285 WIFI_PHY_LAYER_PROTOCOL_N = 5;
286 WIFI_PHY_LAYER_PROTOCOL_UNKNOWN = 6;
288 // The physical layer mode of the associated wifi access point, if any.
289 optional WifiPHYLayerProtocol wifi_phy_layer_protocol = 4;
291 optional Network network = 13;
293 // Information on the Google Update install that is managing this client.
294 message GoogleUpdate {
295 // Whether the Google Update install is system-level or user-level.
296 optional bool is_system_install = 1;
298 // The date at which Google Update last started performing an automatic
299 // update check, in seconds since the Unix epoch.
300 optional int64 last_automatic_start_timestamp = 2;
302 // The date at which Google Update last successfully sent an update check
303 // and recieved an intact response from the server, in seconds since the
304 // Unix epoch. (The updates don't need to be successfully installed.)
305 optional int64 last_update_check_timestamp = 3;
307 // Describes a product being managed by Google Update. (This can also
308 // describe Google Update itself.)
309 message ProductInfo {
310 // The current version of the product that is installed.
311 optional string version = 1;
313 // The date at which Google Update successfully updated this product,
314 // stored in seconds since the Unix epoch. This is updated when an update
315 // is successfully applied, or if the server reports that no update
317 optional int64 last_update_success_timestamp = 2;
319 // The result reported by the product updater on its last run.
321 INSTALL_RESULT_SUCCESS = 0;
322 INSTALL_RESULT_FAILED_CUSTOM_ERROR = 1;
323 INSTALL_RESULT_FAILED_MSI_ERROR = 2;
324 INSTALL_RESULT_FAILED_SYSTEM_ERROR = 3;
325 INSTALL_RESULT_EXIT_CODE = 4;
327 optional InstallResult last_result = 3;
329 // The error code reported by the product updater on its last run. This
330 // will typically be a error code specific to the product installer.
331 optional int32 last_error = 4;
333 // The extra error code reported by the product updater on its last run.
334 // This will typically be a Win32 error code.
335 optional int32 last_extra_error = 5;
337 optional ProductInfo google_update_status = 4;
338 optional ProductInfo client_status = 5;
340 optional GoogleUpdate google_update = 11;
342 // Information on all installed plugins.
344 // The plugin's self-reported name and filename (without path).
345 optional string name = 1;
346 optional string filename = 2;
348 // The plugin's version.
349 optional string version = 3;
351 // True if the plugin is disabled.
352 // If a client has multiple local Chrome user accounts, this is logged based
353 // on the first user account launched during the current session.
354 optional bool is_disabled = 4;
356 // True if the plugin is PPAPI.
357 optional bool is_pepper = 5;
359 repeated Plugin plugin = 7;
361 // Figures that can be used to generate application stability metrics.
362 // All values are counts of events since the last time that these
363 // values were reported.
366 // Total amount of time that the program was running, in seconds,
367 // since the last time a log was recorded, as measured using a client-side
368 // clock implemented via TimeTicks, which guarantees that it is monotonic
369 // and does not jump if the user changes his/her clock. The TimeTicks
370 // implementation also makes the clock not count time the computer is
372 optional int64 incremental_uptime_sec = 1;
374 // Total amount of time that the program was running, in seconds,
375 // since startup, as measured using a client-side clock implemented
376 // via TimeTicks, which guarantees that it is monotonic and does not
377 // jump if the user changes his/her clock. The TimeTicks implementation
378 // also makes the clock not count time the computer is suspended.
379 // This field was added for M-35.
380 optional int64 uptime_sec = 23;
382 // Page loads along with renderer crashes and hangs, since page load count
383 // roughly corresponds to usage.
384 optional int32 page_load_count = 2;
385 optional int32 renderer_crash_count = 3;
386 optional int32 renderer_hang_count = 4;
388 // Number of renderer crashes that were for extensions.
389 // TODO(isherman): Figure out whether this is also counted in
390 // |renderer_crash_count|.
391 optional int32 extension_renderer_crash_count = 5;
393 // Number of non-renderer child process crashes.
394 optional int32 child_process_crash_count = 6;
396 // Number of times the browser has crashed while logged in as the "other
397 // user" (guest) account.
398 // Logged on ChromeOS only.
399 optional int32 other_user_crash_count = 7;
401 // Number of times the kernel has crashed.
402 // Logged on ChromeOS only.
403 optional int32 kernel_crash_count = 8;
405 // Number of times the system has shut down uncleanly.
406 // Logged on ChromeOS only.
407 optional int32 unclean_system_shutdown_count = 9;
410 // All the remaining fields in the Stability are recorded at most once per
414 // The number of times the program was launched.
415 // This will typically be equal to 1. However, it is possible that Chrome
416 // was unable to upload stability metrics for previous launches (e.g. due to
417 // crashing early during startup), and hence this value might be greater
419 optional int32 launch_count = 15;
420 // The number of times that it didn't exit cleanly (which we assume to be
422 optional int32 crash_count = 16;
424 // The number of times the program began, but did not complete, the shutdown
425 // process. (For example, this may occur when Windows is shutting down, and
426 // it only gives the process a few seconds to clean up.)
427 optional int32 incomplete_shutdown_count = 17;
429 // The number of times the program was able register with breakpad crash
431 optional int32 breakpad_registration_success_count = 18;
433 // The number of times the program failed to register with breakpad crash
434 // services. If crash registration fails then when the program crashes no
435 // crash report will be generated.
436 optional int32 breakpad_registration_failure_count = 19;
438 // The number of times the program has run under a debugger. This should
439 // be an exceptional condition. Running under a debugger prevents crash
440 // dumps from being generated.
441 optional int32 debugger_present_count = 20;
443 // The number of times the program has run without a debugger attached.
444 // This should be most common scenario and should be very close to
446 optional int32 debugger_not_present_count = 21;
448 // Stability information for all installed plugins.
449 message PluginStability {
450 // The relevant plugin's information (name, etc.)
451 optional Plugin plugin = 1;
453 // The number of times this plugin's process was launched.
454 optional int32 launch_count = 2;
456 // The number of times this plugin was instantiated on a web page.
457 // This will be >= |launch_count|.
458 // (A page load with multiple sections drawn by this plugin will
459 // increase this count multiple times.)
460 optional int32 instance_count = 3;
462 // The number of times this plugin process crashed.
463 // This value will be <= |launch_count|.
464 optional int32 crash_count = 4;
466 // The number of times this plugin could not be loaded.
467 optional int32 loading_error_count = 5;
469 repeated PluginStability plugin_stability = 22;
471 optional Stability stability = 8;
473 // Description of a field trial or experiment that the user is currently
475 // All metrics reported in this upload can potentially be influenced by the
478 // The name of the field trial, as a 32-bit identifier.
479 // Currently, the identifier is a hash of the field trial's name.
480 optional fixed32 name_id = 1;
482 // The user's group within the field trial, as a 32-bit identifier.
483 // Currently, the identifier is a hash of the group's name.
484 optional fixed32 group_id = 2;
486 repeated FieldTrial field_trial = 9;
488 // Number of users currently signed into a multiprofile session.
489 // A zero value indicates that the user count changed while the log is open.
490 // Logged only on ChromeOS.
491 optional uint32 multi_profile_user_count = 17;
493 // Information about extensions that are installed, masked to provide better
494 // privacy. Only extensions from a single profile are reported; this will
495 // generally be the profile used when the browser is started. The profile
496 // reported on will remain consistent at least until the browser is
497 // relaunched (or the profile is deleted by the user).
499 // Each client first picks a value for client_key derived from its UMA
501 // client_key = client_id % 4096
502 // Then, each installed extension is mapped into a hash bucket according to
503 // bucket = CityHash64(StringPrintf("%d:%s",
504 // client_key, extension_id)) % 1024
505 // The client reports the set of hash buckets occupied by all installed
506 // extensions. If multiple extensions map to the same bucket, that bucket is
507 // still only reported once.
508 repeated int32 occupied_extension_bucket = 18;