כשמריצים העברה באמצעות Google Workspace Migration for Microsoft Outlook (GWMMO), נוצר קובץ מעקב שמתעד כל שלב בהעברה. אם נתקלים בשגיאות במהלך הייבוא, קובץ המעקב יכול לזהות באיזה שלב בתהליך השגיאה התרחשה. המידע הזה בדרך כלל הכי שימושי לתמיכה של Google. לדוגמה, אם הודעה ביומן מציינת שגיאה במודול העברה מסוים, מהנדסי Google יכולים לטפל בבעיה.
הודעות ביומן יכולות גם לזהות בעיות שצריך לפתור בסביבה שלכם, כמו פסק זמן או שגיאות ברשת. אם קיבלתם שגיאה בהעברה, קודם צריך לבדוק את קובץ המעקב כדי לזהות בעיות בסביבה שלכם.
איתור קובצי יומן של פרטי ההעברה
קבצי מעקב ממוקמים במחשב במיקומים הבאים:
- Microsoft Windows 7 ואילך – C:\Users\your-user-name\AppData\Local\Google\Google Apps Migration\Tracing\ClientMigration.
- גרסאות קודמות של Windows – C:\Documents and Settings\your-user-name\Local Settings\Application Data\Google\Google Apps Migration\Tracing\ClientMigration.
קובץ מעקב נוצר ונקרא בהתאם לתאריך ולשעה שבהם ההעברה המתאימה הושלמה, יחד עם מזהה תהליך. לדוגמה, קובץ בשם…
Trace-2020-05-03-11-33-17-p732.log
...נוצר ב-3 במאי 2020 בשעה 11:33:17, עם מזהה תהליך 732.
פענוח של קובץ יומן פרטי ההעברה
כל קובץ מעקב מתעדכן ככל שההעברה מתקדמת. הקובץ מתחיל ברשומות שמזהות את המיקום והגרסה של קובץ ClientMigration.exe, את גרסת מוצר ההעברה, את מערכת ההפעלה של המחשב ואת פרטי התהליך של ההעברה הספציפית הזו:
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
בקטעים הבאים מפורט מידע ספציפי על כל שלב בתהליך ההעברה. לדוגמה, הרשומה הזו…
2020-05-03T11:45:22.668-07:00 de4 A:Migration ClientMigration!ConfigOptionsDialog::TraceMigrationConfig @ 269 ()> Creating a new migration GUID :
... מדווח על הפרטים הבאים:
- 2020-05-03T11:45:22.668-07:00: התאריך והשעה שבהם נכתב הערך
- de4: מזהה השרשור
A: רמת הרישום ביומן (A:All, I:Information, E:Error, F:Fatal, W:Warning, V:Verbose)
הערכים All, Error, Fatal ו-Warning מוצפנים.
Migration: שם המודול (לדוגמה, העברה, כללי, סנכרון, יומן)
ConfigOptionsDialog: שם הכיתה
TraceMigrationConfig: שם השיטה
@ 269: מספר השורה
> הטקסט הבא: הודעת יומן (לדוגמה, יצירת GUID חדש להעברה)
פתרון בעיות נפוצות
בדיקת היומנים
אם יש שגיאות ברשת (לדוגמה, פסק זמן ברשת, החיבור נדחה וכו') או בעיות ב-SSL/TLS (לדוגמה, בעיה בחיבור מאובטח), ביומני הרישום מופיעה כתובת ה-IP שהכלי ניסה להתחבר אליה. אם יש בעיה בחיבור מאובטח, ביומנים מופיעה הסיבה (לדוגמה, חוסר התאמה של שם האישור, תוקף האישור פג, בדיקת ה-CRL נכשלה וכו') ופרטי האישור (לדוגמה, אישור של Google או שרת proxy לבדיקת HTTPS). השינוי הזה אמור לצמצם באופן משמעותי את הצורך בהשגת נתוני תעבורה ברשת לצורך פתרון בעיות, והוא חל גם על היומנים הראשיים (Trace-*.log) וגם על יומני ההרשאות (בתיקייה Identity).
דוגמה ליומן הרשאות
[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)
במקרה הזה, השנה בתאריך הנוכחי של המכונה שונתה ל-2022, ולכן נראה שהאישור לא עדכני. אפשר לראות את התאריך הנוכחי בתחילת כל שורה ביומן, והתאריכים Valid from ו-Valid until של האישור לא תואמים לתאריך הנוכחי. דגל השגיאה WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED מציין שהבדיקה של ביטול האישור נכשלה.
אפשר גם לראות את כתובת ה-IP של היעד ואת שם המארח שנפתר אחרי 'Network connection destination details' בשורה האחרונה של היומן. זהו 1e100.net address, כלומר הוא שייך ל-Google.
דוגמה ליומן מעקב
הערה: דוגמת היומן הזו היא מ-GWMMO. רשומות דומות ביומן המעקב יופיעו גם ב-GWMME, ב-Password Sync או ב-GWSMO אם יהיו בעיות ברשת או ב-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)
במקרה הזה, Fiddler הותקן והוגדר לבצע פענוח של HTTPS (כלומר, הוא משתמש באישור משלו), אבל האישור שלו הוסר מרשימת האישורים המהימנים של Windows, ולכן הוא לא מהימן. שימו לב: מכיוון ש-Fiddler הוא שרת proxy, הוא התחבר ל-127.0.0.1 ולא ל-Google. דגלי השגיאה כוללים את WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA, שמשמעותו היא שהמערכת לא בוטחת ברשות האישורים (CA). שימו לב ש-Google לא הנפיקה את האישור הזה.
Google, Google Workspace וסימנים וסמלי לוגו קשורים הם סימנים מסחריים של Google LLC. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.