报告错误
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
自动报告错误
您可以将函数报告的错误提交到 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 控制台的 Error Reporting 中查看报告的错误。您也可以在 Google Cloud 控制台的函数列表中选择特定的函数,来查看该函数报告的错误。
您的函数产生的未捕获到的异常会显示在 Error Reporting 中。请注意,未捕获到的某些异常(例如异步抛出的异常)会导致在未来调用函数时执行冷启动,这会增加您的函数运行所需的时间。
手动报告错误
导入依赖项
如需通过函数向 Error Reporting 报告错误,请从 Cloud Functions logger SDK 导入 error
函数:
// All available logging functions
const {
log,
info,
debug,
warn,
error,
write,
} = require("firebase-functions/logger");
发送到 Cloud Logging
Cloud Functions logger SDK 中的 error
函数会将错误同时报告给 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);
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-09-09。
[null,null,["最后更新时间 (UTC):2025-09-09。"],[],[],null,["\u003cbr /\u003e\n\nAutomatically reporting errors\n\nYou can emit an error from a function to\n[Error Reporting](https://cloud.google.com/error-reporting/docs) as shown below: \n\nNode.js \n\n // These WILL be reported to Error Reporting\n throw new Error('I failed you'); // Will cause a cold start if not caught\n\nPython \n\n @functions_framework.http\n def hello_error_1(request):\n # This WILL be reported to Error Reporting,\n # and WILL NOT show up in logs or\n # terminate the function.\n from google.cloud import error_reporting\n\n client = error_reporting.Client()\n\n try:\n raise RuntimeError(\"I failed you\")\n except RuntimeError:\n client.report_exception()\n\n # This WILL be reported to Error Reporting,\n # and WILL terminate the function\n raise RuntimeError(\"I failed you\")\n\n @functions_framework.http\n def hello_error_2(request):\n # These errors WILL NOT be reported to Error\n # Reporting, but will show up in logs.\n import logging\n import sys\n\n print(RuntimeError(\"I failed you (print to stdout)\"))\n logging.warning(RuntimeError(\"I failed you (logging.warning)\"))\n logging.error(RuntimeError(\"I failed you (logging.error)\"))\n sys.stderr.write(\"I failed you (sys.stderr.write)\\n\")\n\n # This is considered a successful execution and WILL NOT be reported\n # to Error Reporting, but the status code (500) WILL be logged.\n from flask import abort\n\n return abort(500)\n\nIf you would like more fine-grained error reporting, you can use the [Error Reporting client\nlibraries](https://cloud.google.com/error-reporting/docs/reference/libraries).\n\nYou can view the reported errors in [Error Reporting](https://console.cloud.google.com/errors)\nin the Google Cloud console. You can also see the errors reported from a\nparticular function when you select it from the [list of functions](https://console.cloud.google.com/functions) in the Google Cloud console.\n\nUncaught exceptions produced by your function will appear in Error Reporting.\nNote that some types of uncaught exceptions (such as those thrown\nasynchronously) will cause a [cold\nstart](https://cloud.google.com/functions/docs/bestpractices/tips) to occur upon\na future function invocation. This increases the amount of time your function\nwill take to run.\n\nManually reporting errors\n\nImporting dependencies\n\nTo report an error to [Error Reporting](https://cloud.google.com/error-reporting/docs) from a function, import the `error` function from the Cloud Functions\n[logger](https://firebase.google.com/docs/reference/functions/firebase-functions.logger)\nSDK: \n\n // All available logging functions\n const {\n log,\n info,\n debug,\n warn,\n error,\n write,\n } = require(\"firebase-functions/logger\"); \n https://github.com/firebase/functions-samples/blob/c4fde45b65fab584715e786ce3264a6932d996ec/Node/quickstarts/monitor-cloud-logging/functions/index.js#L23-L31\n\nSending to Cloud Logging\n\nThe `error` function from the Cloud Functions\n[logger](https://firebase.google.com/docs/reference/functions/firebase-functions.logger)\nSDK will report errors to both Cloud Logging and [Error Reporting](https://cloud.google.com/error-reporting/docs). To include more context from the error as [structured data](https://cloud.google.com/logging/docs/structured-logging), pass an error object as the second argument: \n\n } catch (err) {\n // Attach an error object as the second argument\n error(\"Unable to read quote from Firestore, sending default instead\",\n err); \n https://github.com/firebase/functions-samples/blob/c4fde45b65fab584715e786ce3264a6932d996ec/Node/quickstarts/monitor-cloud-logging/functions/index.js#L83-L86"]]