Fehler bei der Laufzeitfunktion melden

Sie sollten Laufzeitfehler, die in Cloud Run Functions auftreten, verarbeiten und melden. Nicht abgefangene Ausnahmen oder Ausführungen, die den Prozess abstürzen, können zu Kaltstarts führen, die Sie in der Regel versuchen sollten, zu minimieren.

Die richtige Art der Fehlersignalisierung hängt vom Funktionstyp ab:

  • HTTP-Funktionen sollten HTTP-Statuscodes zurückgeben, die den Fehler anzeigen. Weitere Informationen finden Sie unter HTTP-Funktionen.

  • Ereignisgesteuerte Funktionen sollten eine Fehlermeldung protokollieren und zurückgeben. Weitere Informationen finden Sie unter Ereignisgesteuerte Funktionen schreiben.

Wenn Fehler ordnungsgemäß verarbeitet werden, können Funktionsinstanzen, die Fehler haben, aktiv bleiben und für Anfragen verfügbar sein.

Fehler an Error Reporting ausgeben

Sie können Fehler einer Cloud Run Function wie unten gezeigt an Error Reporting ausgeben:

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");
  }
}

Wenn Sie genauere Fehlerberichte benötigen, können Sie Clientbibliotheken für Error Reporting verwenden.

Die gemeldeten Fehler können Sie unter Stackdriver Error Reporting in der Google Cloud Console ansehen. Sie können auch die von einer bestimmten Funktion gemeldeten Fehler sehen. Dazu wählen Sie diese aus der Funktionsliste in der Google Cloud Console aus.

Nicht abgefangene Ausnahmen, die von Ihrer Funktion generiert wurden, werden in Error Reporting angezeigt. Einige Arten von nicht abgefangenen Ausnahmen (z. B. solche, die asynchron ausgelöst werden) führen zu einem Kaltstart bei einem zukünftigen Funktionsaufruf. Dies verlängert die Ausführungsdauer der Funktion.