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

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

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

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

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

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

    כניסה לדף Log Explorer

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

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

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

  4. כדי לראות את השגיאות האחרונות, לוחצים על Run query. לחלופין, כדי לראות את השגיאות בזמן שהן מתרחשות, לוחצים על Stream logs (יומני שידור). יומני השגיאות של אפליקציית Chat מופיעים בחלונית Query results (תוצאות השאילתה).

מידע נוסף על Logs Explorer של Google Cloud ועל כתיבת שאילתות זמין במדריכים הבאים במסמכי התיעוד של 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 ב-Logs Explorer ב-Google Cloud, חשוב לשים לב לנקודות הבאות:

  • בשלב הזה, Logs Explorer כולל יומנים של אפליקציות ל-Google Chat עם רמות חומרה שונות, שיכולים לעזור לפתור בעיות באפליקציה שלא פועלת כמו שצריך:

    • ERROR

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

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

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

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