Theo dõi và bảo vệ ứng dụng web

Sau khi phát hành ứng dụng, bạn nên theo dõi và bảo mật ứng dụng:

Theo dõi hiệu suất của trang web bằng khả năng ghi nhận của App Hosting

Bảng điều khiển Tổng quan về ứng dụng trong Firebase Studio cung cấp các chỉ số và thông tin chính về ứng dụng, giúp bạn theo dõi hiệu suất của ứng dụng web bằng các công cụ quan sát tích hợp sẵn của App Hosting. Sau khi trang web của bạn ra mắt, bạn có thể truy cập vào trang tổng quan bằng cách nhấp vào Xuất bản. Trong bảng điều khiển này, bạn có thể:

  • Nhấp vào Xuất bản để phát hành phiên bản mới của ứng dụng.
  • Chia sẻ đường liên kết đến ứng dụng của bạn hoặc mở ứng dụng trực tiếp trong phần Truy cập vào ứng dụng của bạn.
  • Xem thông tin tóm tắt về hiệu suất của ứng dụng trong 7 ngày qua, bao gồm tổng số yêu cầu và trạng thái của lần phát hành mới nhất. Nhấp vào Xem chi tiết để xem thêm thông tin trong bảng điều khiển Firebase.
  • Xem biểu đồ về số lượng yêu cầu mà ứng dụng của bạn đã nhận được trong 24 giờ qua, được phân tích theo mã trạng thái HTTP.
  • Xem trạng thái kích hoạt của các dịch vụ Firebase như Firebase Authentication và Cloud Firestore.

Nếu đóng bảng Tổng quan về ứng dụng, bạn có thể mở lại bảng này bất cứ lúc nào bằng cách nhấp vào Xuất bản.

Tìm hiểu thêm về cách quản lý và giám sát việc phát hành App Hosting tại phần Quản lý việc phát hành và bản phát hành.

Giám sát Genkit cho các tính năng đã triển khai

Bạn có thể theo dõi các bước, dữ liệu đầu vào và dữ liệu đầu ra của tính năng Genkit bằng cách bật tính năng đo từ xa cho mã luồng AI. Tính năng đo từ xa cho Genkit cho phép bạn theo dõi hiệu suất và mức sử dụng của các luồng AI. Dữ liệu này có thể giúp bạn xác định những điểm cần cải thiện, khắc phục sự cố, tối ưu hoá câu lệnh và quy trình để đạt hiệu suất và hiệu quả chi phí cao hơn, đồng thời theo dõi mức sử dụng quy trình theo thời gian.

Để thiết lập tính năng giám sát trong Genkit, bạn thêm dữ liệu đo từ xa vào các luồng AI của Genkit, sau đó xem kết quả trong bảng điều khiển Firebase.

Bước 1: Thêm dữ liệu đo từ xa vào mã luồng Genkit trong Firebase Studio

Cách thiết lập tính năng giám sát trong mã:

  1. Nếu bạn chưa ở chế độ xem Code, hãy nhấp vào Biểu tượng chuyển đổi mã Switch to Code (Chuyển sang mã) để mở chế độ xem này.

  2. Kiểm tra package.json để xác minh phiên bản Genkit đã cài đặt.

  3. Mở cửa sổ dòng lệnh (Ctrl-Shift-C hoặc Cmd-Shift-C trong MacOS).

  4. Nhấp vào bên trong thiết bị đầu cuối và cài đặt trình bổ trợ Firebase, sử dụng phiên bản khớp với tệp package.json của bạn. Ví dụ: nếu các gói Genkit trong package.json của bạn ở phiên bản 1.0.4, thì bạn nên chạy lệnh sau để cài đặt trình bổ trợ:

    npm i --save @genkit-ai/firebase@1.0.4

  5. Trong Trình khám phá, hãy mở rộng src > ai > flows. Một hoặc nhiều tệp TypeScript chứa các luồng Genkit của bạn sẽ xuất hiện trong thư mục flows.

  6. Nhấp vào một trong các quy trình để mở quy trình đó.

  7. Ở cuối phần nhập của tệp, hãy thêm nội dung sau để nhập và bật FirebaseTelemetry:

    import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry();

Bước 2: Thiết lập quyền

Firebase Studio đã bật các API bắt buộc cho bạn khi thiết lập dự án Firebase, nhưng bạn cũng cần cấp quyền cho tài khoản dịch vụ App Hosting.

Cách thiết lập quyền:

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến trang IAM rồi chọn dự án Firebase của bạn.

  2. Cấp các vai trò sau cho tài khoản dịch vụ App Hosting:

    • Monitoring Metric Writer (roles/monitoring.metricWriter)
    • Tác nhân Cloud Trace (roles/cloudtrace.agent)
    • Người ghi nhật ký (roles/logging.logWriter)

  3. Xuất bản lại ứng dụng của bạn lên App Hosting.

  4. Khi quá trình xuất bản hoàn tất, hãy tải ứng dụng của bạn và bắt đầu sử dụng. Sau 5 phút, ứng dụng của bạn sẽ bắt đầu ghi dữ liệu đo từ xa.

Bước 3: Theo dõi các tính năng AI tạo sinh trên bảng điều khiển Firebase

Khi dữ liệu đo từ xa được định cấu hình, Genkit sẽ ghi lại số lượng yêu cầu, mức độ thành công và độ trễ cho tất cả các luồng của bạn, đồng thời, đối với từng luồng cụ thể, Genkit sẽ thu thập các chỉ số về độ ổn định, hiển thị biểu đồ chi tiết và ghi nhật ký dấu vết đã ghi lại.

Cách theo dõi các tính năng AI được triển khai bằng Genkit:

  1. Sau 5 phút, trong bảng điều khiển Firebase, hãy chuyển đến Dịch vụ AI > Genkit để xem lại câu lệnh và phản hồi từ Genkit.

  2. Bạn có thể xem các Chỉ số về độ ổn định sau đây do Genkit tổng hợp:

    • Tổng số yêu cầu: Tổng số yêu cầu mà quy trình của bạn nhận được.
    • Tỷ lệ thành công: Tỷ lệ phần trăm yêu cầu được xử lý thành công.
    • Độ trễ ở bách phân vị thứ 95: Độ trễ ở bách phân vị thứ 95 của luồng, tức là thời gian cần thiết để xử lý 95% yêu cầu.

    • Mức sử dụng mã thông báo:

      • Mã thông báo đầu vào: Số lượng mã thông báo được gửi đến mô hình trong câu lệnh.
      • Số token đầu ra: Số token do mô hình tạo ra trong phản hồi.

    • Cách sử dụng hình ảnh:

      • Hình ảnh đầu vào: Số lượng hình ảnh được gửi đến mô hình trong câu lệnh.
      • Hình ảnh đầu ra: Số lượng hình ảnh do mô hình tạo ra trong câu trả lời.

  3. Bạn có thể mở rộng các chỉ số về độ ổn định để xem các biểu đồ chi tiết sau:

    • Số lượng yêu cầu theo thời gian.
    • Tỷ lệ thành công theo thời gian.
    • Số token đầu vào và đầu ra theo thời gian.
    • Độ trễ (bách phân vị thứ 95 và 50) theo thời gian.

Tìm hiểu thêm về Genkit trong tài liệu của họ.

Bảo vệ ứng dụng của bạn bằng Firebase App Check

Nếu bạn đã tích hợp các dịch vụ của Firebase hoặc Google Cloud vào ứng dụng của mình, thì Firebase App Check sẽ giúp bảo vệ phần phụ trợ của ứng dụng khỏi hành vi sai trái bằng cách ngăn các ứng dụng khách trái phép truy cập vào tài nguyên Firebase của bạn. Tính năng này hoạt động với cả các dịch vụ của Google (bao gồm cả dịch vụ Firebase và Google Cloud) và các phần phụ trợ tuỳ chỉnh của riêng bạn để đảm bảo an toàn cho tài nguyên.

Bạn nên thêm App Check vào bất kỳ ứng dụng nào bạn đăng công khai để bảo vệ tài nguyên phụ trợ khỏi hành vi sai trái.

Phần này hướng dẫn bạn cách thiết lập App Check trong Firebase Studio bằng reCAPTCHA Enterprise cho một ứng dụng web do App Prototyping agent tạo, nhưng bạn có thể thiết lập App Check trong bất kỳ ứng dụng nào triển khai các dịch vụ của Firebase và có thể triển khai các nhà cung cấp tuỳ chỉnh. Tìm hiểu thêm tại Firebase App Check.

reCAPTCHA Enterprise cung cấp tối đa 10.000 lượt đánh giá miễn phí.

Bước 1: Thiết lập reCAPTCHA Enterprise cho ứng dụng của bạn

  1. Mở phần reCAPTCHA Enterprise trong bảng điều khiển Google Cloud.

  2. Chọn tên dự án Firebase của bạn trong bộ chọn dự án của bảng điều khiển Google Cloud.

  3. Nếu bạn được nhắc bật reCAPTCHA Enterprise API, hãy bật API này.

  4. Nhấp vào Bắt đầu rồi thêm Tên hiển thị cho khoá trang web reCAPTCHA của bạn.

  5. Chấp nhận khoá Application type (Loại ứng dụng) Web mặc định.

  6. Nhấp vào Thêm miền rồi thêm một miền. Bạn nên thêm miền App Hosting (ví dụ: studio--PROJECT_ID.REGION.hosted.app) và mọi miền tuỳ chỉnh mà bạn sử dụng hoặc dự định sử dụng với ứng dụng của mình.

  7. Nhấp vào Bước tiếp theo.

  8. Bỏ chọn Will you use challenges? (Bạn có sử dụng thử thách không?).

  9. Nhấp vào Tạo khoá.

  10. Sao chép và lưu Mã khoá rồi chuyển sang bước Định cấu hình App Check.

Bước 2: Định cấu hình App Check

  1. Mở bảng điều khiển Firebase rồi nhấp vào Build (Xây dựng) > App Check (Kiểm tra ứng dụng) trong trình đơn điều hướng.

  2. Nhấp vào Bắt đầu, rồi nhấp vào Đăng ký bên cạnh ứng dụng của bạn.

  3. Nhấp để mở rộng reCAPTCHA rồi dán Mã khoá mà bạn đã tạo cho reCAPTCHA Enterprise.

  4. Nhấp vào Lưu.

Bước 3: Thêm App Check vào mã của bạn

  1. Quay lại Firebase Studio và trong chế độ xem Code, hãy thêm khoá trang web mà bạn đã tạo vào tệp .env:

    NEXT_PUBLIC_RECAPTCHA_SITE_KEY=RECAPTCHA_SITE_KEY

  2. Nếu bạn chưa lưu cấu hình Firebase vào .env, hãy lấy cấu hình đó:

    • Trên bảng điều khiển của Firebase, hãy mở phần Cài đặt dự án rồi tìm mã này trong mục tương ứng với ứng dụng của bạn.

    • Trong chế độ xem Code của Terminal:

      1. Đăng nhập vào Firebase: firebase auth login
      2. Chọn dự án của bạn: firebase use FIREBASE_PROJECT_ID
      3. Lấy cấu hình Firebase: firebase apps:sdkconfig

  3. Thêm cấu hình vào tệp .env để cấu hình đó có dạng như sau:

    NEXT_PUBLIC_FIREBASE_API_KEY=FIREBASE_API_KEY
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=FIREBASE_AUTH_DOMAIN
NEXT_PUBLIC_FIREBASE_PROJECT_ID=FIREBASE_PROJECT_ID
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=FIREBASE_STORAGE_BUCKET
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=FIREBASE_MESSAGING_SENDER_ID
NEXT_PUBLIC_FIREBASE_APP_ID=FIREBASE_APP_ID
NEXT_PUBLIC_RECAPTCHA_SITE_KEY=RECAPTCHA_SITE_KEY

  4. Thêm App Check vào mã ứng dụng. Bạn có thể yêu cầu Gemini thêm App Check bằng reCAPTCHA Enterprise vào ứng dụng của mình (nhớ chỉ định "reCAPTCHA Enterprise" và nhớ kiểm tra kỹ!), hoặc làm theo các bước trong phần Khởi chạy App Check.

  5. Xuất bản lại trang web của bạn lên App Hosting. Hãy thử kiểm thử các tính năng xác thực và cơ sở dữ liệu để tạo một số dữ liệu.

  6. Xác minh rằng App Check đang nhận được yêu cầu trong bảng điều khiển Firebase bằng cách mở Build (Xây dựng) > App Check (Kiểm tra ứng dụng).

  7. Nhấp để kiểm tra Cloud Firestore. Sau khi bạn xác minh rằng các yêu cầu đã đến, hãy nhấp vào Thực thi để thực thi App Check.

  8. Lặp lại quy trình xác minh và thực thi cho Firebase Authentication.

Nếu sau khi đăng ký ứng dụng cho App Check, bạn muốn chạy ứng dụng trong một môi trường mà App Check thường không phân loại là hợp lệ, chẳng hạn như môi trường cục bộ trong quá trình phát triển hoặc từ môi trường tích hợp liên tục (CI), thì bạn có thể tạo một bản gỡ lỗi của ứng dụng sử dụng nhà cung cấp dịch vụ gỡ lỗi App Check thay vì nhà cung cấp dịch vụ chứng thực thực tế. Tìm hiểu thêm tại bài viết Sử dụng App Check với nhà cung cấp dịch vụ gỡ lỗi trong ứng dụng web.

Các bước tiếp theo