1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
|
# Support Tool
Support Tool is a framework that collects various information and logs from
ChromeOS devices and Chrome browser. The caller can use it to gather the
desired set of logs using
[SupportToolHandler](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/support_tool_handler.h).
See the documentation there on the usage of it.
### Local Usage
Use Support Tool UI on chrome://support-tool to export the log archive to local
storage.
### Remote Log Collection for Enterprise Admins
Admins can trigger log collection on Admin Console to get the logs remotely.
See [here](https://support.google.com/chrome/a?p=remote-log) for more details.
## Available Data on Support Tool
| Name | Description |
|-------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| [ChromeOS Flex Logs](#chromeos-flex-logs) | Collect Hardware data for cloudready devices via cros_healthd calls. |
| [UI Hierarchy](#ui-hierarchy) | Fetches UI component hierarchy for ChromeOS. |
| [Crash IDs](#crash-ids) | Extracts the most recent crash IDs (if any) and exports them into crash_report_ids and all_crash_report_ids files. |
| [Chrome System Information](#chrome-system-information) | Fetches internal Chrome logs. |
| [Intel WiFi NICs Debug Dump](#intel-wifi-nics-debug-dump) | Fetches debug dump information from Intel Wi-Fi NICs that will be produced when those NICs have issues such as firmware crashes for ChromeOS. |
| [ChromeOS Network Routes](#chromeos-network-routes) | Gathers network routing tables for ipv4 and ipv6 |
| [Additional ChromeOS Platform Logs](#additional-chromeos-platform-logs) | Gathers log data from various scripts/programs. Creates and exports data into these files: alsa controls, cras, audio_diagnostics, env, disk_usage. |
| [Touch Events](#touch-events) | Fetches touch events, touchscreen and touchpad logs. |
| [DBus Details](#dbus-details) | Fetches memory usage details of DBus interface. Creates and exports data into these files: dbus_details, dbus_summary. |
| [Device Event](#device-event) | Fetches entries for 'network_event_log' and 'device_event_log'. |
| [Memory Details](#memory-details) | Fetches memory usage details and exports them into mem_usage and mem_usage_with_title files. |
| [Policies](#policies) | Policies applied for device or user for managed users. |
| [ChromeOS Shill (Connection Manager) Logs](#chromeos-shill-connection-manager-logs) | Gathers Device and Service properties from Shill. |
| [ChromeOS System Logs](#chromeos-system-logs) | Gathers the contents of /var/log file. /var/log file contains the log files of various system files e.g. Chrome logs, messages, bluetooth logs etc. |
| [ChromeOS System State and Logs](#chromeos-system-state-and-logs) | Gathers log data from Debug Daemon. Debug daemon collects log from several system files or runs scripts to collect data. |
| [ChromeOS Chrome User Logs](#chromeos-chrome-user-logs) | Gathers logs from user's directory on ChromeOS. Contains Chrome logs, log-in/log-out times and Google Assistant logs |
| [ChromeOS Bluetooth](#chromeos-bluetooth) | Fetches if Bluetooth floss is enabled on the device |
| [ChromeOS Connected Input Devices](#chromeos-connected-input-devices) | Fetches the information about connected input devices to ChromeOS device. |
| [ChromeOS Virtual Keyboard](#chromeos-virtual-keyboard) | Fetches the virtual keyboard details on ChromeOS |
| [ChromeOS Traffic Counters](#chromeos-traffic-counters) | Fetches traffic counters for ChromeOS |
| [ChromeOS Network Health](#chromeos-network-health) | Fetches network health entry. |
| [Performance and Battery Status](#performance-and-battery-status) | Gathers performance relevant data such as battery saving mode on device or the active battery status |
| [Sign In Status](#sign-in-status) | Fetches signin tokens and details (the information on chrome://signin-internals) |
| [ChromeOS App Service](#chromeos-app-service) | Gathers information from app service about installed and running apps |
## Details About Available Data
### ChromeOS Flex Logs
Collect hardware data for ChromeOS Flex devices via cros_healthd calls. What
does the information contain:
- System Info
- Vendor (chromeosflex_product_vendor)
- Product name (chromeosflex_product_name)
- Product version (chromeosflex_product_version)
- Bios name (chromeosflex_bios_version)
- Secure boot enabled (chromeosflex_secureboot)
- UEFI enabled (chromeosflex_uefi)
- Cpu Info
- CPU names under name (chromeosflex_cpu_name)
- Memory Info
- Total memory (chromeosflex_total_memory)
- Free memory (chromeosflex_free_memory)
- Available memory (chromeosflex_available_memory)
- Bus Devices Info
- Ethernet devices
- name (chromeosflex_ethernet_name)
- id (chromeosflex_ethernet_id)
- driver (chromeosflex_ethernet_driver)
- Bluetooth devices
- name (chromeosflex_bluetooth_name)
- id (chromeosflex_bluetooth_id)
- driver (chromeosflex_bluetooth_driver)
- Wireless devices
- name (chromeosflex_wireless_name)
- id (chromeosflex_wireless_id)
- driver (chromeosflex_wireless_driver)
- GPU devices
- name (chromeosflex_gpu_name)
- id (chromeosflex_gpu_id)
- driver (chromeosflex_gpu_driver)
- Tpm Info
- (chromeosflex_tpm_allow_listed)
- (chromeosflex_tpm_did_vid)
- (chromeosflex_tpm_manufacturer)
- (chromeosflex_tpm_owned)
- (chromeosflex_tpm_spec_level)
- (chromeosflex_tpm_version)
- Graphics Info
- chromeosflex_gl_extensions
- chromeosflex_gl_renderer
- chromeosflex_gl_shading_version
- chromeosflex_gl_vendor
- chromeosflex_gl_version
- Touchpad library name
Source code on [RevenLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/reven_log_source.h).
### UI Hierarchy
UI component hierarchy.
- Windows
- Layers
- Views
Source code on [UiHierarchyDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/ash/ui_hierarchy_data_collector.h).
### Crash IDs
- crash_report_ids
- all_crash_report_ids
Source code on [CrashIdsSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/feedback/system_logs/log_sources/crash_ids_source.h).
### Chrome System Information
- All devices: (including Win, Mac):
- Sync logs
- The sync data that can be available in chrome://sync-internals in
JSON format
- Extension info logs
- List in format: `extension_id` : `extension_name` : `extension_version`
- Power API logs
- The extension levels from chrome.power API
- Chrome version
- Enrollment status
- OS version for ChromeOS
- CPU arc for Windows and Mac
- Is skia graphite enabled?
- Is child account?
- ChromeOS:
- Local state settings
- Arc policy status if ARC is enabled
- Onboarding time:
- Time when a new user has finished onboarding.
- Account type
- Demo mode config
- Failed knowledge factor events
- Recorded auth events
- Monitor (display) information
- Disk space:
- Free disk space
- Total disk space
- Windows:
- USB keyboard added
- Enrollment status
- Installer brand
- Last update state
Source code on [ChromeInternalLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/feedback/system_logs/log_sources/chrome_internal_log_source.h).
### Intel WiFi NICs Debug Dump
Retrieves contents of `/var/log/last_iwlwifi_dump` file.
Source code on [IwlWifiDumpLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/iwlwifi_dump_log_source.h).
### ChromeOS Network Routes
Returns the network routes for ipv4 and ipv6 (through debugd).
Source code on [NetworkRoutesDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/ash/network_routes_data_collector.h).
### Additional ChromeOS Platform Logs
- alsa controls
- cras
- audio_diagnostics
- env
- system_files
- disk_usage
Source code on [CommandLineLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/command_line_log_source.h).
### Touch Events
Touch event logs and touch device state logs from [Input controller](https://source.chromium.org/chromium/chromium/src/+/main:ui/ozone/public/input_controller.h).
Source code on [TouchLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/touch_log_source.h).
### DBus Details
DBus call statistics: contains names for DBus methods and paths.
Source code on [DBusLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/dbus_log_source.h).
### Device Event
- `network_event_log`: Network events that occurred on the device.
- `device_event_log`: All other device events.
See UI on chrome://device-log.
Source code on [DeviceEventLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/feedback/system_logs/log_sources/device_event_log_source.h).
### Memory Details
mem_usage: the memory usage of the browser process and its subprocesses.
Source code on [MemoryDetailsLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/feedback/system_logs/log_sources/memory_details_log_source.h).
### Policies
Policies and their values. Contains the policy status and last fetch time. UI
available on chrome://policy.
Source code on [PolicyDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/policy_data_collector.h).
### ChromeOS Shill (Connection Manager) Logs
Gathers network service and device configs and properties.
Source code on [ShillDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/ash/shill_data_collector.h).
### ChromeOS System Logs
Several log files from /var/log/ path through [`debugd`](https://source.chromium.org/chromiumos/chromiumos/codesearch/+/main:src/platform2/debugd/). See [this section](https://docs.google.com/spreadsheets/d/1EX9tmmooY_0xG_4B6eMvqRpFCdQe2lIxi7Tebn4aw6g/edit#rangeid=1443702921) on the spreadsheet for the exact list of files. Note that only the files from /var/log/ will be included from the linked list.
See [`log_tool.cc`](https://source.chromium.org/chromiumos/chromiumos/codesearch/+/main:src/platform2/debugd/src/log_tool.cc) for details.
Source code on [SystemLogsDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/ash/system_logs_data_collector.h).
### ChromeOS System State and Logs
Calls [`debugd`](https://source.chromium.org/chromiumos/chromiumos/codesearch/+/main:src/platform2/debugd/) to run some commands to gather system state and reports. See [this section](https://docs.google.com/spreadsheets/d/1EX9tmmooY_0xG_4B6eMvqRpFCdQe2lIxi7Tebn4aw6g/edit#rangeid=1443702921) on the spreadsheet for the exact list of data. Note that `/var/log/` files from this link are collected under [ChromeOS System Logs](#chromeos-system-logs) and will not be included here.
See [`log_tool.cc`](https://source.chromium.org/chromiumos/chromiumos/codesearch/+/main:src/platform2/debugd/src/log_tool.cc) for details.
Source code on [SystemStateDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/ash/system_state_data_collector.h).
### ChromeOS Chrome User Logs
- Chrome browser logs from user session
- Assistant logs
- Login/logout times
Source code on [ChromeUserLogsDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/ash/chrome_user_logs_data_collector.h).
### ChromeOS Bluetooth
If [Bluetooth Floss](https://sites.google.com/corp/google.com/flossproject/home) is enabled or not.
Source code on [BluetoothDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/bluetooth_log_source.h).
### ChromeOS Connected Input Devices
Connected input device (e.g. touch screen or touchpad) information such as vendor names and versions.
Source code on [ConnectedInputDevicesLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/connected_input_devices_log_source.h).
### ChromeOS Virtual Keyboard
Virtual keyboard related information such as the touch screen type and keyboard name.
Source code on [VirtualKeyboardLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/virtual_keyboard_log_source.h).
### ChromeOS Traffic Counters
Network traffic counters of recent active networks on the device. This information can be used to monitor the amount of traffic on networks.
Source code on [TrafficCountersLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/traffic_counters_log_source.h).
### ChromeOS Network Health
Network health snapshot and network diagnostics routine outputs.
Network health snapshot contains network information such as network name and signal strengths.
Network diagnostics routines are such as following:
- LAN connectivity problems
- signal strength problems
- gateway can be pinged problems
- secure WIFI connection problems
- DNS resolver present problems
- DNS latency problems
- DNS resolution problems
- captive portal problems
- HTTP/HTTPS firewall problems
- HTTPS latency problems
- video conferencing problems
- ARC HTTP problems
- ARC DNS resolution problems
- ARC ping problems
Source code on [NetworkHeathDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/ash/network_health_data_collector.h).
### Performance and Battery Status
- high_efficiency_mode_active
- battery_saver_state
- battery_saver_mode_active
- battery_saver_disabled_for_session
- device_has_battery
- device_using_battery_power
- device_battery_percentage
Source code on [PerformanceLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/feedback/system_logs/log_sources/performance_log_source.h).
### Sign In Status
The sign-in details on the device such as the signin status and the accounts. The fetched data contains the access token details such as scope and the service name.
UI in chrome://signin-internals.
Source code on [SigninDataCollector](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/support_tool/signin_data_collector.h).
### ChromeOS App Service
Gets the list of installed and running apps on the device from Apps Service and writes it on the `app_service` file.
Source code on [AppServiceLogSource](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/ash/system_logs/app_service_log_source.h).
|
