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:
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 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:
- 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 10-Minuten-Takt werden 4 Tage lang gespeichert, stündliche Daten 30 Tage lang.
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.
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 der Firebase Console:Rufen Sie in der Firebase Console die Seite Firestore Database auf.
Wählen Sie in der Liste der Datenbanken eine Enterprise-Datenbank aus.
Klicken Sie auf den Tab Query Insights.
Suchen Sie in der Abfragetabelle nach einer Abfrageform mit Empfehlungen und klicken Sie in der Zeile oder im Pop-over auf Empfehlungen prüfen.
Prüfen Sie im Dialogfeld für die Indexempfehlung die Definition des zusammengesetzten Index, die Feldreihenfolge und die geschätzte Auswirkung auf die Arbeitslast (HOCH, MITTEL oder NIEDRIG).
Klicken Sie auf Speichern. Der Bereich Vorgänge mit langer Ausführungszeit wird geöffnet, um den Fortschritt der Indexerstellung zu verfolgen.
Sobald der Build abgeschlossen ist, wird der Index auf dem Tab Indexe aufgeführt und die Empfehlungsanzeige verschwindet aus der Abfragezeile.
Unterstützte Versionen
Indexempfehlungen werden nur für Firestore Enterprise-Datenbanken unterstützt. Datenbanken der Standardversion werden nicht unterstützt.
Beschränkungen
- Query Insights-Daten sind um ein bis zwei Stunden verzögert.
- 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:
- Zum Aufrufen von Query Insights:
Datastore-Betrachter
(
roles/datastore.viewer) - So erstellen Sie empfohlene Datenspeicherindexe:
Datenspeicherindex-Administrator (
roles/datastore.indexAdmin) oder Cloud Datastore-Inhaber (roles/datastore.owner)
Diese vordefinierten Rollen enthalten die Berechtigungen datastore.insights.get und datastore.indexes.create.
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.