分析查詢效能統計資料

本頁面說明如何使用「查詢洞察」資訊主頁,偵測及分析查詢效能。

查詢洞察總覽

使用查詢洞察資訊主頁,監控與指標相關的查詢。您可以根據指標,找出最常使用的查詢,以及可能需要最佳化的高延遲查詢。使用查詢洞察資訊主頁,即可:

  • 查詢效能最佳化:找出延遲時間過長且可能需要最佳化的查詢。
  • 查詢費用管理:找出高費用查詢並加以最佳化,降低費用。
  • 查詢統計資料監控:追蹤查詢統計資料的變化。
  • 索引建議:找出遺漏或不理想的複合式索引,並直接從資訊主頁建立建議的索引 (Enterprise 版本)。

查詢洞察資料

查詢洞察包含下列 API 方法的資料:

  • find
  • aggregate

您可以查看特定專案、資料庫和時間長度 (10 分鐘到 30 天) 內,使用這些方法的查詢資料。結構相同的查詢資料會彙整至單一正規化查詢。

查詢洞察會傳回下列查詢相關資訊:

正規化查詢文字 以文字表示的查詢結構。
執行次數 所選時間範圍內的執行作業數。
錯誤數 所選時間範圍內的錯誤數量。
平均執行時間 (毫秒) 資料庫處理查詢所需的平均時間 (以毫秒為單位)。
平均傳回的結果數 查詢傳回的結果數量。結果包括文件、集合 ID 和匯總值區。
平均掃描的文件數 查詢中掃描的文件數量。
平均掃描的索引項目數 為執行查詢而檢查的索引項目數量。
負載 (根據平均時間) 根據平均延遲時間篩選出熱門查詢的資料。
負載 (根據總計 (可計費) 讀取作業數) 根據可計費讀取作業總數,篩選出熱門查詢的資料。
索引建議 Enterprise 版資料庫中查詢的建議複合索引、已用索引和預估工作負載影響。

資料精細程度和保留

資料精細程度取決於指定的期間:

  • 間隔時間最長為 4 天前,精細程度為 10 分鐘
  • 以 1 小時為單位,最長可回溯至 30 天前

查詢洞察的資料保留期限上限為 30 天。10 分鐘資料會儲存 4 天,每小時資料則會儲存 30 天。

查看查詢洞察

Firebase 控制台
  1. 如要查看 Cloud Firestore 資料庫的查詢洞察,請在 Google Cloud 控制台中開啟資料庫的「Query insights」(查詢洞察) 窗格。
  2. 在 Firebase 控制台中,前往「Firestore Database」頁面。

    前往 Firestore 資料庫

  3. 從資料庫清單中選取資料庫。
  4. 在分頁清單中,按一下「查詢洞察」。

    如要根據延遲時間或讀取作業數量找出熱門查詢,請按一下「Latency」(延遲時間) 或「Read operations」(讀取作業)。

索引建議

Firestore Enterprise 版資料庫中,查詢洞察的索引建議會自動找出經常執行的查詢模式,並指出缺少或不理想的複合索引設定。

在 Firestore Enterprise 版中,即使沒有相符的複合索引,也能執行查詢,但可能會導致完整集合掃描或記憶體內排序作業速度緩慢。「查詢洞察」資訊主頁會分析歷來查詢執行統計資料,並建議指定複合索引,以最佳化查詢延遲時間,並減少計費掃描文件。

索引建議的運作方式

離線批次管道會定期評估熱門查詢記錄:

  • 查詢結構分析:從經常執行的查詢中,擷取等式、排序和範圍述詞。
  • 候選索引生成:使用索引排序經驗法則 (等式 > 排序 > 範圍),生成潛在複合式索引定義。
  • 最佳化工具評估:將候選索引插入查詢引擎的成本模型,比較基準查詢執行成本與假設的索引執行計畫。
  • 工作負載影響排名:根據預估的工作負載總節省費用,將建議的索引分為不同影響層級:
    • 高:將完整集合掃描轉換為選擇性索引搜尋,大幅減少文件讀取次數和執行延遲時間。
    • MEDIUM:提供預先排序的索引結果,省去記憶體內排序等高成本作業。
    • 低:略微改善搜尋功能。
如要查看索引建議,並透過 Firebase 控制台建立建議的索引,請按照下列步驟操作:

  1. 在 Firebase 控制台中,前往「Firestore Database」頁面。

    前往 Firestore 資料庫

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

  3. 按一下「查詢洞察」分頁標籤。

  4. 在查詢表格中,找出有建議的查詢形狀,然後按一下資料列或彈出式視窗中的「Review Recommendations」(查看建議)。

  5. 在索引建議對話方塊中,查看複合索引定義、欄位排序,以及預估的工作負載影響層級 (「HIGH」、「MEDIUM」或「LOW」)。

  6. 按一下「儲存」。「Long-Running Operations (LRO)」(長時間執行的作業 (LRO)) 導覽匣會開啟,追蹤索引建構進度。

  7. 建構作業完成後,索引會列在「Indexes」(索引) 分頁下方,且建議指標會從查詢列中消失。

支援的版本

索引建議僅適用於 Firestore Enterprise 版資料庫。不支援 Standard 版資料庫。

限制

  • 查詢洞察資料會延遲一到兩小時。
  • 系統會根據歷來查詢資料定期產生索引建議,而非即時產生。
  • 索引建議會建議新的複合式索引,不會建議修改或刪除現有索引。
  • 不支援自動建立索引,必須手動建立建議的索引。
  • 查詢正規化會將常值替換為預留位置。索引建議是根據正規化查詢範本產生,而非特定執行階段值。
  • 費用評估會使用經驗法則,而非即時資料取樣。建議的索引不一定能在所有情境中提升效能,且建立索引會增加寫入和儲存負擔。

定價

使用查詢洞察或索引建議功能,無須額外付費。

必要的角色

如要取得查看「查詢洞察」資訊主頁和建立建議索引所需的權限,請要求管理員授予您專案的下列 IAM 角色:

這些預先定義的角色包含 datastore.insights.get 和 datastore.indexes.create 權限。

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

後續步驟