سجلّات أخطاء طلبات البحث لتطبيقات 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 أيضًا.

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

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

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