監控 Cloud Firestore 活動

本頁面說明如何監控 Cloud Firestore 的使用情形,以及 找出應用程式中的潛在問題。

用量資訊主頁

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

存取權控管

用量資訊主頁需要 monitoring.timeSeries.list Cloud IAM 權限。 專案擁有者、編輯者和檢視者角色可授予這項權限。你也可以授予這項權限 透過 Cloud Monitoring 角色自訂角色

資料庫用量資訊主頁

如要查看 Cloud Firestore 資料庫的用量指標,請開啟資料庫「Usage」。 頁面。

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

    前往「資料庫」頁面

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

  3. 在導覽選單中,按一下「Usage」

  4. 按一下頁面顯示的訊息中的連結,查看資料庫使用情況。

    <span class=Google Cloud 控制台中的 Cloud Firestore 資料庫用量資訊主頁"/>

匯總使用情形資訊主頁

如果您的專案有多個 Cloud Firestore 資料庫,您可以在 Google Cloud 控制台或 Firebase 控制台中查看匯總的用量指標。

Google Cloud 控制台

在 Google Cloud 控制台中,前往「專案用量」頁面。

查看 Google Cloud 專案用量

專案使用量資訊主頁會顯示文件作業的時間變化情形,如下所示:

<span class=Google Cloud 控制台的 Cloud Firestore 專案用量資訊主頁。"/>

Firebase 個控制台

前往Cloud Firestore使用情形頁面 (Firebase 控制台)

<span class=Firebase 控制台中的 Cloud Firestore 用量資訊主頁。"/>

使用情形資訊主頁和帳單報表

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

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

  • 匯入和匯出作業。這些作業執行的讀取和寫入作業 不會顯示在用量資訊主頁中
  • 免人工管理僅驗證寫入。寫入作業只驗證文件是否存在或不存在,藉此計費讀取作業。在寫入用量資訊主頁中,這些寫入作業會分別顯示為「UPDATE_NOOP」和「DELETE_NOOP」。
  • 免人工管理寫入。不會導致資料庫變更的作業 (例如不會變更欄位值的更新作業,或是寫入已刪除的文件) 可能會在使用率資訊主頁中顯示為 `UPDATE_NOOP` 或 `DELETE_NOOP`。即使顯示為 `NOOP`,這些作業仍會計入帳單作業。
  • 已收合的寫入。如果同一份文件在短時間內多次寫入,使用率資訊主頁可能會將多筆寫入作業合併,並計為一筆。在計費用量時,系統仍會分別計算每項寫入作業。

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

  • 未傳回任何結果的查詢。結果為零的查詢 只會維持一次讀取作業的費用這個用量已計費,但不會顯示 「用量資訊主頁」
  • 讀取索引項目讀取作業的讀取作業。系統會收取用量費用 會顯示在用量資訊主頁中例如,匯總查詢會針對已讀取的索引項目收費,但用量資訊主頁不會顯示這個用量。

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

安全性規則用量

此外,Firebase 控制台會顯示安全性規則評估 資訊主頁,提供實用且實用的規則叫用檢視畫面。您可以補充資訊 以及深入分析 Cloud Monitoring

前往「規則」

<span class=Firebase控制台中的 Cloud Firestore 規則監控資訊主頁。"/>

Cloud Monitoring 項指標

Cloud Monitoring」收集 Google Cloud 項產品的指標、事件和中繼資料。使用方式 Cloud Firestore 控制台中的資訊主頁都會回報相同的指標資料。目的地: 如何設定自訂資訊主頁和用量快訊,請使用 Cloud Monitoring

Cloud Monitoring 提供下列 Cloud Firestore 指標:

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

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

這項指標不包含代管匯出項目的讀取作業 作業。

文件寫入次數

成功寫入文件的次數。您可以將指標細分 類型為:CREATE 或 UPDATE。

這項指標不包括代管匯入項目的寫入作業 作業。

文件刪除次數 成功刪除的文件數量。
有效連線

連結至資料庫的有效連線數量。

每個有效的行動版和網頁 SDK 都會保留 單一連線,可在多個快照之間共用 接聽程式。伺服器用戶端程式庫 為每個快照事件監聽器建立一個連線。

快照監聽器

所有有效連線的快照事件監聽器數量。

存留時間刪除計數

由 刪除的文件總數 存留時間 (TTL) 政策

延遲時間的存留時間 (TTL) 已延遲

文件到期從 存留時間 (TTL) 政策 以及實際刪除的時間

即時更新用量

使用有效連線和快照監聽器指標測量 即時更新的用法。

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

取樣率

系統每分鐘會取樣 Cloud Firestore 指標,但更新資訊最多可能要 4 分鐘才會顯示在資訊主頁中。

延遲指標

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

舉例來說,您可以在 Cloud 控制台的 Metrics Explorer 檢視畫面中找到「p50 延遲時間」圖表。

設定 Cloud Monitoring 資訊主頁

如要設定含有 Cloud Firestore 項指標的資訊主頁,請參閱 管理自訂資訊主頁新增資訊主頁小工具

後續步驟