Melaporkan error fungsi runtime

Anda harus menangani dan melaporkan error runtime yang terjadi di Cloud Functions. Pengecualian yang tidak diketahui atau eksekusi yang menyebabkan error pada proses dapat menyebabkan cold start, yang umumnya harus Anda coba minimalkan.

Cara yang direkomendasikan agar fungsi mendeteksi error bergantung pada jenis fungsi:

• Fungsi HTTP akan menampilkan kode status HTTP yang sesuai, yang menunjukkan error. Lihat Fungsi HTTP untuk informasi lebih lanjut.

• Fungsi berbasis peristiwa harus mencatat dan menampilkan pesan error. Lihat Fungsi Latar Belakang dan Fungsi CloudEvent untuk mengetahui informasi selengkapnya.

Jika error ditangani dengan tepat, instance fungsi yang mengalami error dapat tetap aktif dan tersedia untuk melayani permintaan.

Peringatan: Pada runtime Node.js, Python, dan Go Cloud Functions (generasi ke-2), pengecualian yang tidak tertangani muncul sebagai respons terhadap pemanggil fungsi. Ini termasuk fungsi yang tidak diautentikasi (publik) — tinjau pesan pengecualian untuk memastikan pesan tersebut tidak berisi informasi yang tidak ingin Anda tunjukkan kepada pemanggil.

Melaporkan error ke Error Reporting

Anda dapat melaporkan error dari Cloud Function ke Error Reporting seperti yang ditunjukkan di bawah ini:

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

Jika Anda ingin pelaporan error yang lebih mendetail, gunakan library klien Error Reporting .

Anda dapat melihat error yang dilaporkan di Error Reporting pada konsol Google Cloud. Anda juga dapat melihat error yang dilaporkan dari fungsi tertentu dengan memilihnya dari daftar fungsi di konsol Google Cloud.

Pengecualian yang tidak tertangkap yang dihasilkan oleh fungsi Anda akan muncul di Error Reporting. Perhatikan bahwa beberapa jenis pengecualian yang tidak tertangkap (seperti yang ditampilkan secara asinkron) akan menyebabkan cold start terjadi pada pemanggilan fungsi di masa mendatang. Ini akan meningkatkan jumlah waktu yang diperlukan untuk menjalankan fungsi.