Zgłaszanie błędów

Automatyczne zgłaszanie błędów

Możesz wysłać błąd z funkcji w Cloud Functions do raportowania błędów, 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
index.js

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)


main.py

Aby uzyskać bardziej szczegółowe raporty o błędach, możesz skorzystać z bibliotek klienta usługi raportowania błędów.

Zgłoszone błędy możesz wyświetlić w narzędziu Error Reporting w konsoli GCP. Możesz też zobaczyć błędy zgłaszane przez konkretną funkcję, wybierając ją z listy funkcji w konsoli GCP.

Nieprzechwycone wyjątki utworzone przez funkcję pojawią się w usłudze Error Reporting. Pamiętaj, że niektóre typy niewykrytych wyjątków (np. zgłaszane asynchronicznie) będą powodować uruchomienie aplikacji „na zimno” przy następnym wywołaniu funkcji. Wydłuży to czas potrzebny na uruchomienie funkcji.

Ręczne zgłaszanie błędów

Wysyłam do Cloud Logging

Funkcja error z pakietu SDK loggera w Cloud Functions zgłasza błędy zarówno do Cloud Logging, jak i Error Reporting. Aby uwzględnić szerszy kontekst błędu jako uporządkowane dane, przekaż obiekt błędu jako drugi argument:

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