收集 ChromeOS 设备调试日志

本文适用于管理 ChromeOS 设备的 IT 管理员。

如果您受管理的 ChromeOS 设备出现问题，您可以使用网络日志和日志分析器排查问题。您可以收集日志，让日志分析器工具进行检查，然后查看结果以解决问题。如果您需要联系支持团队解决相关问题，这些日志也非常有用。

收集网络日志

日志位于 /var/log 目录中，您可以在浏览器地址栏中输入 file:///var/log 访问这些日志。要详细了解如何将 /var/log 及其所有子目录的内容导出到压缩的 .tgz 文件中，请参阅如何收集 ChromeOS 设备日志。

利用日志分析器检查日志

日志分析器可用于检查托管 ChromeOS 设备的日志。

要利用日志分析器检查 ChromeOS 设备调试日志，请执行以下操作：

1. 转到日志分析器。
2. 根据需要，执行以下操作：
   • 将调试日志的内容粘贴到框中。
   • 上传日志文件。
3. 在日志源下拉列表中，选择 Chrome 操作系统设备日志。
4. 点击分析。

分析完成后，日志分析器会显示没有报告结果，或者显示对日志的分析结果及相关说明。在某些情况下，分析结果可能包含指向其他内容的链接，供您了解详情。

提示：日志涵盖设备整个使用寿命期间的信息，因此请尽量确定问题发生的时间，以便更轻松地在分析结果中搜索出所需信息。

• 如果日志分析器输出结果中显示 ieee80211_reasoncode，请查看第三方网站（如 Cisco® 支持社区），详细了解这些代码的含义。
• 如果注册失败，日志中通常会显示设备管理服务器请求代码。有关服务器错误代码的详细信息，请参阅设备管理错误。

以人工方式解读日志

以人工方式解读日志是最后不得已的做法。请优先使用日志分析器排查问题。如果您决定自行检查设备日志，请参阅以下指导信息。

调试日志文件结构

文件	说明
file:///var/log/bios_info.txt	设备的硬件 ID 和型号位于文件的顶部，大致如下所示： vendor | coreboot version | Google_Stout.2817.52.0 release_date | 02/13/2013 size | 1024 KB ro bios version | Google_Stout.2817.52.0 Boot switch status: Recovery button: released Developer mode: not enabled RO firmware: protected Boot reason (0): normal Boot firmware: A Active EC code: RW
file:///var/log/boot.log	包含启动过程相关信息。
file:///var/log/eventlog.txt	显示系统活动，如设备开启或关闭的时间。
file:///var/log/messages	包含发送到和发自内核的消息。
file:///var/log/net.log	这些日志有助于排查设备无法连接到正确网络或完全没有网络连接的问题，其功能包括： 可让您搜索 :ERROR:，或者某个事件发生前几分钟的信息。 显示时间戳，格式为：yyyy-mm-ddThh:mm:ss。 net.log 示例 以下几行记录显示设备找到了可用的 2.4 GHz 和 5 GHz 无线网络： 2014-04-02T12:12:27.407032-04:00 localhost wpa_supplicant[881]: mlan0: freq=2437 MHz 2014-04-02T12:15:02.342071-04:00 localhost wpa_supplicant[815]: mlan0: freq=5220 MHz 日志的后半部分还提供了关于可用连接的强度的信息，包括接入点的 MAC 地址、信号频率、噪声和信号级别，以及信号噪声比： 6c:f3:7f:41:3d:50 freq=2412 qual=0 noise=-89* level=-61 snr=28 flags=0xb 6c:f3:7f:41:3d:51 freq=2412 qual=0 noise=-89* level=-62 snr=27 flags=0xb 6c:f3:7f:41:3d:59 freq=5220 qual=0 noise=-92* level=-70 snr=22 flags=0xb 6c:f3:7f:41:3d:58 freq=5220 qual=0 noise=-92* level=-71 snr=21 flags=0xb 日志会按照系统偏好的顺序列出可用网络。当设备没有连接到预期网络时，此日志就非常有用。 ChromeOS 设备会尝试选择符合特定条件的最佳可用网络。在此示例中，设备连接的是 2.4 GHz 网络，而非 5 GHz 网络。日志显示 ChromeOS 设备根据信号噪声比（28/27 和 22/21），给予 2.4 GHz 网络更高的评分，因此选择连接到此网络。
file:///var/log/secure	包含沙盒的相关信息。
file:///var/log/tlsdate.log	显示为了更新系统而检查日期的事件序列。
file:///var/log/update_engine.log	这些日志适用于排查设备无法更新的问题。日志会显示设备和 omahaproxy 之间关于更新的通讯信息，包括服务器的回复。
file:///var/log/chrome/Crash Reports	此文件夹包含 Chrome 崩溃的相关信息，解读起来可能比较困难。请参阅排查 Chrome 崩溃问题了解详情。您可以转到 chrome://crashes，以查找崩溃报告信息。/Chrome 文件夹中的最新文件名称为 chrome，其他较旧的文件都标注有时间戳。 时间戳格式：时间戳提供一些关于操作系统和浏览器呈现的概要信息。
file:///var/log/metrics	包含日志指标（以简单的 key = value 格式显示），可帮助您轻松进行分析。
file:///var/log/power_manager	包含电源管理器执行的操作的相关信息。
file:///var/log/ui	包含关于用户界面或图形的问题记录。
file:///var/log/update_engine	Chrome 会将较旧的更新日志文件移至此文件夹。最新的更新日志名称为 /update_engine.log。
file:///var/log/xorg	包含硬件和系统信息。

在管理控制台中收集其他设备日志

如果您在使用受管理的 ChromeOS 设备时遇到问题，可以通过 Google 管理控制台中的设备详细信息页面获取其他日志，以便排查问题。如需了解详情，请参阅针对 ChromeOS 设备的远程日志收集。