Quando esegui una migrazione con Google Workspace Migration for Microsoft Outlook (GWMMO), viene creato un file di traccia che registra ogni passaggio della migrazione. Se si verificano errori durante l'importazione, il file di traccia può identificare in quale punto del processo si è verificato l'errore. In genere questo tipo di informazioni è particolarmente utile per il team dell'Assistenza Google. Ad esempio, se un messaggio di log indica un errore con un determinato modulo di migrazione, gli ingegneri di Google possono risolvere il problema.
I messaggi di log possono anche identificare i problemi che devono essere risolti nel tuo ambiente, come timeout o errori di rete. Se ricevi un errore di migrazione, controlla innanzitutto il file di traccia per verificare se sono presenti problemi nel tuo ambiente.
Individua i file di log di traccia
I file di traccia si trovano sul computer, nei seguenti percorsi:
- Microsoft Windows 7 e versioni successive: C:\Utenti\nome-utente\AppData\Local\Google\Google Apps Migration\Tracing\ClientMigration.
- Versioni precedenti di Windows: C:\Documents and Settings\nome-utente\Impostazioni locali\Dati applicazioni\Google\Google Apps Migration\Tracing\ClientMigration.
Viene creato un file di traccia denominato in base alla data e all'ora del completamento della migrazione corrispondente, insieme a un ID di processo. Ad esempio, un file con il nome…
Trace-2020-05-03-11-33-17-p732.log
…è stato creato il 3 maggio 2020, alle 11:33:17, con ID di processo 732.
Interpreta un file di log di traccia
Ogni file di traccia viene aggiornato man mano che la migrazione procede. Il file inizia con voci che identificano la posizione e la versione del file ClientMigration.exe, la versione del prodotto di migrazione, il sistema operativo del computer e le informazioni sul processo per questa particolare migrazione:
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
Le voci successive forniscono informazioni specifiche su ogni passaggio del processo di migrazione. Ad esempio, questa voce…
2020-05-03T11:45:22.668-07:00 de4 A:Migration ClientMigration!ConfigOptionsDialog::TraceMigrationConfig @ 269 ()> Creating a new migration GUID :
…riporta le seguenti informazioni:
- 2020-05-03T11:45:22.668-07:00: la data e l'ora in cui è stata scritta la voce
- de4: ID del thread
A: il livello di logging (A:All, I:Information, E:Error, F:Fatal, W:Warning, V:Verbose)
I livelli All (Tutti), Error (Errore), Fatal (Irreversibile) e Warning (Avviso) sono codificati.
Migration: nome del modulo (ad esempio, Migration, Generic, Sync, Calendar)
ConfigOptionsDialog: nome della classe
TraceMigrationConfig: nome del metodo
@ 269: numero di riga
> testo seguente: messaggio di log (ad esempio, Creazione di un nuovo GUID di migrazione)
Risolvere i problemi comuni
Controlla i log
Se si verificano errori di rete (ad esempio, un timeout di rete, una connessione rifiutata e così via) o problemi SSL/TLS (ad esempio, un problema di connessione sicura), i log mostrano l'indirizzo IP a cui lo strumento ha tentato di connettersi. Se si verifica un problema di connessione sicura, i log mostrano il motivo (ad esempio, mancata corrispondenza del nome del certificato, certificato scaduto, controllo CRL non riuscito e così via) e i dettagli del certificato (ad esempio, un certificato Google o un proxy di ispezione HTTPS). In questo modo si dovrebbe ridurre notevolmente la necessità di eseguire acquisizioni di rete per la risoluzione dei problemi. Questo si applica sia ai log principali (Trace-*.log) sia ai log di autorizzazione (nella cartella "Identity").
Esempio di log di autorizzazione
[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)
In questo caso, l'anno specificato nella data corrente del computer è stato cambiato in 2022, per far sì che il certificato risulti non aggiornato. La data corrente è indicata all'inizio di ogni riga del log e le date "Valid from" e "Valid until" del certificato non corrispondono alla data corrente. Il flag di errore WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED indica che il controllo della revoca del certificato non è riuscito.
Puoi anche visualizzare l'indirizzo IP di destinazione e il nome host risolto dopo l'indicazione "Network connection destination details" nell'ultima riga del log. Si tratta di un indirizzo 1e100.net address, ovvero di Google.
Esempio del log di traccia
Nota:questo esempio di log proviene da GWMMO. Voci di log di traccia simili verranno visualizzate anche in GWMME, Sincronizzazione password o GWSMO quando questi prodotti riscontrano problemi di rete/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)
In questo caso, Fiddler è stato installato e impostato in modo da eseguire la decriptazione HTTPS utilizzando il proprio certificato, ma quest'ultimo è stato rimosso dall'elenco dei certificati attendibili di Windows e non è quindi attendibile. Tieni presente che, poiché Fiddler è un proxy, si connetteva a 127.0.0.1 e non a Google. I flag di errore includono WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA, il che significa che il sistema non considera attendibile l'autorità di certificazione (CA). Tieni presente anche che Google non ha emesso questo certificato.
Google, Google Workspace e i marchi e i loghi correlati sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle società a cui sono associati.