Informa errores


Informe automático de errores

Para emitir un error desde una función a Error Reporting, haz lo siguiente:

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 quieres obtener un informe de errores más detallado, puedes usar las bibliotecas cliente de Error Reporting.

En la consola de Google Cloud, puedes ver los errores informados en Error Reporting. También puedes ver los errores informados de una función en particular cuando la seleccionas en la lista de funciones de la consola de Google Cloud.

Las excepciones sin detectar que genere la función aparecerán en Error Reporting. Ten en cuenta que algunos tipos de excepciones sin detectar (como las que se muestran de forma asíncrona) provocarán un inicio en frío en una invocación de función futura. Esto aumentará la cantidad de tiempo que demorará en ejecutarse tu función.

Informa errores manualmente

Enviando a Cloud Logging

La función error del SDK de registrador de Cloud Functions informará errores a Cloud Logging y a Error Reporting. Para incluir más contexto del error como datos estructurados, pasa un objeto de error como el segundo argumento:

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