במדריך הזה מוסבר איך לשלוח שאילתות על יומני שגיאות של אפליקציות Chat ב-Google Cloud Logs Explorer. שליחת שאילתות על היומנים אל:
- לבדוק אם המשתמשים נתקלים בשגיאות.
- אפשר לראות באיזו תדירות מתרחשות שגיאות ואילו מהן הן השכיחות ביותר.
- לקרוא הודעות שגיאה תיאוריות ונתוני יומן שיעזרו לכם לתקן את השגיאות.
דרישות מוקדמות
- חשבון Google Workspace עם גישה ל-Google Chat.
- אפליקציית Chat. כדי ליצור אפליקציה של Chat, אפשר להיעזר במדריך למתחילים.
- להפעיל את הרישום של שגיאות ביומן באפליקציית Chat.
יומני השגיאות של השאילתות
במסוף Google Cloud, לוחצים על תפריט. > עוד מוצרים > רישום ביומן > Logs Explorer.
אם צריך, מפעילים את האפשרות הצגת שאילתות כדי להציג את הכלי ליצירת שאילתות.
עבור יומני שגיאות של אפליקציות Chat, צריך להזין את השאילתה הבאה:
severity=ERROR resource.type="chat.googleapis.com/Project"
כדי לראות את השגיאות האחרונות, לוחצים על הרצת שאילתה. לחלופין, כדי לראות את השגיאות בזמן שהן מתרחשות, לוחצים על עדכוני התוכן. יומני השגיאות של אפליקציית 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, חשוב לשים לב לשיקולים הבאים:
נכון לעכשיו, באפליקציות ל-Google Chat נכללות יומנים ב-Logs Explorer במידות הבאות, שעוזרות לפתור בעיות באפליקציה:
ERROR
יומנים של שירותים קשורים יכולים גם לעזור לנפות באגים באפליקציות של Chat. לדוגמה, אם אפליקציית Chat פרוסה באמצעות Google Cloud Functions, מומלץ לבדוק גם את Logs Explorer ליומני Cloud Functions.
הודעות שגיאה תמיד נכתבות באנגלית.
השימוש ב-Cloud Logging כרוך בתשלום. למידע נוסף על המחירים של Cloud Logging, ראו תמחור חבילת התפעול של Google Cloud.
נושאים קשורים
אחרי שליחת שאילתות על יומני השגיאות, אם תמצאו שגיאות, תוכלו לעיין במדריכים הבאים לעזרה בתיקון השגיאות:
- איך מתקנים שגיאות באפליקציית Google Chat, כמו "האפליקציה לא מגיבה", "Google Chat API זמין רק למשתמשי Google Workspace" או "אפשר להחריג משתמשים ממרחבים משותפים".
- כאן מוסבר איך לתקן שגיאות בכרטיס, כמו הודעות בכרטיס, תיבות דו-שיח או תצוגות מקדימות של קישורים, שלא עובדות או לא פועלות כמצופה.
- איך מבצעים ניפוי באגים