Lorsque vous exécutez une migration avec Google Workspace Migration for Microsoft Outlook (GWMMO), un fichier de suivi est créé pour enregistrer chaque étape de celle-ci. En cas d'erreurs au cours de l'importation, le fichier de suivi peut identifier à quel niveau du processus elles se sont produites. 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 des problèmes devant être résolus dans votre propre environnement, tels que les dépassements de délai ou les erreurs réseau. Si vous rencontrez une erreur de migration, recherchez d'abord dans le fichier de suivi les problèmes liés à votre propre environnement.
Localiser vos fichiers journaux de trace
Les fichiers de trace 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 ID de processus. Par exemple, un fichier portant le nom…
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 de trace
Chaque fichier de suivi est mis à jour à mesure que la migration progresse. Le fichier commence par les entrées identifiant l'emplacement et la version du fichier ClientMigration.exe, la version du produit de migration, le système d'exploitation de votre ordinateur, ainsi que les informations sur le processus de la migration en question :
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 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 d'écriture de l'entrée
- de4 : ID du thread
A : niveau de journalisation (A:All [tous], I:Information, E:Error [erreur], F:Fatal, W:Warning [avertissement], V:Verbose [informations détaillées])
"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 qui suit : message de journal, par exemple : "Creating a new migration GUID" (création d'un GUID de migration)
Résoudre les problèmes courants
Vérifier les journaux
Si vous rencontrez des erreurs réseau (expiration du réseau, connexion refusée, etc.) ou des erreurs SSL/TLS (problème de la connexion sécurisée, par exemple), les journaux affichent l'adresse IP à laquelle l'outil tente de se connecter. En cas de problème de connexion sécurisée, les journaux indiquent la raison (nom du certificat non valide, certificat expiré, échec de la vérification CRL, etc.) et les détails du certificat (certificat Google ou proxy d'inspection de contenu HTTPS, par exemple). 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 apparaissent également dans GWMME, la synchronisation des mots de passe ou GWSMO lorsque ces produits rencontrent des problèmes de réseau ou des erreurs 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 connecte à 127.0.0.1, et non à Google. Les indicateurs d'erreur incluent WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA, ce qui signifie que l'autorité de certification (CA). n'est pas approuvée par le système. Vous remarquerez également que Google n'a pas émis ce certificat.
Google, Google Workspace, ainsi que les marques et logos associés sont des marques appartenant à 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.