Signaler les erreurs

Signaler automatiquement les erreurs

Vous pouvez émettre une erreur d'une fonction Cloud vers le rapport d'erreurs , comme indiqué ci-dessous :

Noeud.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

Si vous souhaitez un rapport d'erreurs plus précis, vous pouvez utiliser les bibliothèques clientes de rapport d'erreurs .

Vous pouvez afficher les erreurs signalées dans le rapport d'erreurs dans la console GCP. Vous pouvez également voir les erreurs signalées par une fonction particulière lorsque vous la sélectionnez dans la liste des fonctions de la console GCP.

Les exceptions non interceptées produites par votre fonction apparaîtront dans le rapport d'erreurs. Notez que certains types d'exceptions non interceptées (telles que celles lancées de manière asynchrone) entraîneront un démarrage à froid lors d'un futur appel de fonction. Cela augmente le temps d’exécution de votre fonction.

Signaler manuellement les erreurs

Envoi vers Cloud Logging

La fonction error du SDK de l'enregistreur Cloud Functions signalera les erreurs à la fois à Cloud Logging et à Error Reporting . Pour inclure plus de contexte de l'erreur sous forme de données structurées , transmettez un objet d'erreur comme deuxième argument :

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