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