Auf dieser Seite wird beschrieben, wie Sie mit dem Query Insights-Dashboard die Abfrageleistung erkennen und analysieren.
Query Insights – Übersicht
Verwenden Sie das Query Insights-Dashboard, um messwertbezogene Abfragen zu überwachen. Anhand der Messwerte können Sie die am häufigsten verwendeten Abfragen und Abfragen mit hohen Latenzen identifizieren, die möglicherweise optimiert werden müssen. Das Query Insights-Dashboard bietet Ihnen folgende Möglichkeiten:
- Optimierung der Abfrageleistung: Identifizieren Sie Abfragen mit hohen Latenzen, die möglicherweise optimiert werden müssen.
- Abfragekosten verwalten: Sie können kostenintensive Abfragen ermitteln und optimieren, um die Kosten zu senken.
- Monitoring von Abfragestatistiken: Abfragestatistiken im Zeitverlauf verfolgen.
Query Insights-Daten
Query Insights enthält Daten aus den folgenden API-Methoden:
findaggregate
Sie können Daten zu den Abfragen aufrufen, die diese Methoden für ein bestimmtes Projekt, eine bestimmte Datenbank und einen bestimmten Zeitraum von 10 Minuten bis 30 Tagen verwenden. Daten für Abfragen mit äquivalenten Strukturen werden unter einer einzigen normalisierten Abfrage erfasst.
Query Insights gibt die folgenden Informationen zu einer Abfrage zurück:
| Normalisierter Abfragetext | Die Abfragestruktur, dargestellt als Text. |
| Ausführungsanzahl | Anzahl der Ausführungen im ausgewählten Zeitfenster. |
| Fehleranzahl | Anzahl der Fehler im ausgewählten Zeitfenster. |
| Durchschnittliche Ausführungsdauer(ms) | Die durchschnittliche Zeit in Millisekunden, die die Datenbank für die Verarbeitung der Abfrage benötigt hat. |
| Durchschnittliche Anzahl der zurückgegebenen Ergebnisse | Die Anzahl der von der Abfrage zurückgegebenen Ergebnisse. Die Ergebnisse umfassen Dokumente, Sammlungs-IDs und aggregierte Buckets. |
| Durchschnittliche Anzahl der gescannten Dokumente | Die Anzahl der Dokumente, die in einer Abfrage gescannt wurden. |
| Durchschnittliche Anzahl der gescannten Indexeinträge | Die Anzahl der Indexeinträge, die zur Ausführung der Abfrage geprüft wurden. |
| Last nach durchschnittlicher Zeit | Daten, mit denen die häufigsten Abfragen nach durchschnittlicher Latenz gefiltert werden können. |
| Last nach (abrechenbaren) Lesevorgängen insgesamt | Daten, mit denen Sie nach den Top-Abfragen basierend auf den abrechenbaren Lesevorgängen insgesamt filtern können. |
Detaillierungsgrad und Aufbewahrung von Daten
Der Detaillierungsgrad der Daten hängt von der angegebenen Dauer ab:
- 10-Minuten-Granularität für Intervalle bis zu 4 Tagen
- 1 Stunde für Intervalle bis zu 30 Tage zurück
Die maximale Datenaufbewahrung für Query Insights beträgt 30 Tage. Daten im 10-Minuten-Takt werden 4 Tage lang gespeichert, stündliche Daten 30 Tage lang.
Beschränkungen
Query Insights-Daten werden mit einer Verzögerung von ein bis zwei Stunden angezeigt.
Preise
Für Query Insights fallen keine zusätzlichen Kosten an.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Datastore-Betrachter (roles/datastore.viewer) für Ihr Projekt zuzuweisen, um die Berechtigung zum Aufrufen des Query Insights-Dashboards zu erhalten.
Diese vordefinierte Rolle enthält die Berechtigung datastore.insights.get, die zum Aufrufen des Query Insights-Dashboards erforderlich ist.
Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Query Insights ansehen
Firebase Console
- Wenn Sie Query Insights für eine Cloud Firestore-Datenbank aufrufen möchten, öffnen Sie in der Google Cloud Console den Bereich Query Insights der Datenbank.
Rufen Sie in der Firebase Console die Seite Firestore Database auf.
- Wählen Sie eine Datenbank aus der Liste der Datenbanken aus.
- Klicken Sie in der Liste der Tabs auf Query Insights.
Wenn Sie die Top-Abfragen nach Latenz oder Anzahl der Lesevorgänge suchen möchten, klicken Sie auf Latenz oder Lesevorgänge.