Automatyczne zgłaszanie błędów
Możesz wysłać błąd z funkcji do Error Reporting, jak pokazano poniżej:
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)
Jeśli chcesz uzyskać bardziej szczegółowe raporty o błędach, możesz użyć bibliotek klienta raportowania błędów.
Zgłoszone błędy możesz wyświetlić w Error Reporting w konsoli Google Cloud. Możesz też wyświetlić błędy zgłoszone przez konkretną funkcję, wybierając ją z listy funkcji w konsoli Google Cloud.
Nieprzechwycone wyjątki wygenerowane przez funkcję pojawią się w Error Reporting. Pamiętaj, że niektóre typy nieprzechwyconych wyjątków (np. zgłaszane asynchronicznie) spowodują zimny start przy przyszłym wywołaniu funkcji. Zwiększy to czas potrzebny na uruchomienie funkcji.
Ręczne zgłaszanie błędów
Importowanie zależności
Aby zgłosić błąd do Error Reporting z funkcji, zaimportuj funkcję error z pakietu SDK logger Cloud Functions:
// All available logging functions
const {
log,
info,
debug,
warn,
error,
write,
} = require("firebase-functions/logger");
Wysyłam na: Cloud Logging
Funkcja error z pakietu SDK logger Cloud Functions będzie zgłaszać błędy zarówno do Cloud Logging, jak i do Error Reporting. Aby uwzględnić więcej kontekstu z błędu jako uporządkowane dane, przekaż obiekt błędu jako drugi argument:
} catch (err) {
// Attach an error object as the second argument
error("Unable to read quote from Firestore, sending default instead",
err);