عندما تعرض إضافة منشورة في 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"للاطّلاع على الأخطاء الأخيرة، انقر على تنفيذ طلب البحث. يمكنك أيضًا النقر على سجلّات البث للاطّلاع على الأخطاء عند حدوثها. تظهر سجلّات أخطاء الإضافات في جزء "نتائج طلب البحث".
لمزيد من المعلومات حول "مستكشف سجلات Cloud" وكتابة طلبات البحث، يُرجى الرجوع إلى ما يلي:
تفعيل تسجيل الأخطاء أو إيقافه
يكون تسجيل الأخطاء مفعَّلاً تلقائيًا. عند تفعيل تسجيل الأخطاء، سيحتوي ملف البيان على ما يلي:
"exceptionLogging": "STACKDRIVER",
لإيقاف تسجيل الأخطاء، استبدِل
"exceptionLogging": "STACKDRIVER", بالسطر التالي في ملف البيان:
// Disable error logging
"exceptionLogging": "NONE"
لإعادة تفعيل تسجيل الأخطاء، استبدِل "exceptionLogging": "NONE" بـ "exceptionLogging": "STACKDRIVER",.
الاعتبارات
عند التعامل مع سجلّات أخطاء الإضافات في "مستكشف سجلّات Cloud"، يُرجى مراعاة ما يلي:
- تسجّل الإضافات الأخطاء في "مستكشف السجلات" فقط. ولا يتم تسجيل أنواع السجلّات الأخرى.
- تتم كتابة رسائل الخطأ دائمًا باللغة الإنجليزية.
- تتضمّن خدمة Cloud Logging تكلفة. لمزيد من المعلومات حول أسعار Cloud Logging، يُرجى الرجوع إلى أسعار Google Cloud Observability.