当您使用 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”（创建新的迁移 GUID）
排查常见问题
查看日志
如果您遇到网络连接错误（例如，网络超时、连接遭拒等）或 SSL/TLS 问题（例如，安全连接问题），则日志会显示该工具尝试连接的 IP 地址。如果存在安全连接问题，日志会显示相关原因（例如，证书名称不符、证书过期、CRL 检查失败等）和证书详细信息（例如，Google 证书或 HTTPS 检查代理）。这样应该能显著减少利用网络捕获排查问题的需要，主日志（文件名为 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、密码同步或 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 解密（这表示该工具使用的是自己的证书），但其证书已从 Windows 受信证书列表中移除，因此不受系统信任。请注意，由于 Fiddler 是代理工具，因此会连接到 127.0.0.1 而不是 Google。错误标记包含 WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA，这表示证书授权机构 (CA). 不受系统信任。另请注意，该证书并非由 Google 颁发。
Google、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。