Statistiken zur Abfrageleistung analysieren
Auf dieser Seite wird beschrieben, wie Sie mit dem Query Insights-Dashboard die Abfrageleistung erkennen und analysieren.
Überblick über Query Insights
Verwenden Sie das Query Insights-Dashboard, um Abfragen im Zusammenhang mit Messwerten zu beobachten. 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 kann Ihnen bei Folgendem helfen:
- Optimierung der Abfrageleistung: Identifizieren Sie Abfragen mit hohen Latenzen und die möglicherweise optimiert werden müssen.
- Verwaltung der Abfragekosten: Ermitteln Sie Abfragen mit hohen Kosten und optimieren Sie sie, um Kosten zu senken.
- Monitoring von Abfragestatistiken: Verfolgen Sie Abfragestatistiken im Zeitverlauf.
Query Insights-Daten
Query Insights umfasst Daten aus den folgenden API-Methoden:
listDocumentslistCollectionIdsrunQueryrunAggregationQuerypartitionQueryexecutePipeline
Sie können Daten zu den Abfragen ansehen, 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 gleichwertigen Strukturen werden unter einer einzigen normalisierten Abfrage erfasst.
Query Insights gibt die folgenden Informationen zu einer Abfrage zurück:
| Normalisierter Abfragetext | Die Abfragestruktur in Textform. |
| Ausführungsanzahl | Anzahl der Ausführungen im ausgewählten Zeitraum. |
| Fehleranzahl | Anzahl der Fehler im ausgewählten Zeitraum. |
| Durchschnittliche Ausführungsdauer(in Millisekunden) | Die durchschnittliche Zeit in Millisekunden, die die Datenbank zum Verarbeiten der Abfrage benötigt hat. |
| Durchschnittliche Anzahl der zurückgegebenen Ergebnisse | Die Anzahl der von der Abfrage zurückgegebenen Ergebnisse. Zu den Ergebnissen gehören Dokumente, Sammlungs-IDs, und aggregierte Buckets. |
| Durchschnittliche Anzahl der gescannten Dokumente | Die Anzahl der in einer Abfrage gescannten Dokumente. |
| Durchschnittliche Anzahl der gescannten Indexeinträge | Die Anzahl der Indexeinträge, die zum Ausführen der Abfrage untersucht wurden. |
| Durchschnittliche Latenz | Daten, mit denen Sie nach den wichtigsten Abfragen basierend auf der durchschnittlichen Latenz filtern können. |
| Last nach insgesamt (abrechenbaren) Lesevorgängen | Daten, mit denen Sie nach den wichtigsten Abfragen basierend auf den abrechenbaren Lesevorgängen insgesamt filtern können. |
Datengranularität und -aufbewahrung
Die Datengranularität hängt von der angegebenen Dauer ab:
- 10-Minuten-Granularität für Intervalle bis zu 4 Tage zurück
- 1-Stunden-Granularität für Intervalle bis zu 30 Tage zurück
Die maximale Datenaufbewahrungsdauer für Query Insights beträgt 30 Tage. 10-Minuten-Daten werden 4 Tage lang und stündliche Daten 30 Tage lang gespeichert.
Beschränkungen
- Echtzeit-Listener sind nicht in den Query Insights-Statistiken enthalten.
- Query Insights-Daten sind um ein bis zwei Stunden verzögert.
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 zu gewähren, um die Berechtigung zum Aufrufen des Query Insights-Dashboards zu erhalten.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die
datastore.insights.get
Berechtigung,
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
Wenn Sie Abfragestatistiken für eine Firestore-Datenbank ansehen möchten, öffnen Sie in der Google Cloud Console den Bereich Query Insights für die Datenbank.
Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.
Wählen Sie in der Liste der Datenbanken eine Datenbank aus.
Klicken Sie im Navigationsmenü auf Query Insights.

Verwenden Sie das Drop-down-Menü Lasttyp , um die wichtigsten Abfragen nach Latenz oder Anzahl der Lesevorgänge zu finden.