Erros de relatório

Relatando erros automaticamente

Você pode emitir um erro de uma função do Cloud para o Error Reporting , conforme mostrado abaixo:

// These WILL be reported to Error Reporting
throw new Error('I failed you'); // Will cause a cold start if not caught
@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)

Se desejar relatórios de erros mais detalhados, você pode usar as bibliotecas cliente do Error Reporting .

Você pode visualizar os erros relatados no Error Reporting no Console do GCP. Você também pode ver os erros relatados de uma função específica ao selecioná-la na lista de funções no Console do GCP.

As exceções não detectadas produzidas pela sua função aparecerão no Error Reporting. Observe que alguns tipos de exceções não detectadas (como aquelas lançadas de forma assíncrona) causarão a ocorrência de uma inicialização a frio em uma invocação de função futura. Isso aumenta a quantidade de tempo que sua função levará para ser executada.

Relatando erros manualmente

Importando dependências

Para relatar um erro de uma função ao Error Reporting , importe a função error do SDK do agente de log do Cloud Functions:

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

Enviando para o Cloud Logging

A função error do SDK do agente de log do Cloud Functions reportará erros ao Cloud Logging e ao Error Reporting . Para incluir mais contexto do erro como dados estruturados , passe um objeto de erro como segundo argumento:

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