כשתוסף ל-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 ייפתח.
כדי לראות יומנים של שגיאות בתוספים, בכלי ליצירת שאילתות, מזינים השאילתה הבאה:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"כדי לראות את השגיאות האחרונות, לוחצים על הרצת שאילתה. או כדי לראות שגיאות לוחצים על Stream logs. יומני השגיאות של התוספים מופיעים תוצאות של שאילתות .
למידע נוסף על Cloud Logs Explorer ועל כתיבת שאילתות, אפשר לעיין במאמר הבאים:
הפעלה או השבתה של רישום שגיאות ביומן
כברירת מחדל, הרישום ביומן השגיאות מופעל. כשרישום השגיאות ביומן מופעל, קובץ מניפסט כולל:
"exceptionLogging": "STACKDRIVER",
כדי להשבית רישום של שגיאות ביומן, צריך להחליף
"exceptionLogging": "STACKDRIVER", עם השורה הבאה בתוך
קובץ מניפסט:
// Disable error logging
"exceptionLogging": "NONE"
כדי להפעיל מחדש רישום שגיאות ביומן, צריך להחליף את "exceptionLogging": "NONE" ב:
"exceptionLogging": "STACKDRIVER",.
לתשומת ליבכם
תוך כדי עבודה עם יומני שגיאות של תוספים ביומני Cloud Explorer, שימו לב לשיקולים הבאים:
- תוספים רושמים שגיאות רק ב-Logs Explorer. סוגי יומנים אחרים הם לא תועד.
- הודעות שגיאה תמיד נכתבות באנגלית.
- השימוש ב-Cloud Logging כרוך בתשלום. מידע נוסף על Cloud Logging מידע נוסף זמין במחירי הניראות (observability) של Google Cloud.