במדריך הזה מוסבר איך לשלוח שאילתות על יומני שגיאות באפליקציות של Chat ב-Google Cloud Logs Explorer. הרצת שאילתות על היומנים כדי:
- לגלות אם המשתמשים נתקלים בשגיאות.
- אפשר לראות באיזו תדירות מתרחשות שגיאות ואילו בתדירות הגבוהה ביותר.
- קריאת הודעות שגיאה תיאוריות ונתוני יומן שיעזרו לכם לתקן את השגיאות.
דרישות מוקדמות
- חשבון Google Workspace עם גישה ל-Google Chat.
- אפליקציה ל-Chat. כדי ליצור אפליקציה ל-Chat, פועלים לפי ההוראות בquickstart.
- מפעילים רישום שגיאות ביומן באפליקציית Chat.
יומני שגיאות בשאילתה
במסוף Google Cloud, לוחצים על תפריט > מוצרים נוספים > Logging > Logs Explorer.
אם יש צורך, כדי להציג את הכלי ליצירת שאילתות, מפעילים את האפשרות Show query (הצגת שאילתה).
כדי להשתמש ביומני שגיאות באפליקציות של Chat, מזינים את השאילתה הבאה:
severity=ERROR resource.type="chat.googleapis.com/Project"
כדי לראות את השגיאות האחרונות, לוחצים על Run query. לחלופין, כדי לראות את השגיאות בזמן שהן מתרחשות, לוחצים על סטרימינג של יומנים. יומני השגיאות באפליקציית Chat מופיעים בחלונית 'תוצאות השאילתה'.
כדי לקבל מידע נוסף על Google Cloud Logs Explorer ועל כתיבת שאילתות, עיינו במדריכים הבאים במסמכי התיעוד של Logs Explorer:
קריאה של הודעת שגיאה מיומן
לאחר שליחת שאילתה ביומן שגיאות, ניתן להציג יומנים נפרדים שמכילים מטען ייעודי (payload) של JSON שמתאר את היומן. במקרים של שגיאות באפליקציית Chat, הודעת השגיאה בקובץ ה-JSON כוללת את הודעת השגיאה jsonPayload.error.message
. למשל, ביומן לדוגמה הבא מופיעה הודעת השגיאה כי ההפעלה של פונקציית Apps Script נכשלה:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
לתשומת ליבכם
במהלך העבודה עם יומני שגיאות באפליקציות של Chat ב-Google Cloud Logs Explorer, חשוב לשים לב לשיקולים הבאים:
כדי לעזור בפתרון בעיות באפליקציה שלא תפקדה כראוי, Logs Explorer כולל כרגע יומנים במידות החומרה הבאות לאפליקציות של Google Chat:
ERROR
גם יומנים של שירותים קשורים יכולים לעזור לנפות באגים באפליקציית Chat. לדוגמה, אם אפליקציית Chat נפרסת באמצעות Google Cloud Functions, מומלץ לבדוק גם ב-Logs Explorer אם יש יומנים של Cloud Functions.
הודעות שגיאה נכתבות תמיד באנגלית.
השימוש ב-Cloud Logging כרוך בעלות. למידע נוסף על המחירים של Cloud Logging, ראו מחירי חבילת התפעול של Google Cloud.
נושאים קשורים
אם אתם מוצאים שגיאות אחרי שליחת שאילתות ביומני שגיאות, תוכלו להיעזר במדריכים הבאים כדי לתקן אותן:
- כאן תוכלו ללמוד איך לתקן שגיאות באפליקציות של Google Chat, כמו 'האפליקציה לא מגיבה', 'Google Chat API זמין רק למשתמשי Google Workspace' או 'אפשר להחריג את המשתמשים ממרחבים משותפים'.
- כך מתקנים שגיאות בכרטיס כמו הודעות בכרטיס, תיבות דו-שיח או תצוגה מקדימה של קישורים שלא מעובדים או פועלים כצפוי.
- איך מבצעים ניפוי באגים