عندما تعرض إحدى إضافات Google Workspace المنشورة رسالة خطأ، تعرض واجهة الإضافة رسالة عامة مفادها "حدث خطأ أثناء تنفيذ الإضافة". ومع ذلك، يتم تسجيل هذه الأخطاء في مستكشف سجلات Cloud.
يوضِّح هذا الدليل كيفية الاستعلام عن سجلات أخطاء الإضافة في مستكشف سجلات Cloud، كي تتمكن من إجراء ما يلي:
- ويمكنك معرفة ما إذا كان المستخدمون يواجهون أخطاءً.
- تعرّف على عدد مرات حدوث الأخطاء وأيها أكثر تكرارًا.
- اطّلِع على رسائل الخطأ الوصفية التي تساعدك على حلّها.
المتطلبات الأساسية
قبل طلب البحث عن سجلات أخطاء الإضافة:
- فعِّل Cloud Logging API في مشروع Google Cloud للإضافة. لتفعيل واجهة برمجة التطبيقات، يمكنك الرجوع إلى مقالة إنشاء مشروع على السحابة الإلكترونية وتفعيل واجهة برمجة التطبيقات.
- انشر الإضافة على Google Workspace Marketplace. لنشر إضافة على السوق، يُرجى الرجوع إلى نشر تطبيق.
سجلات أخطاء إضافة طلب البحث
للحصول على سجلات إحدى الإضافات:
- افتح Google Cloud Console.
- بجانب Google Cloud Platform، انقر على السهم المتّجه للأسفل واختَر مشروع الإضافة.
- في أعلى يمين الصفحة، انقر على القائمة > التسجيل. يتم فتح مستكشف السجلات.
بالنسبة إلى سجلات أخطاء الإضافة، في أداة إنشاء طلبات البحث، أدخِل طلب البحث التالي:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"للاطّلاع على الأخطاء الأخيرة، انقر على تنفيذ طلب البحث. أو للاطّلاع على الأخطاء عند حدوثها، انقر على سجلات البث. تظهر سجلات أخطاء الإضافات في جزء "نتائج الاستعلام".
لمزيد من المعلومات حول مستكشف سجلات Cloud وكتابة الاستعلامات، يُرجى الاطلاع على ما يلي:
تفعيل أو إيقاف تسجيل الأخطاء
ويكون تسجيل الأخطاء مفعَّلاً تلقائيًا. عند تمكين تسجيل الأخطاء، يتضمن ملف البيان ما يلي:
"exceptionLogging": "STACKDRIVER",
لإيقاف تسجيل الأخطاء، استبدل "exceptionLogging": "STACKDRIVER", بالسطر التالي في ملف البيان:
// Disable error logging
"exceptionLogging": "NONE"
لإعادة تفعيل ميزة تسجيل الأخطاء، استبدِل "exceptionLogging": "NONE" بـ
"exceptionLogging": "STACKDRIVER",.
الاعتبارات
أثناء العمل على سجلات أخطاء الإضافات في مستكشف سجلات Cloud، يُرجى مراعاة الاعتبارات التالية:
- أخطاء سجل الإضافات في "مستكشف السجلات" فقط. لا يتم تسجيل أنواع السجلات الأخرى.
- تتم كتابة رسائل الخطأ دائمًا باللغة الإنجليزية.
- يتم تحمُّل تكلفة التسجيل في السحابة الإلكترونية. لمزيد من المعلومات عن أسعار تسجيل الدخول إلى Cloud، يمكنك الرجوع إلى أسعار مراقبة Google Cloud.