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

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

ملاحظة: في برمجة تطبيقات، إذا تم تفعيل الإضافة كإصدار تجريبي، سيتم الإبلاغ عن الأخطاء في كل من "مستكشف سجلّات Cloud" وفي واجهة الإضافة.

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

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

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

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

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

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

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

الاستعلام عن سجلّات أخطاء الإضافة

للحصول على سجلّات إضافة، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

"exceptionLogging": "STACKDRIVER",

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

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

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

الاعتبارات

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

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