سجلّات أخطاء طلبات البحث لتطبيقات 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، يُرجى الاطّلاع على أسعار مجموعة عمليات Google Cloud.

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