כשמפעילים העברה באמצעות 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. כל שמות החברות והמוצרים האחרים הם סימנים מסחריים של החברות שאליהן הם משויכים.