Gdy przeprowadzasz migrację za pomocą Google Workspace Migration for Microsoft Outlook (GWMMO), tworzony jest plik śledzenia, który rejestruje każdy krok migracji. Jeśli podczas importowania wystąpią błędy, plik śledzenia może pomóc w ustaleniu, na którym etapie procesu się pojawiły. Te informacje najczęściej przydają się zespołowi pomocy Google. Jeśli na przykład komunikat logu wskazuje błąd w określonym module migracji, inżynierowie Google mogą rozwiązać ten problem.
Komunikaty logu mogą też wskazywać problemy, które należy rozwiązać we własnym środowisku, takie jak przekroczenie limitu czasu lub błędy sieci. Jeśli pojawi się błąd migracji, najpierw sprawdź plik śledzenia pod kątem problemów we własnym środowisku.
Znajdowanie plików logów śledzenia
Pliki śledzenia znajdują się na komputerze w tych miejscach:
- System Microsoft Windows 7 lub nowszy – C:\Users\nazwa-użytkownika\AppData\Local\Google\Google Apps Migration\Tracing\ClientMigration.
- Wcześniejsze wersje systemu Windows – C:\Documents and Settings\nazwa-użytkownika\Local Settings\Application Data\Google\Google Apps Migration\Tracing\ClientMigration.
Plik śledzenia jest tworzony i nazywany zgodnie z datą i godziną zakończenia migracji oraz identyfikatorem procesu. Na przykład plik o nazwie…
Trace-2020-05-03-11-33-17-p732.log
został utworzony 3 maja 2020 r. o godzinie 11:33:17, a identyfikator procesu to 732.
Interpretowanie pliku dziennika śledzenia
Każdy plik śledzenia jest aktualizowany wraz z postępem migracji. Plik zaczyna się od wpisów, które określają lokalizację i wersję pliku ClientMigration.exe, wersję usługi migracji, system operacyjny komputera oraz informacje o procesie tej konkretnej migracji:
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
Kolejne wpisy zawierają szczegółowe informacje o każdym etapie procesu migracji. Na przykład ta pozycja:
2020-05-03T11:45:22.668-07:00 de4 A:Migration ClientMigration!ConfigOptionsDialog::TraceMigrationConfig @ 269 ()> Creating a new migration GUID :
zawiera następujące informacje:
- 2020-05-03T11:45:22.668-07:00: data i godzina utworzenia wpisu.
- de4: identyfikator wątku
A: poziom logowania (A:wszystkie, I:informacje, E:błąd, F:błąd krytyczny, W:ostrzeżenie, V:szczegółowe)
Poziomy All, Error, Fatal i Warning są ustalone z góry.
Migration: nazwa modułu (np. Migration, Generic, Sync, Calendar).
ConfigOptionsDialog: nazwa klasy
TraceMigrationConfig: nazwa metody
@ 269: numer wiersza
> tekst: komunikat logu (np. Tworzenie nowego identyfikatora GUID migracji)
Rozwiązywanie typowych problemów
Sprawdzanie dzienników
Jeśli wystąpią błędy sieci (np. przekroczenie limitu czasu sieci, odmowa połączenia itp.) lub problemy z SSL/TLS (np. problem z bezpiecznym połączeniem), w dziennikach pojawi się adres IP, z którym narzędzie próbowało się połączyć. Jeśli wystąpi problem z bezpiecznym połączeniem, w dziennikach pojawi się jego przyczyna (np. niezgodność nazwy certyfikatu, wygaśnięcie certyfikatu, nieudane sprawdzenie listy odwołanych certyfikatów) oraz szczegóły certyfikatu (np. certyfikat Google lub serwer proxy sprawdzający HTTPS). Powinno to znacznie ograniczyć konieczność przechwytywania ruchu sieciowego do rozwiązywania problemów i dotyczy zarówno dzienników głównych (Trace-*.log), jak i dzienników autoryzacji (w folderze „Identity”).
Przykład dziennika autoryzacji
[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)
W tym przypadku rok w aktualnej dacie komputera został zmieniony na 2022, przez co certyfikat wydaje się nieaktualny. Na początku każdego wiersza dziennika możesz sprawdzić aktualną datę, a daty „Valid from” i „Valid until” certyfikatu nie są zgodne z aktualną datą. Flaga błędu WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED wskazuje, że test odwołania certyfikatu zakończył się niepowodzeniem.
Możesz też sprawdzić docelowy adres IP i nazwę hosta po tekście „Network connection destination details” w ostatnim wierszu dziennika. Jest to adres 1e100.net address, czyli Google.
Przykład logu śledzenia
Uwaga: ten przykładowy dziennik pochodzi z GWMMO. Podobne wpisy w logu śledzenia pojawią się też w GWMME, Password Sync lub GWSMO, gdy w tych usługach wystąpią problemy z siecią lub 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)
W tym przypadku Fiddler został zainstalowany i skonfigurowany do odszyfrowywania HTTPS (co oznacza, że używa własnego certyfikatu), ale jego certyfikat został usunięty z listy zaufanych certyfikatów Windows, więc nie jest on zaufany. Pamiętaj, że Fiddler jest serwerem proxy, więc łączył się z adresem 127.0.0.1, a nie z Google. Flagi błędów obejmują WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA, co oznacza, że system nie ufa urzędowi certyfikacji (CA). . Zwróć też uwagę, że Google nie wystawiło tego certyfikatu.
Google, Google Workspace oraz powiązane znaki i logotypy są znakami towarowymi firmy Google LLC. Wszystkie inne nazwy firm i produktów są znakami towarowymi należącymi do ich właścicieli.