דיווח על שגיאות

דיווח אוטומטי על שגיאות

אפשר לשלוח שגיאה מפונקציה אל Error Reporting, כמו שמוצג בהמשך:

Node.js

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

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)

אם אתם רוצים דיווח שגיאות מפורט יותר, אתם יכולים להשתמש בספריות הלקוח של Error Reporting.

אפשר לראות את השגיאות שדווחו בדיווח על שגיאות במסוף Google Cloud. אפשר גם לראות את השגיאות שדווחו מפונקציה מסוימת כשבוחרים אותה מרשימת הפונקציות במסוף Google Cloud.

חריגים שלא נתפסו שנוצרו על ידי הפונקציה יופיעו בדוח השגיאות. חשוב לזכור שסוגים מסוימים של חריגות שלא נתפסו (כמו אלה שמופעלות באופן אסינכרוני) יגרמו להפעלה קרה כשפונקציה תופעל בעתיד. כך גדל משך הזמן שיידרש להפעלת הפונקציה.

דיווח ידני על שגיאות

ייבוא יחסי תלות

כדי לדווח על שגיאה ל-Error Reporting מפונקציה, מייבאים את הפונקציה error מ-Cloud Functions logger SDK:

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

שליחה אל 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);
index.js