כשתוסף Google Workspace שפורסם מחזיר הודעת שגיאה, הממשק של התוסף מחזיר את ההודעה הכללית "משהו השתבש בהפעלת התוסף". עם זאת, השגיאות האלה מתועדות ב-Cloud Logs Explorer.
במדריך הזה נסביר איך להריץ שאילתות ביומני השגיאות של התוספים ב-Cloud Logs Explorer, כדי שתוכלו:
- לבדוק אם המשתמשים נתקלים בשגיאות.
- לראות באיזו תדירות מתרחשות שגיאות ואילו שגיאות הן הנפוצות ביותר.
- קריאת הודעות שגיאה תיאוריות שיעזרו לכם לתקן אותן.
דרישות מוקדמות
לפני ששולחים שאילתה לגבי יומני השגיאות של התוספים:
- מפעילים את Cloud Logging API בפרויקט Google Cloud של התוסף. כדי להפעיל API, אפשר לעיין במאמר יצירת פרויקט ב-Cloud והפעלת ה-API.
- מפרסמים את התוסף ב-Google Workspace Marketplace. במאמר פרסום אפליקציה מוסבר איך מפרסמים תוסף ב-Marketplace.
שליחת שאילתות ליומני השגיאות של התוספים
כדי לקבל יומנים של תוסף:
- פותחים את מסוף Google Cloud.
- לצד 'Google Cloud Platform', לוחצים על החץ למטה ובוחרים את הפרויקט של התוסף.
- בפינה הימנית העליונה, לוחצים על סמל התפריט > רישום ביומן. Logs Explorer ייפתח.
כדי להציג יומני שגיאות של תוספים, מזינים את השאילתה הבאה ב-Query builder:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"
כדי לראות את השגיאות האחרונות, לוחצים על Run query. לחלופין, כדי לראות את השגיאות בזמן שהן מתרחשות, לוחצים על Stream logs. יומני השגיאות של התוספים מופיעים בחלונית 'תוצאות השאילתה'.
מידע נוסף על Cloud Logs Explorer ועל כתיבת שאילתות זמין במאמרים הבאים:
הפעלה או השבתה של רישום שגיאות ביומן
כברירת מחדל, רישום שגיאות ביומן מופעל. כשמפעילים את הרישום ביומן של שגיאות, קובץ המניפסט כולל את הפרטים הבאים:
"exceptionLogging": "STACKDRIVER",
כדי להשבית את הרישום ביומן של שגיאות, מחליפים את "exceptionLogging": "STACKDRIVER",
בשורה הבאה בקובץ המניפסט:
// Disable error logging
"exceptionLogging": "NONE"
כדי להפעיל מחדש את הרישום ביומן של שגיאות, מחליפים את "exceptionLogging": "NONE"
ב-"exceptionLogging": "STACKDRIVER",
.
לתשומת ליבכם
כשעובדים עם יומני השגיאות של התוספים ב-Cloud Logs Explorer, חשוב לשים לב לנקודות הבאות:
- תוספים מתעדים שגיאות ביומן ב-Logs Explorer בלבד. סוגי יומנים אחרים לא מתועדים.
- הודעות השגיאה תמיד כתובות באנגלית.
- השימוש ב-Cloud Logging כרוך בעלות. למידע נוסף על התמחור של Cloud Logging, ראו תמחור של Google Cloud Observability.