回報錯誤

自動回報錯誤

您可以從函式發出錯誤至 Error Reporting，如下所示：

Node.js

// These WILL be reported to Error Reporting
throw new Error('I failed you'); // Will cause a cold start if not caughtindex.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

如要取得更精細的錯誤報告，可以使用 Error Reporting 用戶端程式庫。

您可以在 Google Cloud 控制台的 Error Reporting 中查看回報的錯誤。您也可以在 Google Cloud 控制台中選取函式清單中的特定函式，查看該函式回報的錯誤。

函式產生的未處理例外狀況會顯示在 Error Reporting 中。請注意，某些類型的未處理例外狀況 (例如以非同步方式擲回的例外狀況)，會在日後叫用函式時導致冷啟動。這會增加函式的執行時間。

手動回報錯誤

正在傳送至「Cloud Logging」

Cloud Functions 記錄器 SDK 的 error 函式會將錯誤回報給 Cloud Logging 和 Error Reporting。如要將錯誤中的更多脈絡資訊納入結構化資料，請將錯誤物件做為第二個引數傳遞：

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