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
thrownewError('I failed you');// Will cause a cold start if not caught
Python
@functions_framework.http
defhello_error_1(request):
# This WILL be reported to Error Reporting,
# and WILL NOT show up in logs or
# terminate the function.
fromgoogle.cloudimport 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
defhello_error_2(request):
# These errors WILL NOT be reported to Error
# Reporting, but will show up in logs.
importlogging
importsys
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.
fromflaskimport 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:
//Allavailableloggingfunctions
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);