Giám sát Genkit: Khắc phục sự cố

Các phần sau đây trình bày chi tiết các giải pháp cho các vấn đề thường gặp mà nhà phát triển gặp phải khi sử dụng tính năng Theo dõi Genkit của Firebase.

Tôi không thấy dấu vết hoặc chỉ số trong tính năng Theo dõi Genkit của Firebase

  1. Đảm bảo bạn đã bật các API sau cho dự án Google Cloud cơ bản:
  2. Đảm bảo rằng các vai trò sau đây được áp dụng cho tài khoản dịch vụ đang chạy mã của bạn (hoặc tài khoản dịch vụ đã được định cấu hình trong các tuỳ chọn trình bổ trợ) trong Cloud IAM.
    • Trình ghi chỉ số giám sát (roles/monitoring.metricWriter)
    • Trình theo dõi trên đám mây (roles/cloudtrace.agent)
    • Trình ghi nhật ký (roles/logging.logWriter)

  3. Kiểm tra nhật ký ứng dụng để tìm lỗi ghi vào tính năng Nhật ký trên đám mây, Theo dõi trên đám mây và Giám sát trên đám mây. Trên cơ sở hạ tầng Google Cloud như Firebase Functions và Cloud Run, ngay cả khi dữ liệu đo từ xa được định cấu hình không chính xác, nhật ký đến stdout/stderr sẽ tự động được Trình thu thập dữ liệu nhật ký trên đám mây nhập, cho phép bạn chẩn đoán các vấn đề trong Cloud Logging Console.

  4. Gỡ lỗi cục bộ:

    Bật tính năng xuất cho nhà phát triển:

    enableFirebaseTelemetry({
  forceDevExport: true
});

    Để kiểm thử bằng thông tin xác thực người dùng cá nhân, hãy sử dụng gcloud CLI để xác thực với Google Cloud. Việc này có thể giúp chẩn đoán các API đã bật hoặc tắt, nhưng không kiểm thử thông tin đăng nhập mặc định của ứng dụng xác thực gcloud.

    Ngoài ra, việc mạo danh tài khoản dịch vụ cho phép bạn kiểm thử quyền truy cập giống như trong môi trường thực tế. Bạn phải áp dụng vai trò IAM roles/iam. serviceAccountTokenCreator cho tài khoản người dùng của mình để mạo danh tài khoản dịch vụ:

    gcloud auth application-default login --impersonate-service-account <SERVICE_ACCT_EMAIL>

    Hãy xem tài liệu về ADC để biết thêm thông tin.

Độ tin cậy của tính năng tải dữ liệu đo từ xa lên trong Firebase Functions / Cloud Run

Khi Genkit được lưu trữ trong Google Cloud Run (bao gồm cả Cloud Functions cho Firebase), tính năng tải dữ liệu đo từ xa lên có thể kém tin cậy hơn vì vùng chứa chuyển sang trạng thái vòng đời "rảnh". Nếu bạn cần độ tin cậy cao hơn, hãy cân nhắc thay đổi chế độ phân bổ CPU thành luôn được phân bổ trong Google Cloud Console.