Lorsque vous exécutez une migration avec Google Workspace Migration for Microsoft Outlook (GWMMO), un fichier de trace est créé pour consigner chaque étape de la migration. Si vous rencontrez des erreurs lors de l'importation, le fichier de trace peut identifier l'endroit où l'erreur s'est produite. Ces informations sont généralement très précieuses pour l'assistance Google. Par exemple, si un message de journal indique une erreur avec un module de migration particulier, les ingénieurs Google peuvent résoudre le problème.
Les messages de journal peuvent également identifier les problèmes à résoudre dans votre propre environnement, tels que les délais d'expiration ou les erreurs réseau. Si vous recevez une erreur de migration, commencez par vérifier le fichier de trace pour détecter d'éventuels problèmes dans votre propre environnement.
Localiser vos fichiers de suivi
Les fichiers de suivi se trouvent sur votre ordinateur aux emplacements suivants :
- Microsoft Windows 7 et versions ultérieures : C:\Users\nom-utilisateur\AppData\Local\Google\Google Apps Migration\Tracing\ClientMigration.
- Versions antérieures de Windows : C:\Documents and Settings\nom-utilisateur\Local Settings\Application Data\Google\Google Apps Migration\Tracing\ClientMigration.
Un fichier de trace est créé et nommé en fonction de la date et de l'heure de fin de la migration correspondante, ainsi que d'un identifiant de processus. Par exemple, un fichier nommé…
Trace-2020-05-03-11-33-17-p732.log
… a été créé le 3 mai 2020 à 11h33 et 17 s, avec l'identifiant de processus 732.
Interpréter un fichier journal trace
Chaque fichier de suivi est mis à jour à mesure que la migration progresse. Le fichier commence par des entrées qui identifient l'emplacement et la version du fichier ClientMigration.exe, la version du produit de migration, le système d'exploitation de votre ordinateur et les informations sur le processus de cette migration spécifique :
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
Les entrées suivantes fournissent des informations spécifiques sur chaque étape du processus de migration. Par exemple, cette entrée…
2020-05-03T11:45:22.668-07:00 de4 A:Migration ClientMigration!ConfigOptionsDialog::TraceMigrationConfig @ 269 ()> Creating a new migration GUID :
… fournit les informations suivantes :
- 2020-05-03T11:45:22.668-07:00 : date et heure de l'écriture de l'entrée.
- de4 : ID du thread
A : niveau de journalisation (A : All, I : Information, E : Error, F : Fatal, W : Warning, V : Verbose)
All, Error, Fatal et Warning sont codés en dur.
Migration : nom du module (par exemple, Migration, Generic, Sync, Calendar)
ConfigOptionsDialog : nom du cours
TraceMigrationConfig : nom de la méthode
@ 269 : numéro de ligne
> texte suivant : message de journal (par exemple, "Création d'un GUID de migration")
Résoudre les problèmes courants
Vérifier les journaux
Si vous rencontrez des erreurs réseau (par exemple, un délai d'expiration du réseau, une connexion refusée, etc.) ou des problèmes SSL/TLS (par exemple, un problème de connexion sécurisée), les journaux affichent l'adresse IP à laquelle l'outil a tenté de se connecter. En cas de problème de connexion sécurisée, les journaux indiquent la raison (par exemple, non-concordance du nom du certificat, certificat expiré, échec de la vérification de la liste de révocation de certificats, etc.) et les détails du certificat (par exemple, un certificat Google ou un proxy d'inspection HTTPS). Les captures du réseau ne seront donc plus essentielles pour le dépannage. Cela s'applique à la fois aux journaux principaux (Trace-*.log) et aux journaux d'autorisation (dans le dossier "Identity").
Exemple de journal d'autorisation
[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)
Dans ce cas, l'année de la date actuelle de la machine a été remplacée par 2022, ce qui rend le certificat obsolète. Vous pouvez voir que les dates "Valid from" (Valide à partir du) et "Valid until" (Valide jusqu'au) du certificat ne correspondent pas à la date actuelle se trouvant au début de chaque ligne de journal. L'indicateur d'erreur WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED indique que l'examen pour vérifier si un certificat a été révoqué a échoué.
Vous pouvez également voir l'adresse IP de destination et le nom d'hôte résolu après "Network connection destination details" (Détails de la destination de la connexion réseau) sur la dernière ligne du journal. Il s'agit d'une adresse "1e100.net address", c'est-à-dire Google.
Exemple de journal trace
Remarque : Cet exemple de journal provient de GWMMO. Des entrées de journal trace similaires s'afficheront également dans GWMME, Password Sync ou GWSMO lorsque ces produits rencontreront des problèmes de réseau/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)
Dans ce cas, Fiddler a été installé et configuré pour déchiffrer le HTTPS : en d'autres termes, il utilise son propre certificat. Cependant, ce certificat a été supprimé de la liste des certificats de confiance Windows. Il n'est donc pas approuvé. Notez que, comme Fiddler est un proxy, il se connectait à 127.0.0.1 et non à Google. Les indicateurs d'erreur incluent WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA, ce qui signifie que le système ne fait pas confiance à l'autorité de certification (CA). . Notez également que Google n'a pas émis ce certificat.
Google, Google Workspace et les marques et logos associés sont des marques de Google LLC. Tous les autres noms de sociétés et de produits sont des marques des sociétés auxquelles ils sont associés.