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

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

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

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

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

  1. במסוף Google Cloud, לוחצים על Menu (תפריט) > More products (מוצרים נוספים) > 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:

קריאת הודעת שגיאה מהיומן

אחרי ששולחים שאילתה לגבי יומן שגיאות, אפשר להציג יומנים נפרדים שמכילים מטען נתונים של 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, מומלץ לבדוק גם את יומני Cloud Functions ב-Logs Explorer.

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

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

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