| 僅適用於 Cloud Firestore Enterprise 版。 |
本頁說明如何使用與 MongoDB 相容的 Cloud Firestore Cloud Monitoring 指標監控資料庫。
與 MongoDB 相容的 Cloud Firestore Cloud Monitoring 指標
下列各節將概述與 MongoDB 相容的 Cloud Firestore 可用指標。
受監控資源
Cloud Monitoring 中的受監控資源代表邏輯或實體實體，例如虛擬機器、資料庫或應用程式。受監控的資源包含一組獨特的指標，可用於探索、透過資訊主頁回報，或用於建立快訊。每項資源也有一組資源標籤，這些鍵/值組合會保存資源的其他資訊。資源標籤適用於與資源相關聯的所有指標。
使用 Cloud Monitoring API 時，可透過下列資源監控與 MongoDB 相容的 Cloud Firestore 效能：
| 資源 | 說明 |
firestore.googleapis.com/Database | 受控資源類型，可提供 project、location 和 database_id 的詳細資料。 |
指標
如需 Cloud Firestore 的完整指標清單，請參閱「Cloud Firestore 指標」。以下章節說明部分可用指標。
服務執行階段指標
serviceruntime指標提供專案流量的概略總覽。大多數 Google Cloud API 都提供這些指標。consumed_api
受監控的資源類型包含這些常見指標。這些指標每 30 分鐘取樣一次，因此資料會經過平滑處理。
serviceruntime 指標的重要資源標籤是 method。這個標籤代表呼叫的基礎遠端程序呼叫 (RPC) 方法。您呼叫的 SDK 方法名稱不一定與基礎 RPC 方法相同。這是因為 SDK 提供高階 API 抽象層級。不過，如要瞭解應用程式與 Cloud Firestore 的互動方式，請務必根據 RPC 方法的名稱瞭解指標。
如要瞭解特定 SDK 方法的基礎 RPC 方法，請參閱 API 說明文件。
api/request_latencies
api/request_latencies 指標會提供所有已完成要求的延遲時間分布情形。
Cloud Firestore 記錄 Cloud Firestore 服務元件的指標。延遲指標包括 Cloud Firestore 收到要求到完成傳送回應的時間，包括與儲存層的互動。Cloud Firestore因此，這些指標不包含用戶端與 Cloud Firestore 服務之間的往返延遲時間 (rtt)。
文件作業指標
Cloud Firestore 提供讀取、寫入和刪除次數。寫入指標會細分「CREATE」和「UPDATE」作業。這些指標與 CRUD 作業一致。
您可以使用下列指標，瞭解資料庫是讀取密集型還是寫入密集型，以及新文件與已刪除文件的比率。
document/delete_ops_count：成功刪除的文件數量。document/read_ops_count：從查詢或搜尋成功讀取文件的次數。document/write_ops_count：成功寫入文件的次數。
帳單指標
您可以透過這些指標瞭解帳單用量。這些指標不含管理員作業 (建立索引、匯入、匯出及大量刪除) 的帳單。
api/billable_read_units：可計費的讀取單位數量。 用量可依服務名稱和 API 方法細分。api/billable_write_units：可計費寫入單位數量。 用量可依服務名稱和 API 方法細分。document/billable_managed_delete_write_units：來自代管刪除服務 (例如 TTL) 的可計費寫入單位數量。
索引指標
您可以將索引寫入率與 document/write_ops_count 指標進行比較，瞭解索引扇出。
index/write_count：索引寫入次數。
存留時間指標
與 MongoDB 相容的 Cloud Firestore 存留時間指標，可用於監控強制執行的 TTL 政策效果。
document/ttl_deletion_count：由 TTL 服務刪除的文件總數。document/ttl_expiration_to_deletion_delays：文件 TTL 過期到實際刪除之間經過的時間。
查看預先定義的資訊主頁，以及建立自訂資訊主頁
與 MongoDB 相容的 Cloud Firestore 支援使用 Cloud Monitoring 指標的預先定義資訊主頁。您也可以建立自訂資訊主頁。
查看資料庫用量指標
在 Google Cloud 控制台中開啟用量資訊主頁，即可查看一段時間內的讀取、寫入和刪除文件次數。
存取權控管
使用量資訊主頁需要 monitoring.timeSeries.list Identity and Access Management (IAM) 權限。專案擁有者、編輯者和檢視者角色會授予這項權限。您也可以透過Cloud Monitoring角色或自訂角色授予這項權限。
資料庫用量資訊主頁
如要查看與 MongoDB 相容的 Cloud Firestore 資料庫用量指標，請按照下列步驟操作。
前往 Google Cloud 控制台的「資料庫」頁面。
從資料庫清單中選取所需資料庫。
在導覽選單中，按一下「用量」。
用量資訊主頁和帳單報表
控制台中的 Cloud Firestore 用量資訊主頁會提供預估用量，方便您找出用量尖峰。 不過，資訊主頁並非呈現確切的計費作業資料。因此實際計費的用量可能會更高。如要監控帳單，請參閱帳單指標。
因此，如有資料不一致的情況，帳單報表的參考順序一律高於用量資訊主頁。
匯入和匯出作業會導致用量資訊主頁與計費用量資料不一致。這些作業執行的讀取和寫入作業不會顯示在用量資訊主頁中。
查看資料庫效能指標
Google Cloud 控制台的 Cloud Firestore 區段中，「Monitoring」(監控) 頁面包含預先定義的監控資訊主頁，例如「Request Latencies (P50 and P99)」(要求延遲時間 (P50 和 P99))、「Response Codes」(回應代碼) 和「Query stats (P50)」(查詢統計資料 (P50))。你也可以建立最多一個自訂資訊主頁。如要存取資料庫的「監控」頁面，請按照下列步驟操作：
在 Google Cloud 控制台中，開啟「資料庫」Cloud Firestore頁面。
從清單中選取資料庫。
在導覽選單中，按一下「監控」開啟資訊主頁。
建立自訂Cloud Monitoring資訊主頁
在 Cloud Monitoring 中，您可以透過自訂資訊主頁，有條不紊地顯示與您相關的資訊。舉例來說，您可以建立資訊主頁，顯示正式環境中專案的成效指標和快訊政策。
如要進一步瞭解如何設定自訂資訊主頁，請參閱「管理自訂資訊主頁」和「新增資訊主頁小工具」。
建立快訊政策
在 Cloud Monitoring 中，您可以建立快訊，在指標條件發生變化時收到通知。您可以使用這些警示，在潛在問題影響使用者前收到通知。
如要進一步瞭解如何建立快訊，請參閱建立指標閾值快訊政策。
請參考以下範例，瞭解如何建立延遲快訊政策。快訊政策會檢查 5 分鐘滾動週期內的第 99 百分位延遲時間。如果 p99 延遲時間持續高於 250 毫秒達 5 分鐘，就會觸發快訊。
控制台
前往 Google Cloud 控制台的「Monitoring」(監控) 頁面，然後選取「Alerting」(快訊)notifications。
選取「建立政策」。
從「已使用的 API」資源中選取「要求延遲」指標。
為 Cloud Firestore 標準資料庫新增
firestore.googleapis.com的服務篩選器。按一下「下一步」來設定觸發條件。
將「Condition Types」(條件類型) 設為「Threshold」(門檻)。
門檻條件設為 250 毫秒的門檻值。如果第 99 個百分位數的延遲時間值在整個滾動視窗 (5 分鐘) 期間都維持不變，系統就會觸發快訊。
將「Threshold value」(門檻值) 設為 250。
按一下「下一步」設定通知。
設定快訊政策名稱，然後按一下「下一步」。
檢查快訊設定，然後按一下「建立政策」。
MQL
您可以使用 Monitoring Query Language (MQL) 查詢，實作相同的延遲時間警告政策。如需更多使用 MQL 的範例，請參閱「MQL 查詢範例」。
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'