本頁面說明如何使用「查詢洞察」資訊主頁，偵測及分析查詢效能。
查詢洞察總覽
使用查詢洞察資訊主頁，監控與指標相關的查詢。您可以根據指標，找出最常使用的查詢，以及可能需要最佳化的高延遲查詢。使用查詢洞察資訊主頁，可協助您：
- 查詢效能最佳化：找出延遲時間過長且可能需要最佳化的查詢。
- 查詢費用管理：找出高費用查詢並加以最佳化，降低費用。
- 查詢統計資料監控：追蹤查詢統計資料隨時間的變化。
查詢洞察資料
查詢洞察包含下列 API 方法的資料：
listDocumentslistCollectionIdsrunQueryrunAggregationQuerypartitionQueryexecutePipeline
您可以查看特定專案、資料庫和時間範圍 (10 分鐘到 30 天) 內，使用這些方法的查詢資料。結構相同的查詢資料會彙整到單一正規化查詢中。
查詢洞察會傳回下列查詢相關資訊：
| 正規化查詢文字 | 以文字表示的查詢結構。 |
| 執行次數 | 所選時間範圍內的執行次數。 |
| 錯誤數 | 所選時間範圍內的錯誤數量。 |
| 平均執行時間(毫秒) | 資料庫處理查詢所需的平均時間 (以毫秒為單位)。 |
| 平均傳回的結果數 | 查詢傳回的結果數量。結果包括文件、集合 ID 和匯總值區。 |
| 平均掃描的文件數 | 查詢中掃描的文件數量。 |
| 平均掃描的索引項目數 | 為執行查詢而檢查的索引項目數量。 |
| 平均延遲時間 | 根據平均延遲時間篩選熱門查詢的資料。 |
| 負載 (根據可計費讀取作業總數) | 根據可計費讀取作業總數，篩選出熱門查詢的資料。 |
資料精細程度和保留
資料精細程度取決於指定的期間：
- 間隔時間最長為 4 天前，精細程度為 10 分鐘
- 以 1 小時為間隔，最長可回溯至 30 天前
查詢洞察的資料保留期限上限為 30 天。10 分鐘資料會儲存 4 天，每小時資料會儲存 30 天。
限制
- 查詢洞察資料會延遲一到兩小時。
定價
使用查詢洞察功能不需額外付費。
必要的角色
如要取得查看「查詢洞察」資訊主頁所需的權限，請要求管理員授予您專案的 Datastore 檢視者 (roles/datastore.viewer) IAM 角色。
這個預先定義的角色具備 datastore.insights.get 權限，可查看查詢洞察資訊主頁。
查看查詢洞察
如要查看 Cloud Firestore 資料庫的查詢洞察，請在 Google Cloud 控制台中開啟資料庫的「Query insights」(查詢洞察) 窗格。
前往 Google Cloud 控制台的「Databases」(資料庫) 頁面。
從資料庫清單中選取資料庫。
在導覽選單中，點選「查詢洞察」。
使用「Load type」(負載類型) 下拉式選單，依延遲時間或讀取作業數量找出熱門查詢。