監控資料庫指標

本頁說明如何使用 Cloud Monitoring 指標監控資料庫。Cloud Firestore

Cloud Monitoring 的 Cloud Firestore 指標

以下各節將概述 Cloud Firestore 適用的指標。

受監控資源

Cloud Monitoring 中的受監控資源代表邏輯或實體實體，例如虛擬機器、資料庫或應用程式。受監控的資源包含一組獨特的指標，可用於探索、透過資訊主頁回報，或用於建立快訊。每項資源也有一組資源標籤，這些鍵/值組合會保存資源的其他資訊。資源標籤適用於與資源相關聯的所有指標。

使用 Cloud Monitoring API 時，系統會透過下列資源監控 Cloud Firestore 效能：

指標

如需 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_realtime_read_units：即時更新的可計費即時更新單位數量。這項設定僅適用於Cloud Firestore的原生模式。
• api/billable_write_units：可計費寫入單位的數量。 用量可依服務名稱和 API 方法細分。
• document/billable_managed_delete_write_units：來自代管刪除服務 (例如 TTL) 的可計費寫入單位數。

索引指標

您可以將索引寫入率與 document/write_ops_count 指標進行比較，瞭解索引扇出。

• index/write_count：索引寫入次數。

存留時間指標

系統會使用 Cloud Firestore 指標的存留時間指標，監控強制執行的 TTL 政策效果。

• document/ttl_deletion_count：由 TTL 服務刪除的文件總數。
• document/ttl_expiration_to_deletion_delays：文件 TTL 過期到實際刪除之間經過的時間。

查看預先定義的資訊主頁，以及建立自訂資訊主頁

Cloud Firestore 支援使用 Cloud Monitoring 指標的預先定義資訊主頁。 您也可以建立自訂資訊主頁。

查看資料庫用量指標

在 Google Cloud 控制台中開啟用量資訊主頁，即可查看一段時間內的讀取、寫入和刪除文件次數。

存取權控管

使用量資訊主頁需要 monitoring.timeSeries.list Identity and Access Management (IAM) 權限。專案擁有者、編輯者和檢視者角色會授予這項權限。您也可以透過Cloud Monitoring角色或自訂角色授予這項權限。

資料庫用量資訊主頁

如要查看 Cloud Firestore 資料庫的用量指標，請按照下列步驟操作。

1. 前往 Google Cloud 控制台的「資料庫」頁面。

   前往「資料庫」

2. 從資料庫清單中選取所需資料庫。

3. 在導覽選單中，按一下「用量」。

用量資訊主頁和帳單報表

控制台中的 Cloud Firestore 用量資訊主頁會提供預估用量，方便您找出用量尖峰。 不過，資訊主頁並非呈現確切的計費作業資料。因此實際計費的用量可能會更高。如要監控帳單，請參閱帳單指標。

因此，如有資料不一致的情況，帳單報表的參考順序一律高於用量資訊主頁。

匯入和匯出作業會導致用量資訊主頁與計費用量資料不一致。這些作業執行的讀取和寫入作業不會顯示在用量資訊主頁中。

查看資料庫效能指標

Google Cloud 控制台的 Cloud Firestore 區段中，「監控」頁面包含預先定義的監控資訊主頁，例如「要求延遲時間 (P50 和 P99)」、「回應代碼」和「查詢統計資料 (P50)」。你也可以建立最多一個自訂資訊主頁。如要存取資料庫的「監控」頁面，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，開啟「資料庫」Cloud Firestore頁面。

   前往「資料庫」

2. 從清單中選取資料庫。

3. 在導覽選單中，按一下「監控」開啟資訊主頁。

建立自訂Cloud Monitoring資訊主頁

在 Cloud Monitoring 中，您可以透過自訂資訊主頁，有條不紊地顯示相關資訊。舉例來說，您可以建立資訊主頁，顯示正式環境中專案的成效指標和快訊政策。

如要進一步瞭解如何設定自訂資訊主頁，請參閱「管理自訂資訊主頁」 和「新增資訊主頁小工具」。

建立快訊政策

您可以在 Cloud Monitoring 中建立快訊，以便在指標條件發生變化時收到通知。您可以利用這些警示，在潛在問題影響使用者前收到通知。

如要進一步瞭解如何建立快訊，請參閱「建立指標門檻警告政策」。

請參考下列範例，瞭解如何建立延遲快訊政策。警告政策會檢查 5 分鐘滾動時間範圍內的第 99 百分位延遲時間。如果 p99 延遲時間持續高於 250 毫秒達 5 分鐘，就會觸發快訊。

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'