سجلّات أخطاء طلبات البحث لتطبيقات Google Chat

يوضّح هذا الدليل كيفية طلب البحث عن سجلّات أخطاء تطبيق Chat في مستكشف سجلّات Google Cloud. سجلات طلبات البحث إلى:

  • معرفة ما إذا كان المستخدمون يواجهون أخطاء
  • الاطّلاع على عدد مرات حدوث الأخطاء والأخطاء الأكثر تكرارًا
  • قراءة رسائل الخطأ الوصفية وبيانات السجلّ التي تساعدك في إصلاح الأخطاء

المتطلبات الأساسية

سجلّات أخطاء طلبات البحث

  1. في وحدة تحكّم Google Cloud، انقر على القائمة > المزيد من المنتجات > تسجيل الدخول > مستكشف السجلّات.

    الانتقال إلى "مستكشف السجلات"

  2. إذا لزم الأمر، فعِّل الخيار عرض الطلب لعرض "أداة إنشاء طلبات البحث".

  3. بالنسبة إلى سجلّات أخطاء تطبيق Chat، أدخِل طلب البحث التالي:

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

  4. للاطّلاع على الأخطاء الأخيرة، انقر على تنفيذ طلب البحث. أو، للاطّلاع على الأخطاء عند حدوثها، انقر على سجلات البث. تظهر سجلّات أخطاء تطبيق Chat في جزء "نتائج طلب البحث".

لمزيد من المعلومات حول "مستكشف سجلات Google Cloud" وكتابة طلبات البحث، راجِع الأدلة التالية في مستندات "مستكشف السجلات":

قراءة رسالة خطأ من سجلّ

بعد طلب البحث في سجلّ الأخطاء، يمكنك عرض السجلّات الفردية التي تتألف من حمولة JSON تصف السجلّ. بالنسبة إلى أخطاء تطبيق Chat، يتضمّن ملف JSON رسالة الخطأ في jsonPayload.error.message. على سبيل المثال، في سجلّ العيّنة التالي، تشير رسالة الخطأ إلى تعذُّر تنفيذ إحدى دوال "برمجة تطبيقات Google":

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، ضَع في اعتبارك ما يلي:

  • بالنسبة إلى تطبيقات Google Chat، يتضمّن "مستكشف السجلات" حاليًا سجلات تتضمّن مستويات الخطورة التالية التي تساعد في تحديد المشاكل وحلّها في تطبيق لا يعمل بشكل صحيح:

    • ERROR

    يمكن أن تساعد سجلّات الخدمات ذات الصلة أيضًا في تصحيح أخطاء تطبيق Chat. على سبيل المثال، إذا تم نشر تطبيق Chat باستخدام Google Cloud Functions، من أفضل الممارسات التحقّق من "مستكشف السجلّات" بحثًا عن سجلّات Cloud Functions أيضًا.

  • تتم كتابة رسائل الخطأ باللغة الإنجليزية دائمًا.

  • تتضمّن خدمة Cloud Logging تكلفة. لمزيد من المعلومات حول أسعار Cloud Logging، يُرجى الاطّلاع على أسعار "حزمة عمليات Google Cloud".

بعد طلب سجلّات الأخطاء، إذا عثرت على أخطاء، راجِع الأدلة التالية للحصول على مساعدة في إصلاح الأخطاء: