الإبلاغ عن الأخطاء (الجيل الأول)

الإبلاغ عن الأخطاء تلقائيًا

يمكنك إرسال خطأ من دالة إلى 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.

يمكنك الاطّلاع على الأخطاء التي تم الإبلاغ عنها في Error Reporting في Google Cloud Console. يمكنك أيضًا الاطّلاع على الأخطاء التي تم الإبلاغ عنها من دالة معيّنة عند اختيارها من قائمة الدوال في Google Cloud Console.

ستظهر الاستثناءات غير المكتشفة التي تنتجها الدالة في Error Reporting. يُرجى العِلم أنّ بعض أنواع الاستثناءات غير المكتشفة (مثل تلك التي يتم طرحها بشكل غير متزامن) ستؤدي إلى حدوث بدء على البارد عند استدعاء دالة في المستقبل. يؤدي ذلك إلى زيادة مقدار الوقت الذي ستستغرقه الدالة في التشغيل.

الإبلاغ عن الأخطاء يدويًا

استيراد التبعيات

للإبلاغ عن خطأ إلى Error Reporting من دالة، استورِد الدالة error من حزمة تطوير البرامج (SDK) logger في Cloud Functions:

// All available logging functions
const {
  log,
  info,
  debug,
  warn,
  error,
  write,
} = require("firebase-functions/logger");

جارٍ الإرسال إلى Cloud Logging

ستُبلغ دالة error من حزمة تطوير البرامج (SDK) الخاصة بـ logger في 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);