Zgłaszanie błędów


Automatyczne zgłaszanie błędów

Możesz wygenerować błąd z funkcji do raportowania błędów, jak pokazano poniżej:

Node.jsPython
// These WILL be reported to Error Reporting
throw new Error('I failed you'); // Will cause a cold start if not caught
@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ć klientów bibliotek Error Reporting.

Zgłoszone błędy możesz wyświetlić w sekcji Error Reporting (Zgłaszanie błędów) w konsoli Google Cloud. Błędy zgłoszone przez konkretną funkcję możesz też zobaczyć, gdy ją wybierzesz na liście funkcji w konsoli Google Cloud.

Nieprzechwycone wyjątki wygenerowane przez funkcję pojawią się w raportowaniu błędów. Pamiętaj, że niektóre typy nieprzechwycionych wyjątków (takich jak wyjątki rzucane asynchronicznie) spowodują zimny start podczas przyszłego wywołania funkcji. Zwiększa to czas wykonywania 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 Cloud Functions do pakietu SDK logger:

// 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 błędu w postaci uporządkowanych danych, jako drugi argument prześlij obiekt błędu:

 } catch (err) {
  // Attach an error object as the second argument
  error("Unable to read quote from Firestore, sending default instead",
      err);