分析用量洞察資料

本頁說明如何使用用量洞察功能，分析特定資料庫的可計費用量。您可以依據集合、集合群組或命名空間 (僅限 Datastore 模式) 等維度，在自訂時間範圍內細分這項資料。顯示的使用洞察指標會因版本或模式而異：

版本	指標
標準	讀取 寫入 (包含刪除) 依存留時間刪除
Enterprise	讀取 寫入 依存留時間刪除 事件

用量洞察資料總覽

使用用量洞察資訊主頁監控特定資料庫的用量。這個資訊主頁可協助您：

• 監控精細用量：追蹤可計費作業，並依 collection、collectionGroup 或 namespace 等維度細分。
• 降低成本：找出高額帳單的使用量，判斷可最佳化資料結構或查詢的位置，進而降低整體帳單費用。
• 追蹤歷來趨勢：監控特定時間範圍內的計費用量統計資料變化。

必要的角色

如要取得查看用量洞察資訊主頁所需的權限，請要求管理員授予您「Datastore 檢視者」

(roles/datastore.viewer) 專案的 IAM 角色。

這個預先定義的角色具備 datastore.insights.get 權限，可查看用量洞察資訊主頁。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

用量洞察資訊主頁

使用情況洞察資訊主頁主要分為兩個部分：

• 總用量：顯示整個資料庫的匯總指標 (讀取、寫入、存留時間刪除)。
• 依用量分組：顯示依前 100 個維度細分的指標，並依集合、產品素材資源集合群組或命名空間分組。

總用量和 GroupBy 指標

請注意，GroupBy 區段中的指標總和可能與「總用量」區段中顯示的指標不符。由於下列因素，這種差異是正常的：

• 分組依據限制 (前 100 名)：「分組依據」專區僅限列出前 100 個集合、集合群組或命名空間的使用量。不常使用的維度產生的用量會計入總用量，但不會個別列在 GroupBy 用量指標中。
• 廣泛作業的取樣：如果要求會影響大量集合 (例如跨多個集合的聯結、ListCollectionIds、ListDocuments、無種類查詢)，用量洞察資料可能會對集合進行取樣，並優先處理用量最高的集合。因此，GroupBy 使用指標不會包含所有受影響的集合。

• 保留名稱： Cloud Firestore 會保留以雙底線開頭的名稱 (__*__)，做為內部中繼資料。與這些預留名稱相關的用量會計入總用量，但不會計入「依群組劃分」用量指標。

  GroupBy 維度

  GroupBy 區段會根據已啟用 API 決定的維度，整理使用情況指標：

  • 集合：啟用 Cloud Firestore API 後即可使用。

  舉例來說，如果資料庫主要使用 Firestore MongoDB 相容作業，用量明細預設會顯示「集合」。

  用量洞察資料

  Google Cloud 控制台的使用情況洞察資料會顯示來自下列 API 方法的資料：

  • queryTopAggregatedInsightsData
  • queryTopTimeseriesInsightsData

  欄位名稱	詳細資料
  集合名稱 集合群組名稱	與匯總使用資料的使用情況維度相應的值。可以是產品素材資源集合群組名稱
  讀取作業總數	讀取作業總數。僅適用於標準版。
  寫入作業總數	寫入作業總數。包括刪除作業。僅適用於標準版。
  依據存留時間刪除的作業總數	依據存留時間刪除的作業總數。僅適用於標準版。
  讀取單元總數	分組讀取單元總數 (4 KiB 為一組)。僅適用於 Enterprise 版。
  寫入單元總數	分組寫入單位總數 (1 KiB 為一組)。包括刪除單元。僅適用於 Enterprise 版。
  按照存留時間刪除或代管刪除的單元總數	按照存留時間刪除或代管刪除的單元總數。僅適用於 Enterprise 版。
  Eventarc 總單元數	Eventarc 單位總數。僅適用於 Enterprise 版。
  讀取位元組總數	掃描的位元組總數。
  掃描文件總數	掃描的文件總數。
  掃描的索引項目總數	掃描的索引項目總數。
  寫入的文件總數	撰寫的文件總數。
  寫入的索引項目總數	寫入的索引項目總數。
  寫入的文件大小總和	以位元組為單位的寫入文件總大小。

  限制

  • 系統不會在 API 回應中追蹤計費讀取和寫入作業的串流查詢。
  • 不支援管理作業 (會產生可計費的讀取和寫入作業) 的用量洞察資料，例如 Enterprise 版本的匯入/匯出、大量刪除、還原、複製和建立索引作業。
  • 系統不支援網路輸出流量和儲存空間的帳單。

  定價

  使用洞察資料不需額外付費。

  查看用量洞察資料

  如要查看 Cloud Firestore 資料庫的用量洞察資料，請在 Google Cloud 控制台中開啟資料庫的「用量洞察」窗格。

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

     前往「資料庫」

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

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

     

     使用「依群組」下拉式選單，查看集合、collectionGroup 或命名空間的使用情況洞察資料。您最多可以查看過去 45 天的使用情況洞察資料。