分析用量洞察資料

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

版本 指標
標準
  • 讀取
  • 寫入 (包含刪除)
  • 依據存留時間刪除
  • 串流讀取 (Listen 項要求)
  • 串流寫入 (StreamWrite 項要求，包含刪除)
Enterprise
  • 讀取單位
  • 寫入單元 (包含刪除)
  • 依據存留時間刪除或受管理刪除的單元數
  • Eventarc 單元
  • 串流讀取單位 (Listen輪詢)
  • 即時讀取單位 (Listen串流更新)
  • 串流寫入單位 (StreamWrite 項要求，包含刪除)

用量洞察資料總覽

使用用量深入分析資訊主頁，監控特定資料庫的用量。這個資訊主頁可協助您：

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

必要的角色

如要取得查看用量深入分析資訊主頁所需的權限，請要求管理員授予您 Datastore 檢視者

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

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

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

用量深入分析資訊主頁

「使用情形深入分析」資訊主頁主要分為兩個部分：

  • 總用量：顯示整個資料庫的匯總指標 (讀取、寫入、串流讀取、串流寫入和 TTL 刪除)。
  • GroupBy Usage：顯示依前 100 個維度細分的指標，並依集合、集合群組或命名空間分組。

總用量和 GroupBy 指標

請注意，GroupBy 區段中的指標總和可能與「總用量」區段中顯示的指標不符。造成這種差異的可能原因如下：

  • GroupBy 限制 (前 100 名)：GroupBy 區段僅限列出前 100 個集合、集合群組或命名空間的用量。較不活躍的維度產生的用量會計入總用量，但不會個別列在 GroupBy 用量指標中。
  • 廣泛作業取樣：如果要求會影響大量集合 (例如跨多個集合、ListCollectionIds、ListDocuments、無 kind 查詢的彙整)，用量深入分析可能會對集合取樣，並優先處理用量最高的集合。因此，GroupBy 用量指標不會納入所有受影響的集合。

  • 保留名稱： Cloud Firestore 會保留以雙底線 (__*__) 開頭的名稱，用於內部中繼資料。與這些預留名稱相關的用量會計入總用量，但不會納入 GroupBy 用量指標。

    GroupBy 維度

    「GroupBy」部分會根據已啟用 API 決定的維度，整理用量指標：

    • 集合：啟用 Cloud Firestore API 後即可使用。
    • 集合群組：正式發布，適用於所有 API 設定。

    用量洞察資料

    Google Cloud 控制台中的用量深入分析會顯示下列 API 方法的資料：

    • queryTopAggregatedInsightsData
    • queryTopTimeseriesInsightsData
    欄位名稱 詳細資料
    集合名稱

    集合群組名稱
    		 用量資料匯總依據的用量維度對應值。這可以是產品素材資源集合名稱或產品素材資源集合群組名稱
    讀取作業總數 非串流讀取作業總數。僅適用於 Standard 版本。
    寫入作業總數 非串流寫入作業總數。包括刪除作業。僅適用於 Standard 版本。
    串流讀取作業總數 用於串流 Listen 要求的讀取作業總數 (包括初始查詢輪詢、即時文件變更通知、略過的結果、索引讀取和最低讀取費用)。僅適用於 Standard 版本。
    串流寫入作業總數 StreamWrite 要求使用的寫入作業總數。包括刪除作業。僅適用於 Standard 版本。
    依據存留時間刪除的作業總數 依據存留時間刪除的作業總數。僅適用於 Standard 版本。
    讀取單元總數 非串流讀取的讀取單位總數 (4 KiB 為一組)。僅適用於 Enterprise 版本。
    寫入單元總數 非串流寫入作業的分組寫入單位總數 (1 KiB 為一組)。包含刪除單元。僅適用於 Enterprise 版本。
    依據存留時間刪除或代管刪除的作業總數 依據存留時間刪除或代管刪除的單元總數。僅適用於 Enterprise 版本。
    Eventarc 單位總數 Eventarc 單位總數。僅適用於 Enterprise 版本。
    串流讀取單元總數 在串流 Listen 要求中，用於輪詢作業的分組讀取單位 (4 KiB 為一組) 總數。僅適用於 Enterprise 版本。
    即時讀取單位總數 Listen 要求中，用於串流更新的即時讀取單位總數 (1 KiB 為一組)。僅適用於 Enterprise 版本。
    串流寫入單元總數 StreamWrite 要求使用的分組寫入單位 (1 KiB 為一組) 總數。包含刪除單元。僅適用於 Enterprise 版本。
    讀取的位元組總數 掃描的位元組總數。
    掃描文件總數 掃描的文件總數。
    掃描的索引項目總數 掃描的索引項目總數。
    寫入的文件總數 寫入的文件總數。
    寫入的索引項目總數 寫入的索引項目總數。
    寫入的文件大小總和 文件寫入總大小 (以位元組為單位)。

    限制

    • 不支援 Enterprise 版本的管理作業用量深入分析 (會產生可計費的讀取和寫入作業)，例如匯入/匯出、大量刪除、還原、複製和索引建構。
    • 不支援網路輸出和儲存空間計費。

    定價

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

    查看用量深入分析資訊

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

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

      前往「資料庫」

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

    3. 在導覽選單中，按一下「Usage Insights」(用量深入分析)。

      Google Cloud 控制台中原生模式資料庫的用量洞察

      使用「Group By」(分組依據) 下拉式選單，查看集合、collectionGroup 或命名空間的使用情形洞察資料。您最多可以查看過去 45 天的用量深入分析資料。