Report errors
Stay organized with collections
Save and categorize content based on your preferences.
Automatically reporting errors
You can emit an error from a function to
Error Reporting as shown below:
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)
If you would like more fine-grained error reporting, you can use the Error Reporting client
libraries.
You can view the reported errors in Error Reporting
in the Google Cloud console. You can also see the errors reported from a
particular function when you select it from the list of functions in the Google Cloud console.
Uncaught exceptions produced by your function will appear in Error Reporting.
Note that some types of uncaught exceptions (such as those thrown
asynchronously) will cause a cold
start to occur upon
a future function invocation. This increases the amount of time your function
will take to run.
Manually reporting errors
Importing dependencies
To report an error to Error Reporting from a function, import the error
function from the Cloud Functions
logger
SDK:
// All available logging functions
const {
log,
info,
debug,
warn,
error,
write,
} = require("firebase-functions/logger");
Sending to Cloud Logging
The error
function from the Cloud Functions
logger
SDK will report errors to both Cloud Logging and Error Reporting. To include more context from the error as structured data, pass an error object as the second argument:
} catch (err) {
// Attach an error object as the second argument
error("Unable to read quote from Firestore, sending default instead",
err);
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-09 UTC.
[null,null,["Last updated 2025-09-09 UTC."],[],[],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"]]