Comunique erros de funções de tempo de execução (1.ª geração)

Deve processar e comunicar erros de tempo de execução que ocorram em funções do Cloud Run. As exceções não processadas ou as execuções que falham o processo podem resultar em inícios a frio, que deve tentar minimizar.

A forma recomendada de uma função sinalizar um erro depende do tipo de função:

• As funções HTTP devem devolver códigos de estado HTTP adequados que denotam um erro. Consulte as funções HTTP para mais informações.

• As funções acionadas por eventos devem registar e devolver uma mensagem de erro. Consulte o artigo Escreva funções orientadas por eventos para mais informações.

Se os erros forem processados adequadamente, as instâncias de funções que encontrem erros podem permanecer ativas e disponíveis para processar pedidos.

Emitir erros para o Error Reporting

Pode emitir um erro a partir de uma função do Cloud Run para o Error Reporting, conforme mostrado no seguinte:

Node.js

// These WILL be reported to Error Reporting
throw new Error('I failed you'); // Will cause a cold start if not caught

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)

Go

package tips

import (
	"fmt"
	"net/http"
	"os"

	"github.com/GoogleCloudPlatform/functions-framework-go/functions"
)

func init() {
	functions.HTTP("HTTPError", HTTPError)
}

// HTTPError describes how errors are handled in an HTTP function.
func HTTPError(w http.ResponseWriter, r *http.Request) {
	// An error response code is NOT reported to Error Reporting.
	// http.Error(w, "An error occurred", http.StatusInternalServerError)

	// Printing to stdout and stderr is NOT reported to Error Reporting.
	fmt.Println("An error occurred (stdout)")
	fmt.Fprintln(os.Stderr, "An error occurred (stderr)")

	// Calling log.Fatal sets a non-zero exit code and is NOT reported to Error
	// Reporting.
	// log.Fatal("An error occurred (log.Fatal)")

	// Panics are reported to Error Reporting.
	panic("An error occurred (panic)")
}

Java

import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import java.io.IOException;
import java.util.logging.Logger;

public class HelloError implements HttpFunction {

  private static final Logger logger = Logger.getLogger(HelloError.class.getName());

  @Override
  public void service(HttpRequest request, HttpResponse response)
      throws IOException {
    // These will NOT be reported to Error Reporting
    System.err.println("I failed you");
    logger.severe("I failed you");

    // This WILL be reported to Error Reporting
    throw new RuntimeException("I failed you");
  }
}

Se quiser relatórios de erros mais detalhados, pode usar as bibliotecas cliente de relatórios de erros.

Pode ver os erros comunicados em Relatórios de erros na Google Cloud consola. Também pode ver os erros comunicados por uma função específica quando a seleciona na lista de funções na Google Cloud consola.

As exceções não processadas produzidas pela sua função aparecem nos Relatórios de erros. Tenha em atenção que alguns tipos de exceções não capturadas (como as lançadas de forma assíncrona) fazem com que ocorra um início a frio numa invocação de função futura. Isto aumenta o tempo que a sua função demora a ser executada.