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

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

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

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

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

  1. ב-Google API Console, לוחצים על Menu > More products > Logging > Logs Explorer.

    כניסה לדף Log Explorer

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

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

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

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

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

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

    • ERROR

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

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

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

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