Bắt đầu sử dụng Key Visualizer

Trang này mô tả cách sử dụng Key Visualizer để kiểm tra các vấn đề về hiệu suất liên quan đến mẫu sử dụng Cloud Firestore.

Trước khi bắt đầu

Để sử dụng Trình trực quan hoá khoá cho Cloud Firestore, bạn phải bật API Trình trực quan hoá khoá Firestore.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Vai trò bắt buộc

Đảm bảo rằng tài khoản của bạn được cấp một trong các vai trò IAM sau:

  • Chủ sở hữu Cloud Datastore
  • Người xem Key Visualizer trong Cloud Datastore
  • Người chỉnh sửa
  • Chủ sở hữu

Các vai trò này bao gồm những quyền IAM sau đây (bắt buộc để truy cập vào Key Visualizer):

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

Bạn cũng có thể xác định một vai trò tuỳ chỉnh có các quyền bắt buộc.

Xem bản quét trong một khoảng thời gian

Mỗi lần quét bằng Key Visualizer kéo dài trong 2 giờ. Bạn có thể quét trong một khoảng thời gian nhất định đối với những cơ sở dữ liệu có lưu lượng truy cập vượt quá 3.000 thao tác trên tài liệu trong một phút bất kỳ trong khoảng thời gian đó.

Cách chạy Key Visualizer:

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Cơ sở dữ liệu.

    Chuyển đến phần Cơ sở dữ liệu

  2. Chọn cơ sở dữ liệu cần thiết trong danh sách cơ sở dữ liệu.

  3. Trong trình đơn điều hướng, hãy nhấp vào Key Visualizer.

  4. Chọn một khoảng thời gian và một chỉ số trong số các bản quét Key Visualizer có sẵn:

    1. Nhấp vào biểu tượng Bút chì ở trên cùng bên phải. Chọn Ngày và Khoảng thời gian.

      Bạn có thể quét dựa trên điều kiện quét. Bạn không thể chọn khoảng thời gian không đủ điều kiện quét hoặc vẫn đang xử lý. Hai lần quét gần đây nhất trong ngày sẽ mất một chút thời gian để xử lý trước khi có thể xem được.

    2. Chọn Tất cả dữ liệu trong tài liệu hoặc Tất cả dữ liệu chỉ mục làm nguồn.

    3. Nhấp vào Cập nhật.

  5. Chọn một chỉ số để phân tích:

    Nhấp vào trình đơn thả xuống về chỉ số ở trên cùng bên trái rồi chọn một chỉ số để xem. Key Visualizer sẽ mở trong chỉ số Ops/s cho khoá tài liệu và chỉ số Index Write Ops/s cho khoá chỉ mục theo mặc định.

Để so sánh các chỉ số hoặc tìm mối tương quan dữ liệu, bạn có thể hiển thị nhiều chỉ số Key Visualizer cùng nhau. Xem phần Tìm mối liên hệ giữa các chỉ số.

Xem thông tin tổng quan về hoạt động

Để xem thông tin tổng quan về hoạt động trong khoảng thời gian 2 giờ đã chọn, hãy xem biểu đồ nhiệt cho chỉ số mặc định.

Ví dụ sau đây cho thấy một bản đồ nhiệt có sự khác biệt lớn về mẫu sử dụng cho các dải khoá khác nhau:

  • Các dải màu tối có ít hoặc không có hoạt động.
  • Các phạm vi có màu sáng có hoạt động nhiều hơn đáng kể.
  • Phạm vi màu trắng phát sáng ở giữa có hoạt động rất cao.

Ví dụ về một lượt quét bằng Key Visualizer

Quét khoá tài liệu

Chỉ số Số thao tác/giây đo lường số lượng yêu cầu mỗi giây cho từng dải khoá. Chỉ số này là tổng của các yêu cầu ghi, tra cứu và truy vấn. Key Visualizer cho thấy chỉ số này theo mặc định khi bạn mở một bản đồ nhiệt.

Sau khi nắm được ý tưởng về hoạt động tổng thể trong cơ sở dữ liệu, bạn có thể tiếp tục điều tra bằng cách xem xét các chỉ số khác và tập trung vào các phạm vi chính có thể gây ra vấn đề. Tìm hiểu thêm.

Quét khoá chỉ mục

Chỉ số Index Write Ops/s tại một ô nhất định đo lường số lượt ghi chỉ mục trung bình mỗi giây trong khoảng thời gian 10 giây và phạm vi khoá tương ứng.

Bước tiếp theo