Quando esegui una migrazione con Google Workspace Migration for Microsoft Outlook (GWMMO) Outlook, viene creato un file di traccia che registra ogni passaggio. In caso di errore durante l'importazione, il file di traccia è in grado di identificare il punto del processo in cui si è verificato. In genere questo tipo di informazioni è particolarmente utile per il team dell'Assistenza Google. Ad esempio, se un messaggio di log indica un errore in un determinato modulo della migrazione, i tecnici di Google possono risalire al problema per risolverlo.
I messaggi di log possono inoltre indicare la presenza di problemi che devono essere risolti nel tuo ambiente, ad esempio errori di timeout o di rete. Se viene visualizzato un errore di migrazione, controlla prima se nel file di traccia sono riscontrabili problemi nel tuo ambiente.
Individuare i file dei 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.
Un file di traccia viene creato e denominato in base alla data e all'ora in cui è stata completata la migrazione e all'ID di processo. Ad esempio, un file denominato…
Trace-2020-05-03-11-33-17-p732.log
…è stato creato il 3 maggio 2020, alle 11:33:17, con ID di processo 732.
Interpretare un file di log di traccia
Ogni file di traccia viene aggiornato man mano che la migrazione procede. All'inizio del file sono riportate le voci che ne identificano la posizione nonché la versione del file ClientMigration.exe, la versione del prodotto di migrazione, il sistema operativo del computer e le informazioni sul processo per la migrazione specifica:
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 fase 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: data e ora in cui è stata scritta la voce
- de4: ID del thread
- A: livello di registrazione, A:All (Tutti), I:Information (Informazioni), E:Error (Errore), F:Fatal (Irreversibile), W:Warning (Avviso), V:Verbose (Dettagliato)
I livelli All (Tutti), Error (Errore), Fatal (Irreversibile) e Warning (Avviso) sono codificati.
- Migration: nome del modulo, Ad esempio: Migration, Generic (Generico), Sync (Sincronizzazione), Calendar)
- ConfigOptionsDialog: nome della classe
- TraceMigrationConfig: nome del metodo
- @ 269: numero di riga
- > following text (testo seguente): messaggio di log, ad esempio Creazione nuovo GUID migrazione
Risolvere i problemi comuni
Controllare i logSe si verificano errori di rete (ad esempio timeout, connessioni rifiutate e così via) o problemi di SSL/TLS (ad esempio un problema di connessione protetta), i log mostreranno l'indirizzo IP a cui lo strumento ha tentato di connettersi. Se si verifica un errore di connessione protetta, i log mostreranno il motivo (ad esempio nome del certificato non corrispondente, 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 si riferisce a GWMMO. Voci del log traccia simili a queste vengono visualizzate anche in GSMME, Password Sync o GWSMO quando questi prodotti presentano problemi di rete/TLS.0.
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 stava connettendo 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). Nota anche che Google non ha emesso questo certificato.
Google, Google Workspace e marchi e loghi correlati sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle rispettive società a cui sono associati.