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

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

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

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

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

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

• فعِّل واجهة برمجة التطبيقات Cloud Logging API في مشروع Google Cloud المرتبط بالإضافة. لتفعيل واجهة برمجة تطبيقات، يُرجى الرجوع إلى مقالة إنشاء مشروع على Cloud وتفعيل واجهة برمجة التطبيقات.
• انشر الإضافة على Google Workspace Marketplace. لنشر إضافة على Marketplace، يُرجى الرجوع إلى مقالة نشر تطبيق.

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

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

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

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

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

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

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

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

تفعيل تسجيل الأخطاء أو إيقافه

يكون تسجيل الأخطاء مفعَّلاً تلقائيًا. عند تفعيل تسجيل الأخطاء، يحتوي ملف البيان على ما يلي:

"exceptionLogging": "STACKDRIVER",

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

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

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

الاعتبارات

عند العمل مع سجلّات الأخطاء الإضافية في "مستكشف سجلّات Cloud"، يُرجى مراعاة النقاط التالية:

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