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