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

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

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

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

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

استيراد المهام التابعة

للإبلاغ عن خطأ في 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);