Segnalare errori


Segnalazione automatica degli errori

Puoi emettere un errore da una funzione in Error Reporting, come mostrato di seguito:

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

Se vuoi generare report sugli errori più granulari, puoi utilizzare le librerie client di Error Reporting.

Puoi visualizzare gli errori segnalati in Error Reporting nella console Google Cloud. Puoi anche visualizzare gli errori segnalati da una determinata funzione quando la selezioni dall'elenco delle funzioni nella console Google Cloud.

Le eccezioni non rilevate prodotte dalla funzione verranno visualizzate in Error Reporting. Tieni presente che alcuni tipi di eccezioni non rilevate (ad esempio quelle lanciate in modo asincrono) causeranno un avvio a freddo al successivo richiamo della funzione. Ciò aumenta il tempo necessario per l'esecuzione della funzione.

Segnalazione manuale degli errori

Importazione delle dipendenze

Per segnalare un errore a Error Reporting da una funzione, importa la funzione error dall'SDK logger di Cloud Functions:

// All available logging functions
const {
  log,
  info,
  debug,
  warn,
  error,
  write,
} = require("firebase-functions/logger");
index.js

Invio a Cloud Logging in corso…

La funzione error dell'SDK logger di Cloud Functions segnala gli errori sia a Cloud Logging sia a Error Reporting. Per includere più contesto dell'errore sotto forma di dati strutturati, passa un oggetto errore come secondo argomento:

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