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

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

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

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

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

  1. في Google API Console، انقر على القائمة > المزيد من المنتجات > التسجيل > مستكشف السجلات.

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

  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 Run، يمكنك أيضًا مراجعة "مستكشف السجلّات" بحثًا عن سجلّات وظائف Cloud Run.

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

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

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