本頁面說明如何監控 Cloud Firestore 用量，以及找出應用程式中的潛在問題。
用量資訊主頁
使用 Google Cloud Platform 主控台和 Firebase 控制台中的用量資訊主頁，查看一段時間內的文件讀取、寫入及刪除作業。
存取權控管
用量資訊主頁需要 monitoring.timeSeries.list Cloud IAM 權限。
專案擁有者、編輯者和檢視者角色可授予這項權限。您也可以透過 Cloud Monitoring 角色或自訂角色授予此權限。
資料庫用量資訊主頁
如要查看 Cloud Firestore 資料庫的用量指標，請在 GCP Console 中開啟資料庫的「Usage」(用量) 頁面。
在 Google Cloud Platform Console 中，前往「Databases」頁面。
從資料庫清單中選取所需的資料庫。
在導覽選單中，按一下「Usage」。
按一下頁面顯示的訊息中的連結，查看資料庫使用情況。
匯總使用情形資訊主頁
如果專案有多個 Cloud Firestore 資料庫，您可以在 GCP 控制台或 Firebase 控制台中查看匯總用量指標。
GCP 控制台
在 Google Cloud Platform 控制台中，前往「專案用量」頁面。
專案用量資訊主頁會顯示一段時間內的文件作業，如下所示：
Firebase 控制台
前往 Cloud Firestore 用量頁面 (Firebase 控制台)
用量資訊主頁和帳單報表
Firebase 和 Cloud 控制台中的 Cloud Firestore 用量資訊主頁會提供預估用量，方便您找出用量尖峰。不過，資訊主頁並非呈現確切的計費作業資料。計費用量可能較高。因此，如有資料不一致的情況，帳單報表會優先顯示用量資訊主頁。
會導致用量資訊主頁與計費用量資料不一致的作業包括：
- 匯入和匯出作業。這些作業執行的讀取和寫入作業不會顯示在用量資訊主頁。
- 免人工管理僅驗證寫入。寫入作業只驗證文件是否存在或不存在，藉此計費讀取作業。在寫入用量資訊主頁中，這些寫入作業會分別顯示為「UPDATE_NOOP」和「DELETE_NOOP」。
- 免人工管理寫入。不會變更資料庫的作業 (例如不會變更欄位值的更新作業，或寫入已刪除文件的作業)，可能會在用量資訊主頁顯示為「UPDATE_NOOP」或「DELETE_NOOP」。即使這些作業顯示為「NOOP」，仍然會發生計費作業。
已收合的寫入。如果發生多次寫入同一文件的情況，使用資訊主頁可能會收合多項寫入作業，並計為一次寫入。系統計算計費用量時，仍會分開計算每次寫入作業。
用量資訊主頁也會收合欄位轉換的寫入資料，例如伺服器時間戳記、數字遞增和陣列聯集作業。如果是欄位轉換，用量資訊主頁可能會將多項作業計為一項作業。
- 未傳回任何結果的查詢。如果查詢為零，則會產生一項讀取作業的費用。這個用量已計費，但不會顯示在用量資訊主頁中。
- 讀取索引項目讀取作業的讀取作業。系統會向您收取這個用量的費用，但「用量」資訊主頁不會顯示該用量。舉例來說，匯總查詢會收取已讀取的索引項目費用，但用量資訊主頁不會顯示這個用量。
刪除項目的用量資訊主頁不會擷取存留時間 (TTL) 政策執行的自動到期時間作業。請參閱 Cloud Monitoring 的存留時間指標。
安全性規則用量
此外，Firebase 控制台還提供安全性規則評估資訊主頁，方便您快速查看規則叫用。您可以使用 Cloud Monitoring 中的詳細分析來補充此資訊主頁。
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 指標的資訊主頁，請參閱管理自訂資訊主頁和新增資訊主頁小工具。