Statistiken zur Abfrageleistung analysieren
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: Ermitteln Sie kostenintensive Abfragen und optimieren Sie sie, um die Kosten zu senken.
- Monitoring von Abfragestatistiken: Abfragestatistiken im Zeitverlauf verfolgen.
- Indexempfehlungen: Fehlende oder suboptimale zusammengesetzte Indexe identifizieren und empfohlene Indexe direkt über das Dashboard erstellen (Enterprise-Version).
Query Insights-Daten
Query Insights enthält Daten aus den folgenden API-Methoden:
Sie können Daten zu den Abfragen aufrufen, die diese Methoden für ein bestimmtes Projekt, eine bestimmte Datenbank und einen bestimmten Zeitraum von 1 Minute 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 die Top-Abfragen nach den abrechenbaren Lesevorgängen insgesamt gefiltert werden können. |
| Indexempfehlungen | Empfohlene zusammengesetzte Indexe, verwendete Indexe und geschätzte Auswirkungen auf die Arbeitslast für Abfragen in Datenbanken der Enterprise-Version. |
Detaillierungsgrad und Aufbewahrung von Daten
Die Datengranularität hängt von der angegebenen Dauer ab:
- 1 Minute Granularität für Intervalle bis zu 6 Stunden in der Vergangenheit
- 10-Minuten-Granularität für Intervalle bis zu 4 Tagen
- 1 Stunde für Intervalle bis zu 30 Tagen
Die maximale Datenaufbewahrung für Query Insights beträgt 30 Tage. Daten im 1-Minuten-Takt werden 6 Stunden lang gespeichert, Daten im 10-Minuten-Takt 4 Tage lang und stündliche Daten 30 Tage lang.
Query Insights ansehen
So rufen Sie Query Insights für eine Firestore-Datenbank auf:
Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.
Wählen Sie eine Datenbank aus der Liste der Datenbanken aus.
Klicken Sie im Navigationsmenü auf Query Insights.
Auf der Seite Query Insights wird ein Zeitreihendiagramm Ihrer Top-Abfragen sowie eine Tabelle mit normalisierten Abfragestatistiken angezeigt. So analysieren Sie die Abfrageleistung:
- Wählen Sie einen Zeitraum aus, um historische Trends oder Messwerte nahezu in Echtzeit in 1-Minuten-Intervallen anzusehen.
- Verwenden Sie die Liste Lasttyp, um die Top-Abfragen entweder nach durchschnittlicher Latenz oder nach Gesamtzahl der Lesevorgänge zu ordnen.
- Wählen Sie einzelne Abfragen in der Tabelle aus, um deren Ausführungsanzahl, Latenz, gescannte Dokumente, gescannte Indexeinträge und Fehleranzahl im Diagramm darzustellen und zu vergleichen.
Indexempfehlungen
Indexempfehlungen für Query Insights identifizieren automatisch fehlende oder suboptimale zusammengesetzte Indexkonfigurationen für häufig ausgeführte Abfrageformen in Firestore Enterprise-Datenbanken.In der Firestore Enterprise-Version können Abfragen auch ohne übereinstimmende zusammengesetzte Indexe ausgeführt werden. Dies kann zu langsamen Scans der gesamten Sammlung oder zu Sortiervorgängen im Arbeitsspeicher führen. Im Query Insights-Dashboard werden Statistiken zur bisherigen Abfrageausführung analysiert und gezielte zusammengesetzte Indexe vorgeschlagen, um die Abfragelatenz zu optimieren und die Anzahl der abrechenbaren gescannten Dokumente zu reduzieren.
Funktionsweise von Indexempfehlungen
Eine Offline-Batch-Pipeline wertet regelmäßig die am häufigsten gestellten Abfragen aus:
- Analyse der Abfragestruktur: Extrahiert Gleichheits-, Sortier- und Bereichsprädikate aus häufig ausgeführten Abfragen.
- Generierung von Indexkandidaten: Generiert potenzielle zusammengesetzte Indexdefinitionen mithilfe von Heuristiken für die Indexreihenfolge (Gleichheit > Sortierung > Bereich).
- Optimierer-Bewertung: Fügt Kandidatenindexe in das Kostenmodell der Abfrage-Engine ein, um die Baseline-Kosten für die Abfrageausführung mit hypothetischen indexierten Ausführungsplänen zu vergleichen.
- Ranking der Auswirkungen auf die Arbeitslast: Empfohlene Indexe werden basierend auf den geschätzten Gesamtkosteneinsparungen für die Arbeitslast in Auswirkungsstufen eingeteilt:
- HOCH: Konvertiert vollständige Sammlungsscans in selektive Indexsuchen, wodurch die Anzahl der Dokumentlesevorgänge und die Ausführungslatenz erheblich reduziert werden.
- MITTEL: Eliminiert teure Vorgänge wie die Sortierung im Arbeitsspeicher, indem vorsortierte Indexergebnisse bereitgestellt werden.
- NIEDRIG: Bietet geringfügige Verbesserungen beim Suchen.
Empfohlene Indexe ansehen und erstellen
So rufen Sie Indexempfehlungen auf und erstellen vorgeschlagene Indexe in derGoogle Cloud Console:Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.
Wählen Sie in der Liste der Datenbanken eine Enterprise-Datenbank aus.
Klicken Sie im Navigationsmenü auf Query Insights.
Wählen Sie in der Abfragetabelle eine Abfrageform aus, um die Karte Empfehlungen aufzurufen. Auf der Karte wird Folgendes angezeigt:
- Die empfohlene Definition des zusammengesetzten Index (Sammlung, Felder, Sortierreihenfolgen oder „array-contains“-Attribute).
- Die geschätzte Auswirkungsstufe für die Arbeitslast (HIGH, MEDIUM oder LOW).
- Die verwendeten Indexe oder ein Hinweis darauf, dass ein vollständiger Sammlungsscan durchgeführt wird.
Klicken Sie auf der Empfehlungskarte auf Index erstellen. Ein Dialogfeld wird geöffnet, in dem die Sammlung, der Abfragebereich und die Felder vorab ausgefüllt sind.
Klicken Sie auf Erstellen, um mit dem Erstellen des Index zu beginnen. Sie können den Fortschritt der Indexerstellung auf der Seite Indexe in der Google Cloud Console beobachten.
Unterstützte Versionen und Modi
Indexempfehlungen werden für Datenbanken der Firestore Enterprise-Version unterstützt, darunter:
- Firestore im nativen Modus
- Firestore mit MongoDB-Kompatibilität
Datenbanken der Standard-Edition werden für Indexempfehlungen nicht unterstützt.
Beschränkungen
- Echtzeit-Listener sind nicht in den Query Insights-Statistiken enthalten.
- Query Insights-Daten sind innerhalb von Minuten nach der Abfrageausführung verfügbar.
- Indexempfehlungen werden regelmäßig auf Grundlage von Verlaufsdaten zu Abfragen generiert, nicht in Echtzeit.
- Indexempfehlungen schlagen neue zusammengesetzte Indexe vor. Sie schlagen nicht vor, vorhandene Indexe zu ändern oder zu löschen.
- Die automatische Indexerstellung wird nicht unterstützt. Empfohlene Indexe müssen manuell erstellt werden.
- Bei der Abfragenormalisierung werden Literalwerte durch Platzhalter ersetzt. Indexempfehlungen basieren auf normalisierten Abfragevorlagen und nicht auf bestimmten Laufzeitwerten.
- Bei der Kostenbewertung werden Heuristiken anstelle von Live-Stichprobenerhebung verwendet. Empfohlene Indexe verbessern die Leistung möglicherweise nicht in jedem Szenario. Außerdem erhöht das Erstellen eines Index den Schreib- und Speicheraufwand.
Preise
Für Query Insights oder Indexempfehlungen fallen keine zusätzlichen Kosten an.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen des Query Insights-Dashboards und zum Erstellen empfohlener Indexe benötigen:
-
Query Insights aufrufen:
Datastore-Betrachter (
roles/datastore.viewer) -
Empfohlene Indexe erstellen:
- Datenspeicherindex-Administrator (
roles/datastore.indexAdmin) - Cloud Datastore-Inhaber (
roles/datastore.owner) - Bearbeiter (
roles/editor) - Inhaber (
roles/owner)
- Datenspeicherindex-Administrator (
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Aufrufen des Query Insights-Dashboards und zum Erstellen empfohlener Indexe erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um das Query Insights-Dashboard aufzurufen und empfohlene Indexe zu erstellen:
-
Query Insights ansehen:
datastore.insights.get -
Empfohlene Indexe erstellen:
-
datastore.indexes.create -
datastore.indexes.update
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Nächste Schritte
- Abfrageerklärung verwenden, um die Abfrageleistung zu verbessern
- Nutzung im Blick behalten