回報錯誤


自動回報錯誤

您可以讓函式發出錯誤至 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
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

如果您需要更詳細的錯誤報告，可以使用 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
  );
}