Signaler les erreurs


Signaler automatiquement les erreurs

Vous pouvez envoyer une erreur à partir d'une fonction vers Error Reporting, comme indiqué ci-dessous :

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

Si vous souhaitez obtenir des rapports d'erreurs plus détaillés, vous pouvez utiliser les bibliothèques clientes Error Reporting.

Vous pouvez afficher les erreurs signalées dans Error Reporting dans la console Google Cloud. Vous pouvez également consulter les erreurs signalées à partir d'une fonction particulière en la sélectionnant dans la liste de fonctions dans la console Google Cloud.

Les exceptions non détectées générées par votre fonction apparaissent dans Error Reporting. Notez que certains types d'exceptions non détectées (telles que celles générées de manière asynchrone) provoquent un démarrage à froid lors d'un futur appel de fonction. Cela augmente le temps nécessaire à l'exécution de votre fonction.

Signaler des erreurs manuellement

Envoi à Cloud Logging

La fonction error du SDK du journal Cloud Functions signale les erreurs à la fois à Cloud Logging et à Error Reporting. Pour inclure plus de contexte de l'erreur en tant que 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
  );
}