الإبلاغ عن الأخطاء

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

يمكنك إصدار خطأ من دالة Cloud إلى الإبلاغ عن الأخطاء كما هو موضّح أدناه:

Node.js

// These WILL be reported to Error Reporting
throw new Error('I failed you'); // Will cause a cold start if not caught
index.js

Python

@functions_framework.http
def hello_error_1(request):
    # This WILL be reported to Error Reporting,
    # and WILL NOT show up in logs or
    # terminate the function.
    from google.cloud import error_reporting

    client = error_reporting.Client()

    try:
        raise RuntimeError("I failed you")
    except RuntimeError:
        client.report_exception()

    # This WILL be reported to Error Reporting,
    # and WILL terminate the function
    raise RuntimeError("I failed you")


@functions_framework.http
def hello_error_2(request):
    # These errors WILL NOT be reported to Error
    # Reporting, but will show up in logs.
    import logging
    import sys

    print(RuntimeError("I failed you (print to stdout)"))
    logging.warning(RuntimeError("I failed you (logging.warning)"))
    logging.error(RuntimeError("I failed you (logging.error)"))
    sys.stderr.write("I failed you (sys.stderr.write)\n")

    # This is considered a successful execution and WILL NOT be reported
    # to Error Reporting, but the status code (500) WILL be logged.
    from flask import abort

    return abort(500)


main.py

إذا أردت إعداد تقارير أكثر دقة عن الأخطاء، يمكنك استخدام مكتبات العملاء عند الإبلاغ عن الأخطاء.

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

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

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

جارٍ الإرسال إلى تسجيل الدخول إلى السحابة الإلكترونية

ستبلِغ الدالة error من حزمة تطوير البرامج لأداة تسجيل Cloud Functions عن الأخطاء في كل من تسجيل الدخول إلى السحابة الإلكترونية والإبلاغ عن الأخطاء. لتضمين المزيد من السياق من الخطأ باعتباره بيانات منظَّمة، مرِّر كائن خطأ كوسيطة ثانية:

} catch (err) {
  // Attach an error object as the second argument
  functions.logger.error(
    "Unable to read quote from Firestore, sending default instead",
    err
  );
}