گزارش‌های خطای درخواست برای برنامه‌های چت Google

این راهنما نحوه‌ی جستجوی گزارش‌های خطای برنامه‌ی چت در Google Cloud Logs Explorer را شرح می‌دهد. گزارش‌ها را به آدرس‌های زیر جستجو کنید:

  • اگر کاربران با خطایی مواجه شدند، مطلع شوید.
  • ببینید چند وقت یکبار خطاها رخ می‌دهند و کدام‌ها رایج‌تر هستند.
  • پیام‌های خطای توصیفی و داده‌های گزارش را که به شما در رفع خطاها کمک می‌کنند، بخوانید.

پیش‌نیازها

گزارش‌های خطای پرس‌وجو

  1. در کنسول API گوگل، > محصولات بیشتر > گزارش‌گیری > کاوشگر گزارش‌ها کلیک کنید.

    به کاوشگر لاگ بروید

  2. در صورت لزوم، برای نمایش سازنده‌ی پرس‌وجو، نمایش پرس‌وجو را فعال کنید.

  3. برای گزارش‌های خطای برنامه چت، عبارت زیر را وارد کنید:

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

  4. برای مشاهده خطاهای اخیر، روی اجرای پرس‌وجو کلیک کنید. یا برای مشاهده خطاها در حین وقوع، روی جریان گزارش‌ها کلیک کنید. گزارش‌های خطای برنامه چت در پنجره «نتایج پرس‌وجو» ظاهر می‌شوند.

برای کسب اطلاعات بیشتر در مورد Google Cloud Logs Explorer و نوشتن کوئری‌ها، به این راهنماها در مستندات Logs Explorer مراجعه کنید:

خواندن پیام خطا از یک گزارش

پس از جستجوی یک گزارش خطا، می‌توانید گزارش‌های جداگانه‌ای را مشاهده کنید که شامل یک فایل JSON هستند که گزارش را توصیف می‌کند. برای خطاهای برنامه چت، JSON شامل پیام خطا در jsonPayload.error.message است. به عنوان مثال، در گزارش نمونه زیر، پیام خطا می‌گوید که یک تابع Apps Script نتوانسته اجرا شود:

جی‌سون 

{
  "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"
}

ملاحظات

هنگام کار با گزارش‌های خطای برنامه چت در Google Cloud Logs Explorer، به این نکات توجه کنید:

  • برای برنامه‌های چت گوگل، Logs Explorer شامل گزارش‌هایی با شدت‌های زیر است که به عیب‌یابی یک برنامه‌ی دارای نقص کمک می‌کند:

    • ERROR

    گزارش‌های مربوط به سرویس‌های مرتبط نیز می‌توانند به اشکال‌زدایی یک برنامه چت کمک کنند. برای مثال، اگر برنامه چت خود را با استفاده از توابع Google Cloud Run مستقر می‌کنید، Logs Explorer را برای گزارش‌های توابع Cloud Run نیز بررسی کنید.

  • پیام‌های خطا همیشه به زبان انگلیسی نوشته می‌شوند.

  • ثبت وقایع در فضای ابری هزینه دارد. برای اطلاعات بیشتر در مورد قیمت ثبت وقایع در فضای ابری، به قیمت‌گذاری مجموعه عملیات گوگل کلود مراجعه کنید.

پس از بررسی گزارش‌های خطا، اگر خطایی پیدا کردید، برای رفع خطاها به راهنماهای زیر مراجعه کنید: