• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1// Copyright 2014 The Chromium Authors
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5syntax = "proto2";
6
7option optimize_for = LITE_RUNTIME;
8option java_package = "org.chromium.components.metrics";
9
10option java_outer_classname = "SystemProfileProtos";
11
12package metrics;
13
14import "extension_install.proto";
15
16// Stores information about the user's brower and system configuration.
17// Almost all the fields should be populated on every upload. (The only
18// exception is some fields in the stability section that are only uploaded
19// once per browsing session, usually shortly after startup.)
20// Next tag: 48
21message SystemProfileProto {
22  // The time when the client was compiled/linked, in seconds since the epoch.
23  optional int64 build_timestamp = 1;
24
25  // A version number string for the application. For Chrome, this is the
26  // browser version number, typically a 4-tuple of numbers separated by periods
27  // and may be postfixed with additional properties as described below.
28  //
29  // An example of a browser version 4-tuple is "129.0.6668.89". Currently used
30  // postfixes are (appended in the order below):
31  //
32  //   "-64": a 64-bit build
33  //   "-devel": this is not an official build of Chrome
34  //
35  // A full version number string could look similar to:
36  // "129.0.6668.89-64-devel".
37  //
38  // This value is more trustworthy than the UA string associated with the
39  // request as it is not user-modifiable.
40  optional string app_version = 2;
41
42  // The application can create logs about previous versions. In particular the
43  // initial stability log refers to the previous run, which can be an older
44  // version. This field is set by the client when the log being written has an
45  // app_version that's different than the version of the app writing the log.
46  // Note that the version uploading the log may also be different.
47  optional string log_written_by_app_version = 40;
48
49  // The brand code or distribution tag assigned to a partner, if available.
50  // Windows, Mac, iOS, and CrOS clients may have a brand code.
51  optional string brand_code = 12;
52
53  enum Channel {
54    CHANNEL_UNKNOWN = 0;  // Unknown channel -- perhaps an unofficial build?
55    CHANNEL_CANARY = 1;
56    CHANNEL_DEV = 2;
57    CHANNEL_BETA = 3;
58    CHANNEL_STABLE = 4;
59  }
60
61  optional Channel channel = 10;
62
63  // True for a client following updates on the extended stable channel;
64  // see go/chrome-extended-dd.
65  optional bool is_extended_stable_channel = 36 [default = false];
66
67  // True if Chrome build is instrumented (e.g. built with ASAN instrumentation
68  // or with DCHECKs enabled).
69  // This field was renamed from |is_asan_build| to reflect its actual meaning.
70  optional bool is_instrumented_build = 20 [default = false];
71
72  // For Chrome, the date the user enabled UMA, in seconds since the epoch.
73  // If the user has toggled the UMA enabled state multiple times, this will
74  // be the most recent date on which UMA was enabled.
75  // For privacy, this is rounded to the nearest hour (M30+).
76  // For WebView, the field stores the date "January 1st, 2014 00:00:00 UTC"
77  // if the user opted into metrics collection before WebView started tracking
78  // this information. Otherwise, the field value should correctly reflect the
79  // first startup for this app after the user opted into metrics collection.
80  optional int64 uma_enabled_date = 3;
81
82  // The time when the client was installed, in seconds since the epoch.
83  // For privacy, this is rounded to the nearest hour.
84  optional int64 install_date = 16;
85
86  // A message about the cloned install detection that helps improve data
87  // quality by identifying potential VMs and bots. This message will be
88  // set in every record after the client has ever been reset due to cloned
89  // install detection. However, the `cloned_from_client_id`
90  // field will only be set in the resetting session because this is not
91  // persisted in the local prefs.
92  // Next tag: 5
93  message ClonedInstallInfo {
94    // The latest timestamp we reset a cloned client’s client id, in seconds
95    // since the epoch. For privacy, this is rounded to the nearest hour.
96    optional int64 last_timestamp = 1;
97
98    // The client_id that this client is cloned from. This field is tied to the
99    // cloned install detector only; any other way of resetting client_id
100    // doesn't touch this field. This field is only reported in the
101    // resetting session.
102    optional fixed64 cloned_from_client_id = 2;
103
104    // The first timestamp when we reset a cloned client’s client id, in seconds
105    // since the epoch. For privacy, this is rounded to the nearest hour.
106    optional int64 first_timestamp = 3;
107
108    // The number of times this client has been reset due to cloned install.
109    // Increment by one per reset happens.
110    optional int32 count = 4;
111  }
112
113  optional ClonedInstallInfo cloned_install_info = 39;
114
115  // The non-identifying low entropy source value. This value seeds the
116  // pseudorandom generator which picks experimental groups. Clients only report
117  // the value that they used for picking experimental groups on startup which
118  // means this value won't be changed within the session even even if the low
119  // entropy source is reset (e.g. via the UMA checkbox) because group
120  // assignments won't be changed until restart.
121  optional int32 low_entropy_source = 31;
122
123  // The old low entropy value. This value is thought to be biased in the wild,
124  // and is no longer used for experiments requiring low entropy. Clients which
125  // already have an "old" value continue incorporating it into the high entropy
126  // source, to avoid changing those group assignments. New clients only have
127  // the new source.
128  optional int32 old_low_entropy_source = 32;
129
130  // A pseudo low entropy value. The actual low_entropy_source value is used for
131  // assignment to experiment arms, and this use may cause drift over time (for
132  // example, if a bad experiment arm drives away some users permanently.) This
133  // pseudo low entropy value is generated identically to low_entropy_source,
134  // but it is generated with a different randomization seed and is not used for
135  // experiment randomization. Consequently, it can be used in statistical
136  // validation to answer the question of how our data would be distributed if
137  // we didn't have to worry about low entropy source drift.
138  optional int32 pseudo_low_entropy_source = 37;
139
140  // The user's selected application locale, i.e. the user interface language.
141  // The locale includes a language code and, possibly, also a country code,
142  // e.g. "en-US".
143  optional string application_locale = 4;
144
145  // Hashes of command line keys used in the browser session when the MetricsLog
146  // is created. This takes into account the command line switches that were
147  // used when launching the session, as well as any modifications made to them,
148  // for example via CommandLine::AppendSwitch and CommandLine::RemoveSwitch.
149  // Values are the lower 32-bit of SHA1 hash in little-endian.
150  repeated fixed32 command_line_key_hash = 38 [packed = true];
151
152  // Information on the user's operating system.
153  // Next tag: 11
154  message OS {
155    // The user's operating system. This should be one of:
156    // - 'Android'
157    // - 'Windows NT'
158    // - 'CrOS' (as of 07/2020)
159    // - 'Lacros'  (the Lacros browser runs on Chrome OS, but reports a special
160    //              OS name to differentiate itself from the built-in ash
161    //              browser + window manager binary.)
162    // - 'Linux' (includes ChromeOS prior to 07/2020)
163    // - 'iOS' (iOS versions >= 9)
164    // - 'iPhone OS' (iOS versions <= 8)
165    // - 'iPadOS'
166    // - 'Mac OS X'
167    optional string name = 1;
168
169    // The version of the OS.  The meaning of this field is OS-dependent.
170    optional string version = 2;
171
172    // The fingerprint of the build.  Only used on Android and WebView.
173    optional string build_fingerprint = 3;
174
175    // The build number for the OS version. The same OS version may have a
176    // different build number. The meaning of this field is OS-dependent.
177    optional string build_number = 5;
178
179    // The version of the kernel. Linux based operating systems, such as
180    // ChromeOS and Android, have a kernel version that the OS release version
181    // was built with that differs from the version field above.
182    optional string kernel_version = 6;
183
184    // Information on ChromeOS ARC runtime. This is collected to ease analysis
185    // on ARC-specific metrics, since this info varies by different boards /
186    // build configs / releases.
187    // Next tag: 2
188    message Arc {
189      // Android release number from build.prop "ro.build.version.release", e.g.
190      // "7.1.1" for N and "9" for P.
191      optional string release = 1;
192    }
193
194    // Available since M76. This field is reported if current build supports
195    // ARC, regardless of whether ARC is enabled or not. Check "Arc.State"
196    // histogram to determine if ARC is enabled for current report.
197    // Logged on ChromeOS only.
198    optional Arc arc = 7;
199
200    // Data related to system-level dark mode configuration. This is currently
201    // only uploaded on Android. "*_APP" variants are included to reflect when
202    // the user overrides the system configuration within the browser
203    enum DarkModeState {
204      UNKNOWN = 0;
205
206      // Both the system and the browser are in dark mode.
207      DARK_MODE_SYSTEM = 1;
208
209      // The browser is in dark mode, but the state of the system either cannot
210      // be determined or has been overridden by the user.
211      DARK_MODE_APP = 2;
212
213      // Both the system and the browser are in light mode.
214      LIGHT_MODE_SYSTEM = 3;
215
216      // The browser is in light mode, but the state of the system either cannot
217      // be determined or has been overridden by the user.
218      LIGHT_MODE_APP = 4;
219    }
220
221    optional DarkModeState dark_mode_state = 8 [default = UNKNOWN];
222
223    // The value returned by the "XDG_SESSION_TYPE" environment variable, as
224    // translated to a base::nix::SessionType, this field is only set on Linux.
225    // Some features are enabled/disabled depending on this value.
226    enum XdgSessionType {
227      UNSET = 0;
228      OTHER_SESSION_TYPE = 1;
229      UNSPECIFIED = 2;
230      TTY = 3;
231      X11 = 4;
232      WAYLAND = 5;
233      MIR = 6;
234    }
235
236    optional XdgSessionType xdg_session_type = 9;
237
238    // The value returned by the "XDG_CURRENT_DESKTOP" environment variable, as
239    // translated to a base::nix::DesktopEnvironment. Note that all KDE values
240    // from that enum are bucketed together. This field is only set on Linux.
241    // Some bugs reproduce only in particular desktop environments.
242    enum XdgCurrentDesktop {
243      OTHER = 0;
244      CINNAMON = 1;
245      DEEPIN = 2;
246      GNOME = 3;
247      KDE = 4;
248      PANTHEON = 5;
249      UKUI = 6;
250      UNITY = 7;
251      XFCE = 8;
252      LXQT = 9;
253    }
254
255    optional XdgCurrentDesktop xdg_current_desktop = 10;
256  }
257
258  optional OS os = 5;
259
260  // Information on the user's hardware.
261  // Next tag: 28
262  message Hardware {
263    // OS CPU architecture. Common options are: x86, x86_64, arm64, armv7,
264    // armv7l, armv8l and aarch64.
265    // Note: On Windows, this is not the true OS CPU architecture in the case
266    // of running under emulation (e.g. on Windows on ARM, which would report
267    // either x86 or x86_64, depending on the bitness of the exe being run).
268    // Started being correctly recorded on iOS in M90: crrev/c/2723012.
269    optional string cpu_architecture = 1;
270
271    // Browser process CPU architecture. Will be different from
272    // `cpu_architecture` in the case where Chromium runs non-natively (e.g.
273    // macOS Rosetta or Arm Windows). One of four values: x86, x86_64, ARM,
274    // ARM_64. Added in M90.
275    optional string app_cpu_architecture = 21;
276
277    // The amount of RAM present on the system, in megabytes.
278    optional int64 system_ram_mb = 2;
279
280    // The base memory address that chrome.dll was loaded at.
281    // (Logged only on Windows.)
282    optional int64 dll_base = 3;
283
284    // The hardware_class describes the current machine model, e.g. "MacPro1,1"
285    // on Mac, "iPhone9,3" on iOS or "Nexus 5" on Android. Implemented on OS X,
286    // iOS, Android, Chrome OS.
287    //
288    // The iOS device hardware class was added in Chrome M60 release. Prior
289    // to that, device hardware class was incorrectly recorded in
290    // cpu_architecture field.
291    //
292    // For Chrome OS, prior to M69, this field had the value that is
293    // currently in |full_hardware_class| field. In M69+, this contains the
294    // board name only. E.G. "CELES", "VEYRON_MINNIE".
295
296    optional string hardware_class = 4;
297
298    // This field is only sent on Chrome OS. The full hardware class is a unique
299    // string associated with each Chrome OS device product revision generally
300    // assigned at hardware qualification time. The hardware class effectively
301    // identifies the configured system components such as CPU, WiFi adapter,
302    // etc.
303    //
304    // An example of such a hardware class is "IEC MARIO PONY 6101".  An
305    // internal database associates this hardware class with the qualified
306    // device specifications including OEM information, schematics, hardware
307    // qualification reports, test device tags, etc.
308    optional string full_hardware_class = 18;
309
310    // This field is only sent on Chrome OS devices with cellular support.
311    // This represents the variant of cellular modem present on the device.
312    optional string cellular_device_variant = 24;
313
314    // The number of physical screens.
315    optional int32 screen_count = 5;
316
317    // The screen dimensions of the primary screen, in pixels.
318    optional int32 primary_screen_width = 6;
319    optional int32 primary_screen_height = 7;
320
321    // The device scale factor of the primary screen.
322    optional float primary_screen_scale_factor = 12;
323
324    // Max DPI for any attached screen. (Windows only)
325    optional float max_dpi_x = 9;
326    optional float max_dpi_y = 10;
327
328    // The form factor of the device. Added in M101, foldable added in M120.
329    // Android devices can be phone, tablet, TV, automotive or foldable. iOS
330    // devices can be phone or tablet. For Windows, Mac, ChromeOS, Lacros, and
331    // Linux, the desktop form factor is always used.
332    enum FormFactor {
333      FORM_FACTOR_UNKNOWN = 0;
334      FORM_FACTOR_DESKTOP = 1;
335      FORM_FACTOR_PHONE = 2;
336      FORM_FACTOR_TABLET = 3;
337      FORM_FACTOR_TV = 4;
338      FORM_FACTOR_MEET_DEVICE = 5;
339      FORM_FACTOR_AUTOMOTIVE = 6;
340      FORM_FACTOR_FOLDABLE = 7;
341    }
342
343    optional FormFactor form_factor = 22;
344
345    // Information on the CPU obtained by CPUID.
346    message CPU {
347      // A 12 character string naming the vendor, e.g. "GenuineIntel".
348      optional string vendor_name = 1;
349
350      // The signature reported by CPUID (from EAX).
351      optional uint32 signature = 2;
352
353      // Number of logical processors/cores on the current machine, which
354      // includes hyperthreaded cores.
355      optional uint32 num_cores = 3;
356
357      // Number of efficient logical processors/cores on the current machine,
358      // which includes hyperthreaded cores. All cores below highest power
359      // efficiency level are considered efficient.
360      optional uint32 num_efficient_cores = 5;
361
362      // Whether the CPU is running in a hypervisor.
363      optional bool is_hypervisor = 4;
364    }
365
366    optional CPU cpu = 13;
367
368    // Type of BIOS (can change at each boot).
369    enum BiosType {
370      BIOS_TYPE_UNKNOWN = 0;
371
372      // Legacy BIOS or UEFI with CSM mode.
373      BIOS_TYPE_LEGACY = 1;
374
375      // BIOS is UEFI and booted into UEFI mode.
376      BIOS_TYPE_UEFI = 2;
377    }
378
379    // Motherboard information.
380    message Motherboard {
381      // Manufacturer for the motherboard.
382      optional string manufacturer = 1;
383
384      // Model for the motherboard.
385      optional string model = 2;
386
387      // Manufacturer for the BIOS.
388      optional string bios_manufacturer = 3;
389
390      // Version of the BIOS currently installed.
391      optional string bios_version = 4;
392
393      // What mode of BIOS is booted.
394      optional BiosType bios_type = 5;
395    }
396
397    optional Motherboard motherboard = 25;
398
399    // Information on the GPU
400    message Graphics {
401      // The GPU manufacturer's vendor id.
402      optional uint32 vendor_id = 1;
403
404      // The GPU manufacturer's device id for the chip set.
405      optional uint32 device_id = 2;
406
407      // The driver version on the GPU.
408      optional string driver_version = 3;
409
410      // The GL_VENDOR string. An example of a gl_vendor string is
411      // "Imagination Technologies". "" if we are not using OpenGL.
412      optional string gl_vendor = 6;
413
414      // The GL_RENDERER string. An example of a gl_renderer string is
415      // "PowerVR SGX 540". "" if we are not using OpenGL.
416      optional string gl_renderer = 7;
417    }
418
419    optional Graphics gpu = 8;
420
421    // Whether the internal display produces touch events. Omitted if unknown.
422    // Logged on ChromeOS only.
423    optional bool internal_display_supports_touch = 14;
424
425    // Internal storage device information on ChromeOS. Added in M94.
426    // Next tag: 9
427    message InternalStorageDevice {
428      // Id of the storage device manufacturer.
429      // Can be vendor_id (for NVMe, 32bit), manfid (for eMMC, 16bit, since
430      // M113), oemid (for eMMC, 16bit, before M113), JEDEC manfid (for UFS,
431      // 16bit) etc. depending on the device type.
432      optional uint32 vendor_id = 1;
433
434      // Id of the storage device product.
435      // Can be product_id (for NVMe, 32bit), PNM (for eMMC, 48bit), hashed
436      // model name (for UFS, 32bit) etc. depending on the device type.
437      optional uint64 product_id = 2;
438
439      // Revision of the storage device product.
440      // Can be PCIe rev (for NVMe, 8bit), PRV(for eMMC, 8bit) etc. depending on
441      // the device type.
442      optional uint32 revision = 3;
443
444      // Storage Device model. Comes from /sys/block/<device>/device/model.
445      optional string model = 4;
446
447      // Storage Device capacity in MB.
448      optional uint32 size_mb = 5;
449
450      // 8 byte FW revision of a storage device. Usually a string, but may
451      // contain non-printable characters.
452      optional uint64 firmware_version = 6;
453
454      // Type of the storage device interface.
455      // TYPE_UNKNOWN signifies an error on population side.
456      enum Type {
457        TYPE_UNKNOWN = 0;
458        TYPE_EMMC = 1;
459        TYPE_NVME = 2;
460        TYPE_UFS = 3;
461        TYPE_SD_EXPRESS_INTERNAL = 4;
462      }
463
464      optional Type type = 7;
465
466      // Purpose defines how the OS uses the device.
467      // PURPOSE_UNKNOWN signifies an error on population side.
468      enum Purpose {
469        PURPOSE_UNKNOWN = 0;
470        PURPOSE_BOOT = 1;
471        PURPOSE_SWAP = 2;
472        PURPOSE_BOOT_SWAP = 3;
473      }
474
475      optional Purpose purpose = 8;
476    }
477
478    // List of internal storage devices on a Chrome OS device.
479    repeated InternalStorageDevice internal_storage_devices = 20;
480
481    // Drive messages are currently logged on Windows 7+, iOS, and Android.
482    message Drive {
483      // Whether this drive incurs a time penalty when randomly accessed. This
484      // should be true for spinning disks but false for SSDs or other
485      // flash-based drives.
486      optional bool has_seek_penalty = 1;
487    }
488
489    // The drive that the application executable was loaded from.
490    optional Drive app_drive = 16;
491
492    // The drive that the current user data directory was loaded from.
493    optional Drive user_data_drive = 17;
494
495    // Type of TPM on the device. This field is only filled in on ChromeOS
496    // devices (both CrOS and LaCrOS platforms). This includes Chromebooks with
497    // TPM1.2 or GSC (cr50 and ti50), flex devices (ChromeOS installed on
498    // devices with other OS) which has TPM type "runtime selection", and lastly
499    // generic TPM2 devices that use TPM2 chips that aren't manufactured by
500    // Google.
501    enum TpmType {
502      TPM_TYPE_UNKNOWN = 0;
503      TPM_TYPE_1 = 1;
504      TPM_TYPE_CR50 = 2;
505      TPM_TYPE_TI50 = 3;
506      TPM_TYPE_RUNTIME_SELECTION = 4;
507      TPM_TYPE_GENERIC_2 = 5;
508    }
509
510    optional TpmType tpm_type = 23;
511
512    // Firmware version of the TPM on the device. This field is only filled in
513    // on ChromeOS devices (both CrOS and LaCrOS platforms).
514    optional uint64 tpm_firmware_version = 26;
515
516    // RW Firmware version of the TPM on the device. This field is only filled
517    // in on ChromeOS devices.
518    optional string tpm_rw_firmware_version = 27;
519  }
520
521  optional Hardware hardware = 6;
522
523  // Information about the network connection.
524  // Next tag: 9
525  message Network {
526    // Set to true if connection_type changed during the lifetime of the log.
527    optional bool connection_type_is_ambiguous = 1;
528
529    // Derived from net::NetworkChangeNotifier::ConnectionType translated
530    // through NetworkMetricsProvider::GetConnectionType.
531    enum ConnectionType {
532      CONNECTION_UNKNOWN = 0;
533      CONNECTION_ETHERNET = 1;
534      CONNECTION_WIFI = 2;
535      CONNECTION_2G = 3;
536      CONNECTION_3G = 4;
537      CONNECTION_4G = 5;
538      CONNECTION_BLUETOOTH = 6;
539      CONNECTION_NONE = 7;
540
541      // As an alternative to connection_type_is_ambiguous above,
542      // CONNECTION_AMBIGUOUS can be used for connection_type instead. This is
543      // to be used in logs processing as a more convenient way to manage the
544      // ambiguous case when breaking down stats by connection_type.
545      CONNECTION_AMBIGUOUS = 8;
546      CONNECTION_5G = 9;
547    }
548
549    // The connection type according to NetworkChangeNotifier.
550    optional ConnectionType connection_type = 2;
551
552    // Derived from net::NetworkQualityEstimator::EffectiveConnectionType
553    // translated through NetworkMetricsProvider::GetConnectionType.
554    enum EffectiveConnectionType {
555      EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0;
556
557      // Deprecated: Specifies that the connection_type changed during the
558      // lifetime of the log.
559      DEPRECATED_EFFECTIVE_CONNECTION_TYPE_AMBIGUOUS = 1 [deprecated = true];
560
561      EFFECTIVE_CONNECTION_TYPE_OFFLINE = 2;
562      EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 3;
563      EFFECTIVE_CONNECTION_TYPE_2G = 4;
564      EFFECTIVE_CONNECTION_TYPE_3G = 5;
565      EFFECTIVE_CONNECTION_TYPE_4G = 6;
566    }
567
568    // The minimum and maximum values of the effective connection type enum
569    // during the lifetime of the log according to net::NetworkQualityEstimator.
570    // EffectiveConnectionType is the connection type whose typical performance
571    // is most similar to the measured performance of the network in use. In
572    // many cases, the "effective" connection type and the actual type of
573    // connection in use are the same, but often a network connection performs
574    // significantly differently, usually worse, from its expected capabilities.
575    optional EffectiveConnectionType min_effective_connection_type = 7;
576    optional EffectiveConnectionType max_effective_connection_type = 8;
577  }
578
579  optional Network network = 13;
580
581  // Information on the Google Update install that is managing this client.
582  message GoogleUpdate {
583    // Whether the Google Update install is system-level or user-level.
584    optional bool is_system_install = 1;
585
586    // The date at which Google Update last started performing an automatic
587    // update check, in seconds since the Unix epoch.
588    optional int64 last_automatic_start_timestamp = 2;
589
590    // The date at which Google Update last successfully sent an update check
591    // and received an intact response from the server, in seconds since the
592    // Unix epoch. (The updates don't need to be successfully installed.)
593    optional int64 last_update_check_timestamp = 3;
594
595    // Describes a product being managed by Google Update. (This can also
596    // describe Google Update itself.)
597    message ProductInfo {
598      // The current version of the product that is installed.
599      optional string version = 1;
600
601      // The date at which Google Update successfully updated this product,
602      // stored in seconds since the Unix epoch.  This is updated when an update
603      // is successfully applied, or if the server reports that no update
604      // is available.
605      optional int64 last_update_success_timestamp = 2;
606
607      // The result reported by the product updater on its last run.
608      enum InstallResult {
609        INSTALL_RESULT_SUCCESS = 0;
610        INSTALL_RESULT_FAILED_CUSTOM_ERROR = 1;
611        INSTALL_RESULT_FAILED_MSI_ERROR = 2;
612        INSTALL_RESULT_FAILED_SYSTEM_ERROR = 3;
613        INSTALL_RESULT_EXIT_CODE = 4;
614      }
615
616      optional InstallResult last_result = 3;
617
618      // The error code reported by the product updater on its last run.  This
619      // will typically be a error code specific to the product installer.
620      optional int32 last_error = 4;
621
622      // The extra error code reported by the product updater on its last run.
623      // This will typically be a Win32 error code.
624      optional int32 last_extra_error = 5;
625    }
626
627    optional ProductInfo google_update_status = 4;
628    optional ProductInfo client_status = 5;
629  }
630
631  optional GoogleUpdate google_update = 11;
632
633  // Figures that can be used to generate application stability metrics.
634  // All values are counts of events since the last time that these
635  // values were reported.
636  // Next tag: 32
637  message Stability {
638    // Total amount of time that the program was running, in seconds,
639    // since the last time a log was recorded, as measured using a client-side
640    // clock implemented via TimeTicks, which guarantees that it is monotonic
641    // and does not jump if the user changes their clock.  The TimeTicks
642    // implementation also makes the clock not count time the computer is
643    // suspended.
644    optional int64 incremental_uptime_sec = 1;
645
646    // Total amount of time that the program was running, in seconds,
647    // since startup, as measured using a client-side clock implemented
648    // via TimeTicks, which guarantees that it is monotonic and does not
649    // jump if the user changes their clock.  The TimeTicks implementation
650    // also makes the clock not count time the computer is suspended.
651    // This field was added for M-35.
652    optional int64 uptime_sec = 23;
653
654    // Logged on Android only as of late Q2 2022. Used by only Android WebView.
655    // Other platforms should use Stability.Counts2.
656    optional int32 page_load_count = 2;
657
658    // Logged on Android only as of Q2 2022. Used by only Android WebView. Other
659    // platforms should use Stability.Counts2.
660    optional int32 renderer_launch_count = 26;
661
662    // Number of times the browser has crashed while logged in as the "other
663    // user" (guest) account.
664    // Logged on ChromeOS only.
665    optional int32 other_user_crash_count = 7;
666
667    // Number of times the kernel has crashed.
668    // Logged on ChromeOS only.
669    optional int32 kernel_crash_count = 8;
670
671    // Number of times the system has shut down uncleanly.
672    // Logged on ChromeOS only.
673    optional int32 unclean_system_shutdown_count = 9;
674
675    // All the remaining fields in the Stability are recorded at most once per
676    // client session.
677
678    // The number of times the program was launched since the last time metrics
679    // was uploaded. For the initial metrics upload (right after startup), this
680    // will often be equal to 1. However, it is possible that Chrome was unable
681    // to upload stability metrics for previous launches (e.g. due to crashing
682    // early during startup), making this value greater than 1. For subsequent
683    // metrics uploads, this value will be 0.
684    //
685    // Logged on Android only as of Q1 2022. Used by only Android WebView. Other
686    // platforms should use Stability.Counts2.
687    optional int32 launch_count = 15;
688
689    // Android only. The number of times Chrome didn't exit cleanly and the GMS
690    // Core version has changed from the last session. This is in addition to
691    // |crash_count| in which we exclude unclean exits that are likely caused by
692    // GMS Core updates.
693    optional int32 crash_count_due_to_gms_core_update = 30;
694
695    // Whether the metrics being reported are from a previous run picked up via
696    // the left-over memory mapped files.
697    optional bool from_previous_run = 29;
698  }
699
700  optional Stability stability = 8;
701
702  // Description of a field trial or experiment that the user is currently
703  // enrolled in.
704  // All metrics reported in this upload can potentially be influenced by the
705  // field trial.
706  message FieldTrial {
707    // The name of the field trial, as a 32-bit identifier.
708    // Currently, the identifier is a hash of the field trial's name.
709    optional fixed32 name_id = 1;
710
711    // The user's group within the field trial, as a 32-bit identifier.
712    // Currently, the identifier is a hash of the group's name.
713    optional fixed32 group_id = 2;
714  }
715
716  repeated FieldTrial field_trial = 9;
717
718  // Seed version from variations_seed.proto used to instantiate FieldTrials
719  // for this session.
720  optional string variations_seed_version = 28;
721
722  // Whether the client_id in the log matches the client_id we used to assign
723  // field trials.
724  optional bool client_id_was_used_for_trial_assignment = 33;
725
726  // The unhashed client_id for this report. This is a uuid in its canonical
727  // textual representation in the form 8-4-4-4-12 for a total of 36 characters.
728  // Used to simulate field trial assignments for the client.
729  // This field is set when MetricsService::CreateLog is called, and the value
730  // is normally equal to the MetricsStateManager's initial_client_id_.
731  optional string client_uuid = 34;
732
733  // The session's hash. At the beginning of a Chrome session, a random number
734  // will be generated, and all logs from that session will have this field set
735  // to that number. This is kept track of properly even when creating logs from
736  // previous sessions (e.g. independent logs from PMA files and stability
737  // logs), which is not the case for the `session_id` field in
738  // ChromeUserMetricsExtension. A benefit of this is that this can
739  // differentiate sessions between cloned installs that may report the same
740  // `session_id` but are actually different sessions.
741  // Note: Added in M125. Clients before will not set this field, and trying to
742  // read it will return the default value of 0.
743  optional fixed64 session_hash = 46;
744
745  // Information about the A/V output device(s) (typically just a TV).
746  // However, a configuration may have one or more intermediate A/V devices
747  // between the source device and the TV (e.g. an A/V receiver, video
748  // processor, etc.).
749  message ExternalAudioVideoDevice {
750    // The manufacturer name (possibly encoded as a 3-letter code, e.g. "YMH"
751    // for Yamaha).
752    optional string manufacturer_name = 1;
753
754    // The model name (e.g. "RX-V1900"). Some devices may report generic names
755    // like "receiver" or use the full manufacturer name (e.g "PHILIPS").
756    optional string model_name = 2;
757
758    // The product code (e.g. "0218").
759    optional string product_code = 3;
760
761    // The device types. A single device can have multiple types (e.g. a set-top
762    // box could be both a tuner and a player).  The same type may even be
763    // repeated (e.g a device that reports two tuners).
764    enum AVDeviceType {
765      AV_DEVICE_TYPE_UNKNOWN = 0;
766      AV_DEVICE_TYPE_TV = 1;
767      AV_DEVICE_TYPE_RECORDER = 2;
768      AV_DEVICE_TYPE_TUNER = 3;
769      AV_DEVICE_TYPE_PLAYER = 4;
770      AV_DEVICE_TYPE_AUDIO_SYSTEM = 5;
771    }
772
773    repeated AVDeviceType av_device_type = 4;
774
775    // The year of manufacture.
776    optional int32 manufacture_year = 5;
777
778    // The week of manufacture.
779    // Note: per the Wikipedia EDID article, numbering for this field may not
780    // be consistent between manufacturers.
781    optional int32 manufacture_week = 6;
782
783    // Selected horizontal resolution in pixels.
784    optional int32 horizontal_resolution = 7;
785
786    // Selected vertical resolution in pixels.
787    optional int32 vertical_resolution = 8;
788
789    // Audio capabilities of the device.
790    // Ref: http://en.wikipedia.org/wiki/Extended_display_identification_data
791    // Next tag: 7
792    message AudioDescription {
793      // Audio format
794      enum AudioFormat {
795        AUDIO_FORMAT_UNKNOWN = 0;
796        AUDIO_FORMAT_LPCM = 1;
797        AUDIO_FORMAT_AC_3 = 2;
798        AUDIO_FORMAT_MPEG1 = 3;
799        AUDIO_FORMAT_MP3 = 4;
800        AUDIO_FORMAT_MPEG2 = 5;
801        AUDIO_FORMAT_AAC = 6;
802        AUDIO_FORMAT_DTS = 7;
803        AUDIO_FORMAT_ATRAC = 8;
804        AUDIO_FORMAT_ONE_BIT = 9;
805        AUDIO_FORMAT_DD_PLUS = 10;
806        AUDIO_FORMAT_DTS_HD = 11;
807        AUDIO_FORMAT_MLP_DOLBY_TRUEHD = 12;
808        AUDIO_FORMAT_DST_AUDIO = 13;
809        AUDIO_FORMAT_MICROSOFT_WMA_PRO = 14;
810      }
811
812      optional AudioFormat audio_format = 1;
813
814      // Number of channels (e.g. 1, 2, 8, etc.).
815      optional int32 num_channels = 2;
816
817      // Supported sample frequencies in Hz (e.g. 32000, 44100, etc.).
818      // Multiple frequencies may be specified.
819      repeated int32 sample_frequency_hz = 3;
820
821      // Maximum bit rate in bits/s.
822      optional int32 max_bit_rate_per_second = 4;
823
824      // Bit depth (e.g. 16, 20, 24, etc.).
825      optional int32 bit_depth = 5;
826
827      // Output mode: analog vs digital.
828      enum OutputMode {
829        ANALOG = 0;
830        DIGITAL = 1;
831      }
832
833      optional OutputMode output_mode = 6;
834    }
835
836    repeated AudioDescription audio_description = 9;
837
838    // The position in AV setup.
839    // A value of 0 means this device is the TV.
840    // A value of 1 means this device is directly connected to one of
841    // the TV's inputs.
842    // Values > 1 indicate there are 1 or more devices between this device
843    // and the TV.
844    optional int32 position_in_setup = 10;
845
846    // Whether this device is in the path to the TV.
847    optional bool is_in_path_to_tv = 11;
848
849    // The CEC version the device supports.
850    // CEC stands for Consumer Electronics Control, a part of the HDMI
851    // specification.  Not all HDMI devices support CEC.
852    // Only devices that support CEC will report a value here.
853    optional int32 cec_version = 12;
854
855    // This message reports CEC commands seen by a device.
856    // After each log is sent, this information is cleared and gathered again.
857    // By collecting CEC status information by opcode we can determine
858    // which CEC features can be supported.
859    message CECCommand {
860      // The CEC command opcode.  CEC supports up to 256 opcodes.
861      // We add only one CECCommand message per unique opcode.  Only opcodes
862      // seen by the device will be reported. The remainder of the message
863      // accumulates status for this opcode (and device).
864      optional int32 opcode = 1;
865
866      // The total number of commands received from the external device.
867      optional int32 num_received_direct = 2;
868
869      // The number of commands received from the external device as part of a
870      // broadcast message.
871      optional int32 num_received_broadcast = 3;
872
873      // The total number of commands sent to the external device.
874      optional int32 num_sent_direct = 4;
875
876      // The number of commands sent to the external device as part of a
877      // broadcast message.
878      optional int32 num_sent_broadcast = 5;
879
880      // The number of aborted commands for unknown reasons.
881      optional int32 num_aborted_unknown_reason = 6;
882
883      // The number of aborted commands because of an unrecognized opcode.
884      optional int32 num_aborted_unrecognized = 7;
885    }
886
887    repeated CECCommand cec_command = 13;
888
889    // Selected Frame rate
890    optional int32 frame_rate = 14;
891
892    // Selected color encoding.
893    enum ColorEncoding {
894      COLOR_ENCODING_UNKNOWN = 0;
895      COLOR_ENCODING_RGB = 1;
896      COLOR_ENCODING_YUV444 = 2;
897      COLOR_ENCODING_YUV422 = 3;
898      COLOR_ENCODING_YUV420 = 4;
899    }
900
901    optional ColorEncoding color_encoding = 15;
902
903    // Selected bit-depth.
904    optional int32 bit_depth = 16;
905
906    // Devices's max TMDS char rate.
907    optional int32 tmds = 17;
908
909    // HDR10 support.
910    optional bool hdr10_support = 18;
911
912    // Dolby vision support.
913    optional bool dolby_vision_support = 19;
914
915    // Supported EOTF's.
916    // EOTF support according to the spec:
917    //   eotf_support & 0x1 -> SDR supported
918    //   (eotf_support > 1) & 0x1 -> traditional HDR supported
919    //   (eotf_support > 2) & 0x1 -> ST2084 supported
920    optional int32 eotf_support = 20;
921
922    // Supports YUV.
923    optional bool yuv_support = 21;
924
925    // Supports YUV_420.
926    optional bool yuv_420_support = 22;
927
928    // The maximum HDCP version supported by the sink.
929    optional int32 maximum_supported_hdcp_version = 23;
930
931    // The current HDCP version negotiated with the sink.
932    optional int32 current_hdcp_version = 24;
933  }
934
935  repeated ExternalAudioVideoDevice external_audio_video_device = 14;
936
937  // Information about the current wireless access point. Collected directly
938  // from the wireless access point via standard apis if the device is
939  // connected to the Internet wirelessly. Introduced for Chrome on TV devices
940  // but also can be collected by cast devices running Chrome OS and Android.
941  // Not logged by Chrome browser platforms.
942  message ExternalAccessPoint {
943    // The manufacturer name, for example "ASUSTeK Computer Inc.".
944    optional string manufacturer = 1;
945
946    // The model name, for example "Wi-Fi Protected Setup Router".
947    optional string model_name = 2;
948
949    // The model number, for example "RT-N16".
950    optional string model_number = 3;
951
952    // The device name (sometime same as model_number), for example "RT-N16".
953    optional string device_name = 4;
954
955    // The organizationally unique identifier, for example "08:9E:08".
956    // OUI is the highest three bytes of MAC address
957    // Google's OUI (08:9E:08) is encoded as 0x00089E08
958    // Never recorded server side, but some old clients may send values with
959    // this tag.
960    reserved 5;
961  }
962
963  optional ExternalAccessPoint external_access_point = 15;
964
965  // Number of users currently signed into a multiprofile session.
966  // A zero value indicates that the user count changed while the log is open.
967  // Logged only on ChromeOS.
968  optional uint32 multi_profile_user_count = 17;
969
970  // Information about extensions that are installed, masked to provide better
971  // privacy.  Only extensions from a single profile are reported; this will
972  // generally be the profile used when the browser is started.  The profile
973  // reported on will remain consistent at least until the browser is
974  // relaunched (or the profile is deleted by the user).
975  //
976  // Each client first picks a value for client_key derived from its UMA
977  // client_id:
978  //   client_key = client_id % 4096
979  // Then, each installed extension is mapped into a hash bucket according to
980  //   bucket = CityHash64(StringPrintf("%d:%s",
981  //                                    client_key, extension_id)) % 1024
982  // The client reports the set of hash buckets occupied by all installed
983  // extensions.  If multiple extensions map to the same bucket, that bucket is
984  // still only reported once.
985  repeated int32 occupied_extension_bucket = 18;
986
987  // The state of loaded extensions for this system. The system can have either
988  // no applicable extensions, extensions only from the webstore and verified by
989  // the webstore, extensions only from the webstore but not verified, or
990  // extensions not from the store. If there is a single off-store extension,
991  // then HAS_OFFSTORE is reported. This should be kept in sync with the
992  // corresponding enum in chrome/browser/metrics/extensions_metrics_provider.cc
993  enum ExtensionsState {
994    NO_EXTENSIONS = 0;
995    NO_OFFSTORE_VERIFIED = 1;
996    NO_OFFSTORE_UNVERIFIED = 2;
997    HAS_OFFSTORE = 3;
998  }
999
1000  optional ExtensionsState offstore_extensions_state = 19;
1001
1002  // The nature of the choice the user was given concerning metrics recording.
1003  // Specifically, whether the enable metrics/crash reporting checkbox that was
1004  // shown on first run was checked or unchecked by default.
1005  // This state is recorded on first run, and uploaded in every UMA log.
1006  enum UmaDefaultState {
1007    // The enable checkbox was unchecked by default.
1008    OPT_IN = 0;
1009
1010    // The enable checkbox was checked by default.
1011    OPT_OUT = 1;
1012
1013    // Policy mandated that UMA be enabled, the user had no choice.
1014    POLICY_FORCED_ENABLED = 2;
1015
1016    // The client has no record of which consent flow was used.
1017    OPT_UNKNOWN = 3;
1018  }
1019
1020  optional UmaDefaultState uma_default_state = 22;
1021
1022  enum AntiVirusState {
1023    // The security product software is turned on and protecting the user.
1024    STATE_ON = 0;
1025
1026    // The security product software is turned off and protection is disabled.
1027    STATE_OFF = 1;
1028
1029    // The security product software is in the snoozed state, temporarily off,
1030    // and not actively protecting the computer.
1031    STATE_SNOOZED = 2;
1032
1033    // The security product software has expired and is no longer actively
1034    // protecting the computer.
1035    STATE_EXPIRED = 3;
1036  }
1037
1038  // Information about installed antivirus products. Windows only. See
1039  // https://cs.chromium.org/chromium/src/chrome/browser/metrics/antivirus_metrics_provider_win.cc.
1040  //
1041  // Next Tag: 6
1042  message AntiVirusProduct {
1043    // The product name e.g. "System Center Endpoint Protection". This might not
1044    // be recorded, see ShouldReportFullNames() in
1045    // chrome/browser/metrics/antivirus_metrics_provider_win.cc.
1046    optional string product_name = 1;
1047
1048    // The hash of the product name.
1049    optional fixed32 product_name_hash = 2;
1050
1051    // The version of the product, as read from the file information. This might
1052    // not be recorded, see ShouldReportFullNames() in
1053    // chrome/browser/metrics/antivirus_metrics_provider_win.cc.
1054    optional string product_version = 3;
1055
1056    // The hash of the product version. Might not be set if the product version
1057    // could not be obtained from the disk.
1058    optional fixed32 product_version_hash = 4;
1059
1060    // The current state of the product.
1061    optional AntiVirusState product_state = 5;
1062  }
1063
1064  repeated AntiVirusProduct antivirus_product = 23;
1065
1066  enum ComponentId {
1067    // The client transmitted a component ID the server does not recognize.
1068    UNKNOWN = 1;
1069
1070    // All the following are various components.
1071    FILE_TYPE_POLICIES = 2;
1072    ORIGIN_TRIALS = 3;
1073    PEPPER_FLASH = 4;
1074    PEPPER_FLASH_CHROMEOS = 5;
1075    PNACL = 6;
1076    RECOVERY = 7;
1077    SSL_ERROR_ASSISTANT = 8;
1078    STH_SET = 9;
1079    CRL_SET = 10;
1080    SUBRESOURCE_FILTER = 11;
1081    SW_REPORTER = 12;
1082
1083    // Software Decryption CDM on all platforms of Chrome
1084    WIDEVINE_CDM = 13;
1085    EPSON_INKJET_PRINTER_ESCPR = 14;
1086    CROS_TERMINA = 15;
1087    STAR_CUPS_DRIVER = 16;
1088    SPEECH_SYNTHESIS_SV_SE = 17;
1089    OPTIMIZATION_HINTS = 18;
1090    DOWNLOADABLE_STRINGS = 19;
1091    VR_ASSETS = 20;
1092    RTANALYTICS_LIGHT = 21;
1093    RTANALYTICS_FULL = 22;
1094    CELLULAR = 23;
1095    DEMO_MODE_RESOURCES = 24;
1096    ON_DEVICE_HEAD_SUGGEST = 25;
1097    CROS_SMART_DIM = 26;
1098    ZXCVBN_DATA = 27;
1099    AUTOFILL_REGEX_CONSTANTS = 28;
1100
1101    // Removed in cl/643485319:
1102    reserved 29;
1103
1104    reserved "WEBVIEW_APPS_PACKAGE_NAMES_ALLOWLIST";
1105
1106    // Hardware Decryption CDM only for Chrome on Windows.
1107    MEDIA_FOUNDATION_WIDEVINE_CDM = 30;
1108    CROWD_DENY = 31;
1109    APP_PROVISIONING = 32;
1110    AUTOFILL_STATES = 33;
1111    CLIENT_SIDE_PHISHING = 34;
1112    COMMERCE_HEURISTICS = 35;
1113    CROW_DOMAIN_LIST = 36;
1114    DEMO_MODE_APP = 37;
1115    DESKTOP_SCREENSHOT_EDITOR = 38;
1116    DESKTOP_SHARING_HUB = 39;
1117    FIRST_PARTY_SETS = 40;
1118    HYPHENATION = 41;
1119    INTERVENTION_POLICY_DATABASE = 42;
1120    LACROS_DOGFOOD_BETA = 43;
1121    LACROS_DOGFOOD_CANARY = 44;
1122    LACROS_DOGFOOD_DEV = 45;
1123    LACROS_DOGFOOD_STABLE = 46;
1124    MEI_PRELOAD = 47;
1125    PKI_METADATA = 48;
1126    REAL_TIME_URL_CHECKS_ALLOWLIST = 49;
1127    RECOVERY_IMPROVED = 50;
1128    SAFETY_TIPS = 51;
1129    SCREEN_AI = 52;
1130    SMART_DIM = 53;
1131    SODA = 54;
1132    SODA_DE_DE = 55;
1133    SODA_EN_US = 56;
1134    SODA_ES_ES = 57;
1135    SODA_FR_FR = 58;
1136    SODA_IT_IT = 59;
1137    SODA_JA_JP = 60;
1138    THIRD_PARTY_MODULE_LIST = 61;
1139    TRUST_TOKEN_KEY_COMMITMENTS = 62;
1140    THIRD_PARTY_COOKIE_DEPRECATION_METADATA = 63;
1141    GROWTH_CAMPAIGNS = 64;
1142    MASKED_DOMAIN_LIST = 65;
1143  }
1144
1145  // Information about what Chrome components are registered and at which
1146  // version.
1147  // Next Tag: 5
1148  message ChromeComponent {
1149    // Which component this information is for.
1150    optional ComponentId component_id = 1 [default = UNKNOWN];
1151
1152    // Human-readable dotted-quad representation of the currently-installed
1153    // version of the component, e.g. "1.2.3.4".
1154    optional string version = 2;
1155
1156    // The first 32 bits of the Omaha-style fingerprint of the installed
1157    // component, discarding any bits that describe the fingerprint format. In
1158    // practice this is the first 32 bits of the SHA256 hash of the package that
1159    // was installed as the component. It is a stronger version number that can
1160    // vary across platform, architecture, or branches of an A/B component test.
1161    optional fixed32 omaha_fingerprint = 3;
1162
1163    // A hash of the cohort identifier of this component, excluding
1164    // non-assignment information. The hash function is Chromium's
1165    // PersistentHash.
1166    optional fixed32 cohort_hash = 4;
1167  }
1168
1169  repeated ChromeComponent chrome_component = 24;
1170
1171  // Information about the user's installed extensions. This will include
1172  // extensions from all fully-initialized profiles. If a single extension is
1173  // installed in multiple profiles, it will be recorded multiple times.
1174  repeated ExtensionInstallProto extension_install = 25;
1175
1176  // Android-only.
1177  // For Chrome UMA records, this field contains the package name of the
1178  // version of Chrome that is running if it's different from
1179  // "com.android.chrome".  ("com.android.chrome" is the name of the Chrome
1180  // stable channel app package name.)
1181  // For WebView UMA records, under some conditions this field contains the
1182  // package name of the currently-running app.  See http://shortn/_5HRGU153JL
1183  // for details.
1184  optional string app_package_name = 26;
1185
1186  // Indicates if the `app_package_name` should be filtered out on the
1187  // server-side. The client will use this to signal no further filtering is
1188  // required if filtering is enabled on the client-side. If the package name is
1189  // a system app and the server-side filtering is enabled, the client will use
1190  // this to indicate no filtering is required since system apps are not subject
1191  // to filtering. Only recorded on the Android WebView platform.
1192  enum AppPackageNameAllowlistFilter {
1193    // Indicates the package name filtering was not set.
1194    // This will be the case with data coming from old WebView versions.
1195    SERVER_SIDE_FILTER_UNSPECIFIED = 0;
1196
1197    // Indicates the package name filtering should occur on the server-side
1198    SERVER_SIDE_FILTER_REQUIRED = 1;
1199
1200    // Indicates the `app_package_name` does not need filtering since it is
1201    // a system app.
1202    NO_SERVER_SIDE_FILTER_REQUIRED_FOR_SYSTEM_APPS = 3;
1203
1204    // Removed in cl/567086405:
1205    reserved 2;
1206
1207    reserved "NO_SERVER_SIDE_FILTER_REQUIRED_DUE_TO_CLIENT_FILTERING";
1208  }
1209
1210  optional AppPackageNameAllowlistFilter app_package_name_allowlist_filter = 42;
1211
1212  enum ClientSideSamplingStatus {
1213    // Default value, no conclusion can be drawn.
1214    SAMPLING_UNKNOWN = 0;
1215
1216    // Client-side sampling was applied.
1217    SAMPLING_APPLIED = 1;
1218
1219    // Client-side sampling was not applied.
1220    SAMPLING_NOT_APPLIED = 2;
1221  }
1222
1223  // Specifies whether sampling was applied on the client. Older clients will
1224  // not set this field, which will result in the default value of UNKNOWN.
1225  optional ClientSideSamplingStatus client_side_sampling_status = 43;
1226
1227  enum MetricsFilteringStatus {
1228    // Not expected to be reported explicitly, used when the field was not set.
1229    METRICS_UNKNOWN = 0;
1230
1231    // Client is reporting all recorded histograms and user actions.
1232    METRICS_ALL = 1;
1233
1234    // Client is reporting only a chosen set of histogrms and user actions.
1235    // The semantics of METRICS_ONLY_CRITICAL may vary by platform and evolve
1236    // over time.
1237    METRICS_ONLY_CRITICAL = 2;
1238  }
1239
1240  // Specifies whether metrics filtering was applied on the client. Metrics
1241  // filtering applies to both histograms and user actions. The chosen metrics
1242  // to filter may vary by platform and evolve over time. Older clients will not
1243  // set this field, which will result in the default value of METRICS_UNKNOWN.
1244  optional MetricsFilteringStatus metrics_filtering_status = 44;
1245
1246  // The package which installed Chrome, as reported by
1247  // PackageManager.getInstallerPackageName().
1248  enum InstallerPackage {
1249    // This field was not set.
1250    INSTALLER_PACKAGE_UNKNOWN = 0;
1251
1252    // The installer package name returned by Android was empty.
1253    INSTALLER_PACKAGE_NONE = 1;
1254
1255    // 'com.android.vending'.
1256    INSTALLER_PACKAGE_GOOGLE_PLAY_STORE = 2;
1257
1258    // Any other non-empty value.
1259    INSTALLER_PACKAGE_OTHER = 3;
1260  }
1261
1262  // The package which installed Chrome, as reported by Android.
1263  optional InstallerPackage installer_package = 35;
1264
1265  // Data related to the "Better Together" multi-device features. This is only
1266  // uploaded on Chrome OS.
1267  // Next Tag: 5
1268  message LinkedAndroidPhoneData {
1269    // The pii-free model name of the phone used for Better Together with this
1270    // device. Will not be set if Better Together is not set up. Hashed using
1271    // variations::HashName() to produce a 32-bit SHA1 hash.
1272    optional fixed32 phone_model_name_hash = 1;
1273
1274    // True if SmartLock is enabled on this Chromebook.
1275    optional bool is_smartlock_enabled = 2;
1276
1277    // True if Instant Tethering is enabled on this Chromebook.
1278    optional bool is_instant_tethering_enabled = 3;
1279
1280    // True if Messages integration is enabled on this Chromebook.
1281    // Deprecated 10/23.
1282    optional bool is_messages_enabled = 4 [deprecated = true];
1283  }
1284
1285  optional LinkedAndroidPhoneData linked_android_phone_data = 29;
1286
1287  // Demo mode related dimension information.
1288  // Next Tag: 6
1289  message DemoModeDimensions {
1290    optional string country = 1;
1291
1292    // Demo devices retailer id and store id, value is set during demo setup.
1293    // Next Tag: 3
1294    message Retailer {
1295      optional string retailer_id = 1;
1296
1297      optional string store_id = 2;
1298    }
1299
1300    optional Retailer retailer = 2;
1301
1302    enum CustomizationFacet {
1303      UNDEFINED = 0;
1304      CLOUD_GAMING_DEVICE = 1;
1305      FEATURE_AWARE_DEVICE = 2;
1306    }
1307
1308    repeated CustomizationFacet customization_facet = 3 [packed = true];
1309
1310    // The Demo Mode highlights app version. The version number is used to
1311    // identify the Omaha Chrome Component - Demo Mode App package that was
1312    // downloaded onto the device.
1313    optional string app_version = 4;
1314
1315    // The Demo Mode resources version. The version number is used to identify
1316    // the Omaha Chrome Component - Demo Mode Resources bundle that was
1317    // downloaded onto the device.
1318    optional string resources_version = 5;
1319  }
1320
1321  optional DemoModeDimensions demo_mode_dimensions = 41;
1322
1323  // LTSChannel indicates whether ChromeOS is running an lts channel.
1324  // https://chromium.googlesource.com/chromiumos/docs/+/HEAD/releases.md#channels
1325  enum LTSChannel {
1326    // This field was not set.
1327    LTS_CHANNEL_UNKNOWN = 0;
1328
1329    // ChromeOS is running stable-channel and not lts.
1330    LTS_CHANNEL_STABLE = 1;
1331
1332    // ChromeOS is running ltc-channel.
1333    LTS_CHANNEL_LTC = 2;
1334
1335    // ChromeOS is running lts-channel.
1336    LTS_CHANNEL_LTS = 3;
1337  }
1338
1339  // Report whether ChromeOS is running ltc or lts channel.
1340  // Instead of extending the Channel enum, we report stable-channel and use
1341  // this separate field to filter out for ltc or lts. Most UMA users are not
1342  // aware of the existence of lts and we would lose monitoring for many Chrome
1343  // features.
1344  optional LTSChannel lts_channel = 45;
1345
1346  // Metrics for Windows device's Trusted Platform Module (TPM).
1347  // This field is only filled in on Windows devices. The string values are
1348  // only be reported on the Canary channel. On other channels, the hashes
1349  // are reported and matched with their Canary equivalent.
1350  message TpmIdentifier {
1351    // The ID used to identify the manufacturer of the TPM. It is matched
1352    // against the list of trusted manufacturers reported by the Trusted
1353    // Computing Group.
1354    optional fixed32 manufacturer_id = 1;
1355
1356    // The hardware version is used to identify the physical TPM chip provided
1357    // by the manufacturer. The meaning of the value that appears in this field
1358    // depends on the manufacturer.  This might not be recorded, see
1359    // ShouldReportFullNames() in
1360    // chrome/browser/metrics/tpm_metrics_provider_win.cc.
1361    optional string manufacturer_version = 2;
1362
1363    // Hash value of the manufacturer_version value.
1364    optional fixed32 manufacturer_version_hash = 3;
1365
1366    // Information regarding the type of TPM on the machine, such as if the
1367    // chip is a virtual TPM or a physical one. This information is provided by
1368    // the Windows Operating System, not the manufacturer and can be used
1369    // independently. This might not be recorded, see ShouldReportFullNames() in
1370    // chrome/browser/metrics/tpm_metrics_provider_win.cc.
1371    optional string manufacturer_version_info = 4;
1372
1373    // Hash value of the manufacturer_version_info value.
1374    optional fixed32 manufacturer_version_info_hash = 5;
1375
1376    // The TPM software specification version (2.0 or 1.2) and sub version. The
1377    // meaning of the value that appears in this field is dependent on the
1378    // manufacturer. This might not be recorded, see ShouldReportFullNames() in
1379    // chrome/browser/metrics/tpm_metrics_provider_win.cc.
1380    optional string tpm_specific_version = 6;
1381
1382    // Hash value of the tpm_specific_version_hash value.
1383    optional fixed32 tpm_specific_version_hash = 7;
1384  }
1385
1386  // Identifying information of Trusted Platform Module on the device. This
1387  // field is only filled in on Windows devices.
1388  optional TpmIdentifier tpm_identifier = 47;
1389}
1390