使用 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：行號
- > 後面的文字：記錄訊息 (例如：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 的記錄。當 GSMME、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 的商標。所有其他公司名稱和產品名稱則為相關公司的商標。
