Relatar erros


Como relatar erros automaticamente

É possível informar um erro de uma função ao Error Reporting, conforme mostrado abaixo:

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

Para ter relatórios de erros mais detalhados, use as bibliotecas de cliente do Error Reporting.

Para ver os erros registrados, use o Error Reporting no console do Google Cloud. Também é possível ver os erros registrados de uma função específica quando a seleciona na lista de funções no console do Google Cloud.

As exceções não identificadas que foram produzidas pela função serão exibidas no Error Reporting. Alguns tipos de exceções não identificadas (como as geradas de forma assíncrona) farão com que uma inicialização a frio ocorra em uma invocação futura de uma função. Isso aumenta o tempo de execução da função.

Como relatar erros manualmente

Como fazer envios para Cloud Logging

A função error do SDK do logger do Cloud Functions vai informar erros ao Cloud Logging e ao Error Reporting. Para incluir mais contexto sobre o erro no formato de dados estruturados, transmita um objeto de erro como o 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
  );
}