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

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

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

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

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

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

    כניסה לדף Log Explorer

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

  3. כדי למצוא יומני שגיאות של אפליקציית Chat, מזינים את השאילתה הבאה:

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

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

    • ERROR

    יומנים של שירותים קשורים יכולים גם לעזור בניפוי באגים באפליקציית Chat. לדוגמה, אם אפליקציית Chat נפרסת באמצעות Google Cloud Functions, מומלץ לבדוק גם את יומני Cloud Functions ב-Logs Explorer.

  • הודעות השגיאה תמיד נכתבות באנגלית.

  • השימוש ב-Cloud Logging כרוך בתשלום. למידע נוסף על המחירים של Cloud Logging, ראו תמחור חבילת התפעול של Google Cloud.

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