כשתוסף שפורסם ל-Google Workspace מחזיר שגיאה, בממשק של התוסף מוצגת הודעה כללית: "משהו השתבש במהלך הפעלת התוסף". עם זאת, השגיאות האלה מתועדות ב-Logs Explorer ב-Cloud.
במדריך הזה מוסבר איך לשלוח שאילתות ליומני שגיאות של תוספים ב-Cloud Logs Explorer, כדי שתוכלו:
- לבדוק אם המשתמשים נתקלים בשגיאות.
- לראות באיזו תדירות מתרחשות שגיאות, ואילו שגיאות מתרחשות בתדירות הגבוהה ביותר.
- לקרוא הודעות שגיאה תיאוריות שיעזרו לכם לתקן אותן.
דרישות מוקדמות
לפני שמבצעים שאילתה ביומני השגיאות של התוסף:
- מפעילים את Cloud Logging API בפרויקט Google Cloud של התוסף. כדי להפעיל API, אפשר לעיין במאמר בנושא יצירת פרויקט ב-Cloud והפעלת ה-API.
- פרסום התוסף ב-Google Workspace Marketplace. כדי לפרסם תוסף ב-Marketplace, אפשר לעיין במאמר בנושא פרסום אפליקציה.
יומני שגיאות של תוספים לשאילתות
כדי לקבל יומנים של תוסף:
- פותחים את מסוף Google Cloud.
- לצד Google Cloud Platform, לוחצים על החץ למטה ובוחרים את פרויקט התוסף.
- בפינה הימנית העליונה, לוחצים על סמל התפריט > רישום ביומן. ייפתח הכלי Logs Explorer.
כדי לראות את יומני השגיאות של תוסף, מזינים את השאילתה הבאה בכלי ליצירת שאילתות:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"כדי לראות את השגיאות האחרונות, לוחצים על Run query (הפעלת שאילתה). אפשר גם ללחוץ על Stream logs (יומני שידור) כדי לראות את השגיאות בזמן שהן מתרחשות. יומני שגיאות של תוספים מופיעים בחלונית Query results.
מידע נוסף על 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.