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

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

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

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

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

  1. במסוף Google Cloud, לוחצים על תפריט > מוצרים נוספים > Logging > 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 כולל כרגע יומנים במידות החומרה הבאות לאפליקציות של Google Chat:

    • ERROR

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

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

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

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