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

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

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

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

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

  1. في Google Cloud 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، من أفضل الممارسات التحقّق من "مستكشف السجلات" لسجلات دوال Cloud أيضًا.

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

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

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