Báo cáo lỗi

Tự động báo cáo lỗi

Bạn có thể phát ra một lỗi từ một hàm đến Error Reporting như minh hoạ bên dưới:

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)

Nếu muốn báo cáo lỗi chi tiết hơn, bạn có thể sử dụng thư viện ứng dụng Error Reporting.

Bạn có thể xem các lỗi đã báo cáo trong Error Reporting trong bảng điều khiển Cloud. Bạn cũng có thể xem các lỗi được báo cáo từ a hàm cụ thể khi chọn hàm đó từ danh sách hàm trong bảng điều khiển Cloud.

Các ngoại lệ chưa được xử lý do hàm của bạn tạo ra sẽ xuất hiện trong Error Reporting. Xin lưu ý rằng một số loại ngoại lệ chưa được xử lý (chẳng hạn như các ngoại lệ được gửi không đồng bộ) sẽ khiến quá trình khởi động nguội xảy ra khi gọi hàm trong tương lai. Điều này làm tăng thời gian chạy hàm.

Báo cáo lỗi theo cách thủ công

Nhập phần phụ thuộc

Để báo cáo lỗi cho Error Reporting từ một hàm, hãy nhập hàm error từ Cloud Functions logger SDK:

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

Gửi đến Cloud Logging

Hàm error từ Cloud Functions logger SDK sẽ báo cáo lỗi cho cả Cloud Logging và Error Reporting. Để đưa thêm ngữ cảnh từ lỗi dưới dạng dữ liệu có cấu trúc, hãy truyền một đối tượng lỗi làm đối số thứ hai:

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