الإبلاغ عن الأخطاء تلقائيًا
يمكنك إرسال خطأ من دالة إلى Error Reporting كما هو موضّح أدناه:
// These WILL be reported to Error Reporting
throw new Error('I failed you'); // Will cause a cold start if not caught
إذا كنت تريد إعداد تقارير أكثر تفصيلاً عن الأخطاء، يمكنك استخدام مكتبات عميل إعداد التقارير عن الأخطاء.
يمكنك الاطّلاع على الأخطاء التي تم الإبلاغ عنها في Error Reporting في Google Cloud Console. يمكنك أيضًا الاطّلاع على الأخطاء التي تم الإبلاغ عنها من دالة معيّنة عند اختيارها من قائمة الدوال في وحدة تحكّم Google Cloud.
ستظهر الاستثناءات غير المعالَجة التي تنتجها الدالة في "تقارير الأخطاء". يُرجى العِلم أنّ بعض أنواع الاستثناءات غير المعالَجة (مثل تلك التي يتم طرحها بشكل غير متزامن) ستؤدي إلى حدوث بدء تشغيل بارد عند استدعاء دالة في المستقبل. يؤدي ذلك إلى زيادة مقدار الوقت الذي تستغرقه الدالة في التنفيذ.
الإبلاغ عن الأخطاء يدويًا
استيراد العناصر التابعة
للإبلاغ عن خطأ إلى Error Reporting من إحدى الدوال، استورِد الدالة error من حزمة تطوير البرامج (SDK) الخاصة بأداة تسجيل البيانات في Cloud Functions:
// All available logging functions
const {
log,
info,
debug,
warn,
error,
write,
} = require("firebase-functions/logger");
جارٍ الإرسال إلى Cloud Logging
ستُبلغ الدالة error من حزمة تطوير البرامج (SDK) الخاصة بأداة تسجيل الأحداث في Cloud Functions عن الأخطاء إلى كل من Cloud Logging وError Reporting. لتضمين المزيد من السياق من الخطأ كبيانات منظَّمة، مرِّر عنصر خطأ كمعلَمة ثانية:
} catch (err) {
// Attach an error object as the second argument
error("Unable to read quote from Firestore, sending default instead",
err);