Trang này mô tả cách sử dụng các chỉ số Cloud Monitoring cho Cloud Firestore để theo dõi cơ sở dữ liệu của bạn.
Các chỉ số Cloud Monitoring cho Cloud Firestore
Các phần sau đây cung cấp thông tin tổng quan về các chỉ số hiện có cho Cloud Firestore.
Tài nguyên được theo dõi
Tài nguyên được theo dõi trong Cloud Monitoring đại diện cho một thực thể logic hoặc thực thể vật lý , chẳng hạn như máy ảo, cơ sở dữ liệu hoặc ứng dụng. Tài nguyên được theo dõi chứa một tập hợp chỉ số riêng biệt mà bạn có thể khám phá, báo cáo thông qua trang tổng quan hoặc dùng để tạo cảnh báo. Mỗi tài nguyên cũng có một tập hợp nhãn tài nguyên. Đây là các cặp khoá-giá trị chứa thông tin bổ sung về tài nguyên. Nhãn tài nguyên có sẵn cho tất cả các chỉ số được liên kết với tài nguyên.
Khi sử dụng Cloud Monitoring API, Cloud Firestore hiệu suất sẽ được theo dõi bằng tài nguyên sau:
| Tài nguyên | Nội dung mô tả |
firestore.googleapis.com/Database | Loại tài nguyên được theo dõi cung cấp thông tin chi tiết cho project,
location, và database_id. |
Chỉ số
Để xem danh sách đầy đủ các chỉ số cho Cloud Firestore, hãy xem Cloud Firestore metrics. Phần sau đây mô tả một số chỉ số hiện có.
Chỉ số thời gian chạy dịch vụ
Các chỉ số serviceruntime cung cấp thông tin tổng quan ở cấp cao về lưu lượng truy cập của một dự án. Các chỉ số này
có sẵn cho hầu hết các API Google Cloud. Loại tài nguyên được theo dõi
consumed_api
chứa các chỉ số phổ biến này. Các chỉ số này được lấy mẫu 30 phút một lần, dẫn đến dữ liệu được làm mượt.
Một nhãn tài nguyên quan trọng cho các chỉ số serviceruntime là method. Nhãn này đại diện cho phương thức RPC cơ bản được gọi. Phương thức SDK mà bạn gọi có thể không nhất thiết phải có cùng tên với phương thức RPC cơ bản. Lý do là vì SDK cung cấp khả năng trừu tượng hoá API ở cấp cao. Tuy nhiên, khi cố gắng tìm hiểu cách ứng dụng của bạn tương tác với Cloud Firestore, bạn cần hiểu các chỉ số dựa trên tên của phương thức RPC.
Nếu bạn cần biết phương thức RPC cơ bản cho một phương thức SDK nhất định, xem tài liệu về API.
api/request_latencies
Chỉ số api/request_latencies cung cấp thông tin phân phối độ trễ trên tất cả các yêu cầu đã hoàn tất.
Cloud Firestore ghi lại các chỉ số từ thành phần Cloud Firestore Dịch vụ. Các chỉ số độ trễ bao gồm thời gian mà Cloud Firestore nhận được yêu cầu cho đến thời điểm mà Cloud Firestore gửi xong phản hồi, bao gồm cả hoạt động tương tác với lớp lưu trữ. Do đó, độ trễ khứ hồi (rtt) giữa máy khách và dịch vụ Cloud Firestore không được đưa vào các chỉ số này.
Chỉ số thao tác trên tài liệu
Cloud Firestore cung cấp số lượt đọc, ghi và xoá. Chỉ số ghi cung cấp thông tin chi tiết về thao tác "CREATE" (TẠO) và "UPDATE" (CẬP NHẬT). Các chỉ số này được căn chỉnh với các thao tác CRUD.
Bạn có thể sử dụng các chỉ số sau đây để biết cơ sở dữ liệu của bạn có nhiều lượt đọc hay nhiều lượt ghi và tỷ lệ tài liệu mới so với tài liệu đã xoá.
document/delete_ops_count: Số lượt xoá tài liệu thành công.document/read_ops_count: Số lượt đọc tài liệu thành công từ các truy vấn hoặc tra cứu.document/write_ops_count: Số lượt ghi tài liệu thành công.
Chỉ số thanh toán
Sử dụng các chỉ số này để hiểu rõ mức sử dụng có tính phí. Các chỉ số này không bao gồm thông tin thanh toán từ các thao tác của quản trị viên (lập chỉ mục, nhập, xuất và xoá hàng loạt).
api/billable_read_units: Số đơn vị đọc có tính phí. Bạn có thể phân tích mức sử dụng theo tên dịch vụ và phương thức API.api/billable_realtime_read_units: Số đơn vị cập nhật theo thời gian thực có tính phí từ các thông tin cập nhật theo thời gian thực. Chỉ số này chỉ áp dụng cho Cloud Firestore ở chế độ Native.api/billable_write_units: Số đơn vị ghi có tính phí. Bạn có thể phân tích mức sử dụng theo tên dịch vụ và phương thức API.document/billable_managed_delete_write_units: Số đơn vị ghi có tính phí từ các dịch vụ xoá được quản lý như TTL.
Chỉ số chỉ mục
Bạn có thể so sánh tỷ lệ ghi chỉ mục với chỉ số document/write_ops_count để hiểu rõ về hệ số phân nhánh chỉ mục.
index/write_count: Số lượt ghi chỉ mục.
Các chỉ số TTL
Các chỉ số TTL cho các chỉ số Cloud Firestore được dùng để theo dõi hiệu quả của chính sách TTL được thực thi.
document/ttl_deletion_count: Tổng số tài liệu bị xoá bởi các dịch vụ TTL.document/ttl_expiration_to_deletion_delays: Thời gian đã trôi qua giữa thời điểm một tài liệu có TTL hết hạn và thời điểm tài liệu đó thực sự bị xoá.
Xem trang tổng quan được xác định trước và tạo trang tổng quan tuỳ chỉnh
Cloud Firestore hỗ trợ các trang tổng quan được xác định trước sử dụng các chỉ số của Cloud Monitoring. Bạn cũng có thể tạo trang tổng quan tuỳ chỉnh.
Xem các chỉ số sử dụng cơ sở dữ liệu
Mở trang tổng quan về mức sử dụng trong bảng điều khiển Cloud để xem số lượt đọc, ghi và xoá tài liệu theo thời gian.
Kiểm soát ra vào
Trang tổng quan về mức sử dụng yêu cầu quyền Quản lý danh tính và quyền truy cập (IAM) monitoring.timeSeries.list.
Các vai trò Chủ sở hữu dự án, Người chỉnh sửa và Người xem cấp quyền này. Bạn cũng có thể cấp quyền này
thông qua vai trò Cloud Monitoring
hoặc vai trò tùy chỉnh.
Trang tổng quan về mức sử dụng cơ sở dữ liệu
Để xem các chỉ số sử dụng cho cơ sở dữ liệu Cloud Firestore, hãy làm như sau.
Trong bảng điều khiển Cloud, hãy chuyển đến trang Databases (Cơ sở dữ liệu).
Chọn cơ sở dữ liệu bắt buộc trong danh sách cơ sở dữ liệu.
Trong trình đơn điều hướng, hãy nhấp vào Usage (Mức sử dụng).
Trang tổng quan về mức sử dụng và báo cáo thanh toán
Trang tổng quan về mức sử dụng Cloud Firestore trong bảng điều khiển cung cấp thông tin ước tính về mức sử dụng. Trang tổng quan này có thể giúp bạn xác định các mức sử dụng tăng đột biến. Tuy nhiên, trang tổng quan không phải là chế độ xem chính xác về các thao tác được tính phí. Mức sử dụng được tính phí có thể cao hơn. Để theo dõi thông tin thanh toán, hãy xem các chỉ số thanh toán.
Trong mọi trường hợp có sự khác biệt, báo cáo thanh toán sẽ được ưu tiên hơn trang tổng quan về mức sử dụng.
Các thao tác nhập và xuất gây ra sự khác biệt giữa trang tổng quan về mức sử dụng và mức sử dụng được tính phí. Các lượt đọc và ghi do các thao tác này thực hiện không xuất hiện trong trang tổng quan về mức sử dụng.
Xem các chỉ số hiệu suất cơ sở dữ liệu
Trang Monitoring (Giám sát) trong phần Cloud Firestore của bảng điều khiển Google Cloud bao gồm các trang tổng quan giám sát được xác định trước, chẳng hạn như Request Latencies (P50 and P99) (Độ trễ yêu cầu (P50 và P99)), Response Codes (Mã phản hồi) và Query stats (P50) (Số liệu thống kê truy vấn (P50)). Bạn cũng có thể tạo tối đa một trang tổng quan tuỳ chỉnh. Để truy cập vào trang Monitoring (Giám sát) cho một cơ sở dữ liệu, hãy làm theo các bước sau:
Trong Google Cloud Console, hãy mở trang Cloud Firestore Databases.
Chọn một cơ sở dữ liệu trong danh sách.
Trong trình đơn điều hướng, hãy nhấp vào Monitoring (Giám sát) để mở trang tổng quan.
Tạo trang tổng quan tuỳ chỉnh Cloud Monitoring
Trong Cloud Monitoring, trang tổng quan tuỳ chỉnh cho phép bạn hiển thị thông tin có liên quan đến bạn một cách có tổ chức. Ví dụ: bạn có thể tạo một trang tổng quan để hiển thị các chỉ số hiệu suất và chính sách cảnh báo cho dự án của bạn trong môi trường sản xuất.
Để biết thêm thông tin về cách thiết lập trang tổng quan tuỳ chỉnh, hãy xem bài viết Quản lý trang tổng quan tuỳ chỉnh và Thêm tiện ích trang tổng quan.
Tạo chính sách cảnh báo
Trong Cloud Monitoring, bạn có thể tạo cảnh báo để thông báo cho bạn khi điều kiện chỉ số thay đổi. Bạn có thể sử dụng các cảnh báo này để được thông báo về các vấn đề tiềm ẩn trước khi chúng ảnh hưởng đến người dùng.
Để biết thêm thông tin về cách tạo cảnh báo, hãy xem Tạo chính sách cảnh báo về ngưỡng chỉ số.
Hãy xem xét ví dụ sau đây, trong đó chúng ta tạo chính sách cảnh báo về độ trễ. Chính sách cảnh báo kiểm tra độ trễ p99 trong khoảng thời gian 5 phút. Nếu độ trễ p99 duy trì ở mức cao hơn 250 mili giây trong 5 phút, thì cảnh báo sẽ được kích hoạt.
Bảng điều khiển
Trong bảng điều khiển Cloud, hãy chuyển đến trang Monitoring (Giám sát), sau đó chọn notifications Alerting (Cảnh báo).
Chọn Create policy (Tạo chính sách).
Chọn chỉ số Request Latencies (Độ trễ yêu cầu) từ tài nguyên Consumed API (API đã sử dụng).
Thêm bộ lọc dịch vụ cho
firestore.googleapis.comcho các cơ sở dữ liệu Firestore ở chế độ Native.Nhấp vào Next (Tiếp theo) để định cấu hình trình kích hoạt.
Chọn Condition Types (Loại điều kiện) là Threshold (Ngưỡng).
Điều kiện ngưỡng được đặt thành giá trị ngưỡng là 250 mili giây. Cảnh báo được kích hoạt khi giá trị độ trễ p99 giữ nguyên trong toàn bộ khoảng thời gian của khoảng thời gian (5 phút).
Đặt Threshold value (Giá trị ngưỡng) là 250.
Nhấp vào Next (Tiếp theo) để định cấu hình thông báo.
Đặt tên chính sách cảnh báo rồi nhấp vào Next (Tiếp theo).
Xem lại cấu hình cảnh báo rồi nhấp vào Create Policy (Tạo chính sách).
MQL (Ngôn ngữ truy vấn giám sát)
Bạn có thể triển khai cùng một chính sách cảnh báo về độ trễ bằng cách sử dụng truy vấn Ngôn ngữ truy vấn giám sát (MQL). Để xem thêm ví dụ về cách sử dụng MQL, hãy xem Các truy vấn MQL mẫu.
fetch consumed_api
| metric 'serviceruntime.googleapis.com/api/request_latencies'
| filter (resource.service == 'firestore.googleapis.com')
| group_by 5m,
[value_request_latencies_percentile:
percentile(value.request_latencies, 99)]
| every 5m
| condition val() > 0.25 's'