監控用量

本頁說明如何監控 Firestore 用量，以及找出應用程式中可能發生的問題。

用量資訊主頁

使用 Google Cloud 控制台和 Firebase 控制台中的用量資訊主頁，查看一段時間內的檔案讀取、寫入和刪除次數。

存取權控管

您必須具備 monitoring.timeSeries.list IAM 權限，才能使用用量資訊主頁。 專案擁有者、編輯者和檢視者角色會授予這項權限。您也可以透過 Cloud Monitoring 角色或自訂角色授予這項權限。

資料庫用量資訊主頁

如要查看 Firestore 資料庫的用量指標，請在 Google Cloud 控制台中開啟資料庫的「用量」頁面。

  1. 前往 Google Cloud 控制台的「Databases」頁面。

    前往「資料庫」

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

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

  4. 按一下頁面顯示的訊息中的連結，即可查看資料庫用量。

    Google Cloud 控制台中的 Firestore 資料庫用量資訊主頁。

匯總使用情況資訊主頁

如果專案有多個 Firestore 資料庫，您可以在 Google Cloud 控制台或 Firebase 控制台中查看匯總用量指標。專案層級的用量資訊主頁會匯總所有 Firestore 原生模式資料庫的用量指標。這個資訊主頁不會顯示 Datastore 模式資料庫的 Firestore 用量。

Google Cloud 控制台

前往 Google Cloud 控制台的「Project usage」頁面。

前往 Google Cloud 專案用量

專案用量資訊主頁會顯示一段時間內的檔案作業，如下所示：

Google Cloud 控制台中的 Firestore 專案用量資訊主頁。

Firebase 控制台

前往 Firestore 用量頁面 (Firebase 控制台)

Firebase 控制台中的 Firestore 用量資訊主頁。

用量資訊主頁和帳單報表

Firebase 和 Cloud 控制台中的 Firestore 用量資訊主頁會提供預估用量，方便您找出用量尖峰。 不過，資訊主頁並非呈現確切的計費作業資料。因此實際計費的用量可能會更高。因此，如有資料不一致的情況，帳單報表的參考順序一律高於用量資訊主頁。

會導致用量資訊主頁與計費用量資料不一致的作業包括：

  • 匯入和匯出作業。這些作業執行的讀取和寫入作業不會顯示在用量資訊主頁中。
  • 免人工管理的純驗證寫入作業。只驗證文件是否存在的寫入作業會計入讀取作業費用，但會在寫入用量資訊主頁中分別顯示為 `UPDATE_NOOP` 和 `DELETE_NOOP`。
  • 免人工管理寫入作業。如果作業未導致資料庫發生變更 (例如更新作業未變更欄位值，或是寫入已刪除的文件)，使用量資訊主頁可能會顯示 `UPDATE_NOOP` 或 `DELETE_NOOP`。即使顯示為 `NOOP`，這些作業仍會計入付費作業。

  • 已收合的寫入作業。如果快速連續多次寫入同一份文件，使用量資訊主頁可能會將多次寫入作業合併計算為一次。計算用量時，系統仍會分別計算每次寫入作業的費用。

    使用量資訊主頁也會將欄位轉換 (例如伺服器時間戳記、數值遞增和陣列聯集作業) 的寫入作業收合。如果是欄位轉換，使用量資訊主頁可能會將多項作業計為單一作業。

  • 查詢未傳回任何結果。如果查詢未傳回任何結果，系統會收取一次讀取作業的費用。這項用量會計費，但不會顯示在用量資訊主頁中。
  • 從「讀取的索引項目」讀取作業。這類用量會計費，但不會顯示在用量資訊主頁。舉例來說，匯總查詢會針對讀取的索引項目計費，但這類用量不會顯示在用量資訊主頁中。

刪除作業的使用量資訊主頁不會擷取存留時間 (TTL) 政策執行的自動到期作業。請參閱 Cloud Monitoring 的 TTL 指標。

安全性規則使用情形

此外，Firebase 控制台還提供安全性規則評估資訊主頁，方便您一目瞭然地查看規則呼叫情形。您可以在 Cloud Monitoring 中進行詳細分析，做為這個資訊主頁的補充資料。

前往「規則」

Firebase 控制台中的 Firestore 規則監控資訊主頁。

Cloud Monitoring 指標

Cloud Monitoring 會收集 Google Cloud 產品的指標、事件和中繼資料。Firestore 控制台中的用量資訊主頁會回報相同的指標資料。如要設定自訂資訊主頁和用量快訊，請使用 Cloud Monitoring。

Cloud Monitoring 包含下列 Firestore 指標：

指標名稱 說明
文件讀取次數

成功讀取的文件數量。您可以依讀取類型 (LOOKUP 或 QUERY) 細分這項指標。

這項指標不包括代管匯出或大量刪除作業的讀取次數。
文件寫入次數

成功寫入的文件數量。您可以依寫入類型 (CREATE 或 UPDATE) 細分指標。

這項指標不包含代管匯入作業的寫入作業。
文件刪除次數 成功刪除的文件數量。
有效連線

資料庫的有效連線數。

每個有效的行動裝置和網頁 SDK 都會維持單一連線，且可供多個快照監聽器共用。伺服器用戶端程式庫會為每個快照監聽器建立一個連線。
快照監聽器

所有有效連線的快照監聽器數量。
存留時間刪除計數

由存留時間 (TTL) 政策刪除的文件總數。
從存留時間到期到刪除延遲

文件根據存留時間 (TTL) 政策到期後，實際刪除前經過的時間。
即時更新用量

使用有效連線和快照監聽器指標，評估即時更新的使用情況。

假設使用者在手機上開啟您的應用程式，接著，應用程式會連線至 Firestore 並訂閱 10 個查詢。這會使指標增加 1 個有效連線和 10 個快照監聽器。

取樣率

Firestore 指標每分鐘取樣一次，但更新最多可能需要 4 分鐘才會顯示在資訊主頁中。

延遲指標

後端延遲時間指標可透過常見的 Google Cloud Firestore 指標取得。

舉例來說，您可以在 Cloud 控制台的指標探索器檢視畫面中，找到 p50 延遲時間的圖表。

設定 Cloud Monitoring 資訊主頁

如要查看預先定義的資訊主頁或設定資訊主頁，請參閱「使用監控資訊主頁」。

後續步驟