Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Segnalare gli errori delle funzioni di runtime
Devi gestire e segnalare gli errori di runtime che si verificano nelle funzioni Cloud Run.
Eccezioni non rilevate o esecuzioni che arrestano in modo anomalo il processo possono comportare
avvii a freddo,
che in genere dovresti cercare di ridurre al minimo.
Il modo consigliato per segnalare un errore da parte di una funzione dipende dal tipo di funzione:
Le funzioni HTTP devono restituire codici di stato HTTP appropriati che indicano un errore. Per ulteriori informazioni, consulta Funzioni HTTP.
Le funzioni basate su eventi devono registrare e restituire un messaggio di errore. Per saperne di più, consulta Scrivere funzioni basate sugli eventi.
Se gli errori vengono gestiti correttamente, le istanze di funzione che riscontrano errori possono rimanere attive e disponibili per l'elaborazione delle richieste.
Emettere errori in Error Reporting
Puoi emettere un errore da una funzione Cloud Run in Error Reporting come mostrato di seguito:
Node.js
// These WILL be reported to Error ReportingthrownewError('I failed you');// Will cause a cold start if not caught
Python
@functions_framework.httpdefhello_error_1(request):# This WILL be reported to Error Reporting,# and WILL NOT show up in logs or# terminate the function.fromgoogle.cloudimporterror_reportingclient=error_reporting.Client()try:raiseRuntimeError("I failed you")exceptRuntimeError:client.report_exception()# This WILL be reported to Error Reporting,# and WILL terminate the functionraiseRuntimeError("I failed you")@functions_framework.httpdefhello_error_2(request):# These errors WILL NOT be reported to Error# Reporting, but will show up in logs.importloggingimportsysprint(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.fromflaskimportabortreturnabort(500)
Vai
packagetipsimport("fmt""net/http""os""github.com/GoogleCloudPlatform/functions-framework-go/functions")funcinit(){functions.HTTP("HTTPError",HTTPError)}// HTTPError describes how errors are handled in an HTTP function.funcHTTPError(whttp.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
importcom.google.cloud.functions.HttpFunction;importcom.google.cloud.functions.HttpRequest;importcom.google.cloud.functions.HttpResponse;importjava.io.IOException;importjava.util.logging.Logger;publicclassHelloErrorimplementsHttpFunction{privatestaticfinalLoggerlogger=Logger.getLogger(HelloError.class.getName());@Overridepublicvoidservice(HttpRequestrequest,HttpResponseresponse)throwsIOException{// These will NOT be reported to Error ReportingSystem.err.println("I failed you");logger.severe("I failed you");// This WILL be reported to Error ReportingthrownewRuntimeException("I failed you");}}
Puoi visualizzare gli errori segnalati in Error Reporting
nella console Google Cloud. Puoi anche visualizzare gli errori segnalati da una determinata funzione quando la selezioni dall'elenco delle funzioni nella console Google Cloud.
Le eccezioni non rilevate prodotte dalla funzione verranno visualizzate in Error Reporting.
Tieni presente che alcuni tipi di eccezioni non rilevate (ad esempio quelle lanciate in modo asincrono) causeranno un avvio a freddo al successivo richiamo della funzione. Ciò aumenta il tempo necessario per l'esecuzione della funzione.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-04-11 UTC."],[[["Cloud Run functions should handle and report runtime errors to prevent cold starts and maintain availability."],["HTTP functions should use appropriate HTTP status codes to signal errors, while event-driven functions should log and return error messages."],["Unhandled exceptions in Node.js, Python, and Go runtimes are surfaced to the function caller and should be reviewed to ensure no sensitive information is exposed."],["Errors can be emitted to Error Reporting using language-specific methods, and some methods, like raising an exception, will both report and terminate the function, while other approaches may not terminate it."],["Uncaught exceptions are reported in Error Reporting and can lead to cold starts, which increase function execution time, so it's best to try to handle errors."]]],[]]