سجلّات أخطاء طلبات البحث في إضافات Google Workspace

عند ظهور خطأ في "إضافة Google Workspace" منشورة، تعرض واجهة إضافية رسالة عامة "حدث خطأ أثناء تنفيذ الإضافة". ومع ذلك، فإن هذه الأخطاء تم تسجيل الدخول إلى Cloud Logs Explorer (مستكشف سجلّات Cloud).

ملاحظة: بالنسبة إلى "برمجة تطبيقات Google"، إذا كان إضافية كاختبار، ثم يتم الإبلاغ عنها في كل من مستكشف سجلات السحابة الإلكترونية وفي مع واجهة المستخدم الإضافية.

على سبيل المثال، قد يعرض النشر التجريبي للإضافة مثل هذه في واجهته: TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn].

على الرغم من أن رسائل الخطأ مثل هذه مفيدة، إلا أنه المتاحة في مستكشف السجلات. كأفضل ممارسة، يمكنك الاستعلام عن سجلات الخطأ مزيد من المعلومات. لمزيد من المعلومات عن الاختبار وعمليات نشر الإضافات، راجع اختبار إضافات Google Workspace وتصحيح الأخطاء فيها

يصف هذا الدليل كيفية طلب بحث عن سجلات أخطاء الإضافة في مستكشف سجلات السحابة الإلكترونية، كي تتمكن من:

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

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

قبل الاستعلام عن سجلات الأخطاء الخاصة بالإضافة:

• تفعيل "Cloud Logging API" في الوظائف الإضافية مشروع Google Cloud. لتفعيل واجهة برمجة تطبيقات، يمكنك الرجوع إلى إنشاء مشروع على Google Cloud وتفعيل واجهة برمجة التطبيقات
• انشر الإضافة على Google Workspace Marketplace. لنشر إضافة على السوق، راجع نشر تطبيق.

سجلات أخطاء إضافة طلب البحث

للحصول على سجلّات لإضافة:

1. افتح وحدة تحكُّم Google Cloud.
2. بجانب "Google Cloud Platform"، انقر على السهم المتّجه للأسفل ثم اختَر لمشروع إضافي.
3. في أعلى يمين الصفحة، انقر على رمز القائمة . > التسجيل. يتم فتح مستكشف السجلات.

4. بالنسبة إلى سجلات أخطاء الإضافة، في أداة إنشاء طلبات البحث، أدخل الاستعلام التالي:

   severity>=ERROR
   protoPayload.serviceName="gsuiteaddons.googleapis.com"
   

5. للاطّلاع على الأخطاء الأخيرة، انقر على تنفيذ طلب البحث. أو، للاطلاع على الأخطاء أثناء انقر على سجلات البث. تظهر سجلات أخطاء الإضافات في "نتائج طلب البحث" اللوحة.

لمزيد من المعلومات عن مستكشف سجلّات السحابة الإلكترونية وكتابة طلبات البحث، يُرجى الرجوع إلى ما يلي:

• استخدام مستكشف السجلات
• إنشاء طلبات البحث

تفعيل أو إيقاف ميزة تسجيل الأخطاء

يتم تفعيل ميزة تسجيل الأخطاء تلقائيًا. عند تمكين تسجيل الأخطاء، ملف البيان ما يلي:

"exceptionLogging": "STACKDRIVER",

لإيقاف تسجيل الأخطاء، استبدل "exceptionLogging": "STACKDRIVER", مع السطر التالي في ملف البيان:

// Disable error logging
"exceptionLogging": "NONE"

لإعادة تفعيل تسجيل الأخطاء، استبدِل "exceptionLogging": "NONE" بـ "exceptionLogging": "STACKDRIVER",

الاعتبارات

أثناء التعامل مع سجلات أخطاء الإضافات في سجلات السحابة الإلكترونية المستكشف، ضع في اعتبارك هذه الاعتبارات:

• لا تسجِّل الإضافات سوى الأخطاء في مستكشف السجلات. أنواع السجلات الأخرى لم يتم تسجيله.
• تُكتب رسائل الخطأ دائمًا باللغة الإنجليزية.
• ينطوي تسجيل الدخول إلى السحابة الإلكترونية على تكلفة. للمزيد من المعلومات عن ميزة "التسجيل في السحابة الإلكترونية" يُرجى الرجوع إلى أسعار مراقبة Google Cloud.