使用 Google Workspace Migration for Microsoft Outlook (GWMMO) 執行遷移作業時，系統會建立追蹤檔案，記錄遷移作業的每個步驟。如果在匯入期間發生任何錯誤，追蹤記錄檔可以找出錯誤發生的位置。這項資訊通常對 Google 支援團隊最有用。舉例來說，如果記錄訊息指出特定遷移模組發生錯誤，Google 工程師就能解決問題。
記錄訊息也能找出環境中需要解決的問題，例如逾時或網路錯誤。如果收到遷移錯誤，請先檢查追蹤記錄檔，確認自有環境是否有問題。
找出追蹤記錄檔
追蹤檔位於電腦中的以下路徑：
- Microsoft Windows 7 以上版本 - C:\Users\<您的使用者名稱>\AppData\Local\Google\Google Apps Migration\Tracing\ClientMigration。
- 舊版 Windows - C:\Documents and Settings\<您的使用者名稱>\Local Settings\Application Data\Google\Google Apps Migration\Tracing\ClientMigration。
系統會建立追蹤檔案，並根據對應遷移作業完成的日期和時間，以及程序 ID 命名。例如，檔案名稱為...
Trace-2020-05-03-11-33-17-p732.log
這代表該檔案的建立時間為 2020 年 5 月 3 日上午 11:33:17，程序 ID 為 732。
解讀追蹤記錄檔
每個追蹤檔都會隨著遷移作業的進展而更新資訊。檔案開頭的項目會指出 ClientMigration.exe 檔案的位置和版本、遷移產品正式版、電腦作業系統，以及這項特定遷移作業的程序資訊：
Configuration: Exe name: C:\Program Files\Google\Google Apps Migration\ClientMigration.exe
Exe version: 1.0.0.1
Product version: 1.0.0.1
OS Version: 5.1.2600
OS Service Pack: 3.0
OS Suite/Product: 256/1
Process Id: 732
Process architecture: x64
後續項目會提供遷移程序各步驟的具體資訊。舉例來說，如果某個項目為：
2020-05-03T11:45:22.668-07:00 de4 A:Migration ClientMigration!ConfigOptionsDialog::TraceMigrationConfig @ 269 ()> Creating a new migration GUID :
這代表該項目回報以下資訊：
- 2020-05-03T11:45:22.668-07:00：寫入項目的日期和時間
- de4：執行緒 ID
A：記錄層級 (A：全部、I：資訊、E：錯誤、F：嚴重、W：警告、V：詳細)
「全部」、「錯誤」、「嚴重錯誤」和「警告」為硬式編碼，使用者無法進行變更。
Migration：模組名稱 (例如 Migration、Generic、Sync、Calendar)
ConfigOptionsDialog：類別名稱
TraceMigrationConfig：方法名稱
@ 269：行號
> following text：記錄訊息 (例如「Creating a new migration GUID」)
排解常見問題
檢查記錄
如果發生網路錯誤 (例如網路逾時、連線遭拒等) 或 SSL/TLS 問題 (例如安全連線問題)，記錄會顯示工具嘗試連線的 IP 位址。如果發生安全連線問題，記錄會顯示原因 (例如憑證名稱不符、憑證過期、CRL 檢查失敗等) 和憑證詳細資料 (例如 Google 憑證或 HTTPS 檢查 Proxy)。有了這些記錄，應該就能大幅減少需要取得網路擷取資料來排解問題的情況。無論是主要記錄 (Trace-*.log) 還是授權記錄 (位於「Identity」資料夾) 都很有參考價值。
授權記錄範例
[2022-09-21T03:59:46:ERROR:windows_http.cc(331)] TLS connection failure. See details below. [Status: 0x00010000. Status Info: 0x00000001]
[2022-09-21T03:59:46:ERROR:windows_http.cc(340)] Certificate details:
---Validity--
Valid from: 2017-09-13 17:23:55 UTC
Valid until: 2017-12-06 17:10:00 UTC
---Subject---
US
California
Mountain View
Google Inc
*.googleapis.com
---Issuer----
US
Google Inc
Google Internet Authority G2
-------------
[2022-09-21T03:59:46:ERROR:windows_http.cc(282)] WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED: Certification revocation checking has been enabled, but the revocation check failed to verify whether a certificate has been revoked. The server used to check for revocation might be unreachable.
[2022-09-21T03:59:46:ERROR:windows_http.cc(197)] Error from API WinHttpSendRequest with WinHTTP proxy. Will try direct (without proxy). Code: 0x00002f8f
[2022-09-21T03:59:46:ERROR:windows_http.cc(107)] Network connection destination details: 216.58.194.170:443 (sfo07s13-in-f170.1e100.net)
上例顯示，由於電腦上當前日期的年份已變更為 2022 年，導致系統誤以為憑證已經過期。您可以在每行記錄的開頭找到當前日期，並發現該日期晚於憑證的「Valid from」和「Valid until」日期。出現 WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED 錯誤標記則代表系統未能檢查憑證撤銷情況。
在最後一行記錄的「Network connection destination details」後方，您也可以找到目的地 IP 位址和經過解析的主機名稱。這個 1e100.net address 即代表 Google。
追蹤記錄範例
注意：這個記錄範例來自 GWMMO。當 GWMME、Password Sync 或 GWSMO 發生網路/TLS 問題時，也會出現類似的追蹤記錄項目。
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2025 ()> Secure connection failure. Status: 0x00010000. Info 0x00000009
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2030 ()> Failure details:
WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED: Certification revocation checking has been enabled, but the revocation check failed to verify whether a certificate has been revoked. The server used to check for revocation might be unreachable.
WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA: The function is unfamiliar with the Certificate Authority that generated the server's certificate.
Certificate details:
---Validity--
Valid from: 2016-09-20T04:08:45.000Z
Valid until: 2022-09-20T04:08:45.000Z
---Subject---
Created by http://www.fiddler2.com
DO_NOT_TRUST
*.google.com
---Issuer----
Created by http://www.fiddler2.com
DO_NOT_TRUST
DO_NOT_TRUST_FiddlerRoot
-------------
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2071 ()> Error result 5, hr = 0x80072f8f. Setting event 0000000000001638.
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2076 ()> Network connection destination details: 127.0.0.1:8888 (COMPUTERNAME)
上例顯示使用者已安裝 Fiddler 並設定使用這項工具來執行 HTTPS 解密作業 (這表示 Fiddler 使用的是自身的憑證)，但是因為相關憑證已從 Windows 的信任憑證清單中移除，所以 Fiddler 處於不受信任的狀態。請注意，由於 Fiddler 是 Proxy，因此會連線至 127.0.0.1，而非 Google。錯誤標記包括 WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA，表示系統不信任憑證授權單位 (CA). 。另請注意，Google 並未核發這項憑證。
Google、Google Workspace 和其他相關符號及標誌均為 Google LLC 的商標。所有其他公司名稱和產品名稱則為相關公司的商標。