سجلّات أخطاء طلبات البحث لتطبيقات 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، تتضمّن أداة Logs Explorer حاليًا سجلّات بمستويات الخطورة التالية تساعد في تحديد المشاكل وحلّها في تطبيق معطّل:

    • ERROR

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

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

  • ينطوي تسجيل الدخول إلى السحابة الإلكترونية على تكلفة. للحصول على مزيد من المعلومات عن أسعار تسجيل الدخول إلى السحابة الإلكترونية، يُرجى الرجوع إلى أسعار حزمة العمليات في Google Cloud.

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