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

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

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

پیش نیازها

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

  1. در کنسول Google Cloud، > محصولات بیشتر > ورود به سیستم > Logs Explorer کلیک کنید.

    به Log Explorer بروید

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

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

    severity=ERROR
    resource.type="chat.googleapis.com/Project"
    
  4. برای مشاهده خطاهای اخیر، روی اجرای پرس و جو کلیک کنید. یا برای دیدن خطاها در حین وقوع، روی گزارش‌های جریان کلیک کنید. گزارش های خطای برنامه چت در قسمت «نتایج پرس و جو» ظاهر می شود.

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

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

پس از جستجوی گزارش خطا، می‌توانید گزارش‌های جداگانه را مشاهده کنید که شامل یک بار JSON است که گزارش را توصیف می‌کند. برای خطاهای برنامه گپ، 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، Logs Explorer در حال حاضر شامل گزارش‌هایی با شدت‌های زیر است که به عیب‌یابی یک برنامه ناکارآمد کمک می‌کند:

    • ERROR

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

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

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

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

،

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

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

پیش نیازها

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

  1. در کنسول Google Cloud، > محصولات بیشتر > ورود به سیستم > Logs Explorer کلیک کنید.

    به Log Explorer بروید

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

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

    severity=ERROR
    resource.type="chat.googleapis.com/Project"
    
  4. برای مشاهده خطاهای اخیر، روی اجرای پرس و جو کلیک کنید. یا برای دیدن خطاها در حین وقوع، روی گزارش‌های جریان کلیک کنید. گزارش های خطای برنامه چت در قسمت «نتایج پرس و جو» ظاهر می شود.

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

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

پس از جستجوی گزارش خطا، می‌توانید گزارش‌های جداگانه را مشاهده کنید که شامل یک بار JSON است که گزارش را توصیف می‌کند. برای خطاهای برنامه گپ، 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، Logs Explorer در حال حاضر شامل گزارش‌هایی با شدت‌های زیر است که به عیب‌یابی یک برنامه ناکارآمد کمک می‌کند:

    • ERROR

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

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

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

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