收集 ChromeOS 裝置偵錯記錄檔

本文適用對象為負責管理 ChromeOS 裝置的 IT 管理員。

如果受管理的 ChromeOS 裝置發生問題，您可以使用網路記錄和 Log 分析工具排解問題。只要收集紀錄，並且讓 Log 分析工具進行檢查，即可根據檢查結果解決問題。如需向支援小組洽詢特定問題，記錄也可以派上用場。

收集網路記錄

記錄儲存於 /var/log 目錄，只要在瀏覽器的網址列中輸入 file:///var/log 即可存取記錄。如要進一步瞭解如何將 /var/log 及其所有子目錄的內容匯出成 .tgz 壓縮檔，請參閱如何收集 ChromeOS 裝置的記錄。

使用 Log 分析工具檢查記錄

Log 分析工具這項記錄剖析器可檢查受管理 ChromeOS 裝置上的裝置記錄。

如何使用 Log 分析工具檢查 ChromeOS 裝置偵錯記錄檔：

1. 前往 Log 分析工具。
2. 執行下列其中一項動作：
   • 將偵錯記錄內容貼到方塊中。
   • 上傳紀錄檔。
3. 從紀錄來源下拉式清單中選取 [Chrome 作業系統裝置紀錄]。
4. 點選 [分析]。

分析完畢後，如果並未發現任何特殊情形，Log 分析工具會告知您沒有回報事項。如果有任何問題，則會顯示從紀錄中擷取的相關資訊及說明。在部分情況下，Log 分析工具還會提供相關連結，讓您深入瞭解詳情。

提示：記錄涵蓋裝置的整個生命週期資訊，因此我們建議您確定問題發生的時間，以便輕鬆搜尋相關資訊。

• 如果 Log 分析工具輸出內容中顯示 ieee80211_<reasoncode>，請查詢第三方網站 (例如 Cisco® Support Community)，進一步瞭解這些代碼的意涵。
• 如果註冊失敗，通常記錄中會顯示裝置管理伺服器要求代碼。如要進一步瞭解伺服器錯誤代碼，請參閱裝置管理錯誤。

以人工方式解讀記錄

以人工方式解讀記錄是最不得已的做法，請先使用 Log 分析工具排解問題。如果您決定自行檢查裝置紀錄，請參閱以下指南資訊。

偵錯紀錄檔結構

檔案	說明
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 vs 22/21) 給予 2.4 GHz 網路較高的評分，因此選擇連線至 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 裝置的遠端記錄收集方式」。