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

Trang này mô tả cách sử dụng Trình hiển thị khoá để kiểm tra các vấn đề về hiệu suất liên quan đến kiểu sử dụng Cloud Firestore của bạn.

Trước khi bắt đầu

Để sử dụng Trình hiển thị khoá cho Cloud Firestore, bạn phải bật API Trình hiển thị khoá Firestore.

Các vai trò cần thiết để bật API

Để bật API, bạn cần có quyền serviceusage.services.enable. Nếu bạn đã tạo dự án, thì có thể bạn đã có quyền này thông qua vai trò Chủ sở hữu (roles/owner). Nếu không, bạn có thể nhận được quyền này thông qua vai trò Quản trị viên sử dụng dịch vụ (roles/serviceusage.serviceUsageAdmin). Tìm hiểu cách cấp vai trò.

Bật 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 Cloud Datastore Key Visualizer
  • 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, cần thiết để 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 vai trò tuỳ chỉnh có các quyền cần thiết.

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

Mỗi lần quét của Trình hiển thị khoá sẽ bao gồm khoảng thời gian hai 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 tài liệu trong bất kỳ phút nào trong khoảng thời gian đó.

Cách chạy Key Visualizer:

  1. Trong Google Cloud Console, hãy chuyển đến trang Databases (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 có sẵn của Key Visualizer:

    1. Nhấp vào biểu tượng Bút chì ở phía trên 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 những khoảng thời gian không đủ điều kiện quét hoặc vẫn đang được 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ó kết quả.

    2. Chọn Tất cả dữ liệu 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ố ở phía trên bên trái rồi chọn một chỉ số để xem. Theo mặc định, Trình hiển thị khoá sẽ mở trong chỉ số Ops/s (Số thao tác/giây) cho khoá tài liệu và chỉ số Index Write Ops/s (Số thao tác ghi chỉ mục/giây) cho khoá chỉ mục.

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

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 bản đồ 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ô hình sử dụng cho các dải khoá khác nhau:

  • Các dải màu tối cho biết có ít hoặc không có hoạt động.
  • Các dải 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ần quét bằng Trình hiển thị khoá

Quét khoá tài liệu

Chỉ số Ops/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 số yêu cầu ghi, tra cứu và truy vấn. Theo mặc định, Key Visualizer sẽ hiển thị chỉ số này khi bạn mở bản đồ nhiệt.

Sau khi nắm được thông tin tổng quan về hoạt động trong cơ sở dữ liệu, bạn có thể tiếp tục điều tra bằng cách xem các chỉ số khác và tập trung vào những 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 (Số thao tác ghi chỉ mục/giây) 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à dải khoá tương ứng.

Bước tiếp theo