گزارش خطاها

گزارش خودکار خطاها

می‌توانید از تابعی به گزارش خطا خطا ارسال کنید، همان‌طور که در زیر نشان داده شده است:

Node.js

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

پایتون

@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)

اگر می‌خواهید گزارش خطای دقیق‌تری داشته باشید، می‌توانید از کتابخانه‌های مشتری گزارش خطا استفاده کنید.

می‌توانید خطاهای گزارش‌شده را در گزارش خطا در کنسول Google Cloud مشاهده کنید. همچنین می‌توانید خطاهای گزارش‌شده از یک تابع خاص را وقتی آن را از فهرست توابع در کنسول Google Cloud انتخاب می‌کنید ببینید.

استثناهای مدیریت‌نشده تولیدشده توسط تابع شما در «گزارش خطا» نشان داده خواهد شد. توجه داشته باشید که برخی‌از انواع استثناهای مدیریت‌نشده (مثل استثناهایی که به‌صورت ناهم‌زمان ایجاد می‌شوند) باعث می‌شوند که در فراخوانی‌های بعدی تابع، راه‌اندازی سرد رخ دهد. این کار باعث افزایش زمان اجرای تابع شما می‌شود.

گزارش دستی خطاها

درحال وارد کردن وابستگی‌ها

برای گزارش خطا به گزارش خطا از یک تابع، تابع error را از Cloud Functions logger SDK وارد کنید:

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

درحال ارسال به Cloud Logging

تابع error از کیت توسعه نرم‌افزار Cloud Functions گزارشگر خطاها را هم به Cloud Logging و هم به گزارش خطا گزارش می‌کند. برای افزودن زمینه‌های بیشتر از خطا به‌عنوان داده‌های ساختاریافته، یک شیء خطا را به‌عنوان آرگومان دوم ارسال کنید:

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