יומני שגיאות של שאילתות באפליקציות של Google Chat

במדריך הזה מוסבר איך לשלוח שאילתות על יומני שגיאות של אפליקציות Chat ב-Google Cloud Logs Explorer. שליחת שאילתות על היומנים אל:

  • לבדוק אם המשתמשים נתקלים בשגיאות.
  • אפשר לראות באיזו תדירות מתרחשות שגיאות ואילו מהן הן השכיחות ביותר.
  • לקרוא הודעות שגיאה תיאוריות ונתוני יומן שיעזרו לכם לתקן את השגיאות.

דרישות מוקדמות

יומני השגיאות של השאילתות

  1. במסוף Google Cloud, לוחצים על תפריט. > עוד מוצרים > רישום ביומן > Logs Explorer.

    כניסה ל-Log Explorer

  2. אם צריך, מפעילים את האפשרות הצגת שאילתות כדי להציג את הכלי ליצירת שאילתות.

  3. עבור יומני שגיאות של אפליקציות Chat, צריך להזין את השאילתה הבאה:

    severity=ERROR
resource.type="chat.googleapis.com/Project"

  4. כדי לראות את השגיאות האחרונות, לוחצים על הרצת שאילתה. לחלופין, כדי לראות את השגיאות בזמן שהן מתרחשות, לוחצים על עדכוני התוכן. יומני השגיאות של אפליקציית 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.

אחרי שליחת שאילתות על יומני השגיאות, אם תמצאו שגיאות, תוכלו לעיין במדריכים הבאים לעזרה בתיקון השגיאות: