Übersicht über Key Visualizer
Diese Seite bietet einen Überblick über das Diagnosetool Key Visualizer für Firestore
Was ist Key Visualizer?
Key Visualizer ist ein Tool, das Sie bei der Analyse Ihrer Firestore-Nutzungsmuster unterstützt. Die Anwendung erstellt visuelle Berichte, in denen Ihre Nutzung basierend auf Dokumente, auf die Sie zugreifen, oder Einträge, die als geschrieben oder gelöscht wurden, Dokumente geändert werden.
Key Visualizer kann umfassende Einblicke in Nutzungsmuster liefern. Anwendungsmöglichkeiten für Key Visualizer:
- Leistungsprobleme beheben Key Visualizer hilft Ihnen bei der Identifizierung Probleme in Ihrer Datenbank verursachten, durch Hotspots von sequenziellen Dokument- oder Indexschlüsseln oder plötzlichen Trafficanstiegen.
- Sich ein genaueres Bild davon machen, wie der Zugriff auf die in Firestore gespeicherten Daten funktioniert.
- Iteratives Entwerfen eines Datenmodells oder Verbessern des Designs eines bestehenden Datenmodell. In jeder Iteration können Sie Key Visualizer überprüfen, um Probleme zu erkennen Ihres Datenmodells verursacht.
Mit Key Visualizer können Sie die folgenden Aufgaben ausführen, um diese Ziele zu erreichen:
- Prüfen, ob Lese- oder Schreibvorgänge Hotspots in bestimmten Dokumentbereichen verursachen.
- Erfahren, wie sich ein plötzlicher Anstieg des Traffics auf die Latenz auswirkt.
- Prüfen, ob Zugriffsmuster in der gesamten Datenbank ausgeglichen sind.
- Überprüfen Sie die Struktur der Indexschlüssel, um die Indexdefinitionen zu identifizieren, die Probleme beim Laden des Index verursachen.
- Verwenden Sie die Visualisierung der Indexschlüssel, um bessere Vorhersagen für Arbeitslastmuster zu treffen.
Voraussetzungen für Scans
Jeder Key Visualizer-Scan deckt einen Zeitraum von zwei Stunden ab. Ein Scan für einen bestimmten Zeitraum ist für Datenbanken mit mehr als 3.000 Dokumentenvorgängen verfügbar pro Minute in diesem Zeitraum.
Die Verfügbarkeit des Scans hängt vollständig von der Datenbankaktivität ab. Es kommt nicht darauf an, die Datenmenge oder den Datentyp in Ihrer Datenbank beeinflussen.
Key Visualizer-Scans
In der folgenden Abbildung sehen Sie einen Key Visualizer-Scan. Jeder Scan enthält eine Heatmap, in der Zugriffsmuster oder Leistungsmesswerte für eine Gruppe von Dokumentschlüsseln oder Indexschlüsseln im Zeitverlauf dargestellt werden.
Scan-URLs teilen
Sie können die URL eines Key Visualizer-Scans teilen oder als Lesezeichen speichern. Die URL wird geöffnet. Key Visualizer-Scan auswählen und denselben Messwert auswählen. Diese URL ist gültig, bis die Dauer der Datenerhebung abgelaufen ist.
Heatmaps
Der Kern eines Key Visualizer-Scans ist die Heatmap, die den Wert eines Messwerts im Zeitverlauf darstellt, wobei die Darstellung in bis zu 1.000 zusammenhängende Schlüssel-Buckets aufgeschlüsselt ist.
Bei einer Heatmap für Dokumentschlüssel stellt die x-Achse der Heatmap die Zeit dar. Die Y-Achse steht für Dokumentschlüssel, während für eine Indexschlüssel-Heatmap Die X-Achse der Heatmap stellt die Zeit dar und die Y-Achse die Indexschlüssel.
Jeder Key Visualizer-Scan für Firestore deckt zwei Stunden in 10-Sekunden-Segmente unterteilt ist.
Ein niedriger Wert für einen Messwert gilt als „kalt“. und erscheint in einer dunklen Farbe. Ein hoher Wert ist „heiß“ und wird in einer hellen Farbe dargestellt. Die Höchstwerte werden in Weiß dargestellt.
Unterschiedliche Nutzungsarten führen zu unterschiedlichen grafischen Mustern innerhalb der Heatmap. Dadurch lassen sich Probleme auf einen Blick diagnostizieren. Siehe Heatmap-Muster für Dokumentschlüssel oder Heatmap-Muster für Index Schlüssel. Hier finden Sie Beispiele für einige gängige Muster.
Key Visualizer bietet Tools, die Ihnen helfen, die Daten in den einzelnen Scans zu verstehen. Weitere Informationen finden Sie unter Einstieg in Key Visualizer und Heatmaps entdecken.
Schlüssel-Buckets
Key Visualizer teilt alle Schlüssel in Ihrer Datenbank in bis zu 1.000 zusammenhängende Bereiche mit ungefähr der gleichen Anzahl von Schlüsseln und Vorgänge in jedem Bereich. Diese Bereiche werden als Schlüssel-Buckets bezeichnet.
In Key Visualizer werden die Gesamtzahl der Vorgänge pro Sekunde einer Datenbank verwendet, um Schlüssel-Buckets so zu unterteilen, dass jeder Bucket ungefähr die gleiche Anzahl von Vorgängen pro Sekunde erfasst. Die Mindestgröße beträgt 50 Vorgänge pro Sekunde pro Schlüssel-Bucket. Bei Datenbanken mit einer höheren Gesamtzahl von Vorgängen pro Sekunde können Schlüssel-Buckets jeweils mehr als 50 Vorgänge pro Sekunde erfassen. Datenbanken mit weniger als 50 Ops/s führen zu Scans mit einem einzigen Schlüssel-Bucket.
Key Visualizer meldet die meisten Messwerte in Form eines Durchschnittswertes für den jeweiligen Schlüssel-Bucket oder als Maximalwert innerhalb des jeweiligen Schlüssel-Buckets.
Messwerte
Die folgenden Messwerte sind für Dokumentschlüssel in Key Visualizer-Scans verfügbar:
| Messwerte | Beschreibung |
|---|---|
| Aktivitätsmessdaten | |
| Ops/s (Vorgänge/Sekunde) | Durchschnittliche Anzahl der Dokumentvorgänge pro Sekunde. Das entspricht in etwa der Summe der Schreibvorgänge, Suchvorgänge und Abfragen pro Sekunde. Dieser Messwert kann anzeigen, welche Tasten häufig verwendet werden. |
| Write ops/s (Schreibvorgänge/Sekunde) | Durchschnittliche Anzahl der Dokumentvorgänge pro Sekunde für Schreib- und Löschvorgänge. |
| Lookup ops/s (Suchvorgänge/Sekunde) | Durchschnittliche Anzahl der Dokumentvorgänge pro Sekunde bei Suchvorgängen. |
| Query ops/s (Abfragevorgänge/Sekunde) | Durchschnittliche Anzahl der Dokumentvorgänge pro Sekunde für Abfragen. |
| Leistungsmesswerte | |
| Durchschnittliche Schreiblatenz | Durchschnittliche Latenz für Schreib- und Löschvorgänge innerhalb der verarbeiteten Daten im Bucket. |
| Durchschnittliche Suchvorgangslatenz | Durchschnittliche Latenz für Suchvorgänge innerhalb der verarbeiteten Daten im Bucket. |
| Durchschnittliche Abfragelatenz | Durchschnittliche Latenz für Abfragen innerhalb der verarbeiteten Daten im Bucket. |
| Extremwert-Schreiblatenz | Maximale beobachtete Latenz der Schreib- oder Löschvorgänge innerhalb der verarbeiteten Daten im Bucket. |
| Extremwert-Suchvorgangslatenz | Maximale beobachtete Suchvorgangslatenz innerhalb der verarbeiteten Daten im Bucket. |
| Extremwert-Abfragelatenz | Maximale beobachtete Abfragelatenz innerhalb der verarbeiteten Daten im Bucket. |
Der folgende Messwert ist für Indexschlüssel in Key Visualizer-Scans verfügbar:
| Messwerte | Beschreibung |
|---|---|
| Indexschreibvorgänge/s | Durchschnittliche Anzahl der Indexschreibvorgänge pro Sekunde. |
Durchschnittliche Leistungswerte
Die Messwerte für die durchschnittliche Latenz beziehen sich auf den Durchschnittswert der Schlüssel im Schlüssel-Bucket. Da diese Messung auf Speicherebene erfolgt, kann die gemeldete Latenz die Gesamtlatenz eines API-Aufrufs geringer sein kann.
Limits
Key Visualizer zeigt zwar eine Vielzahl von Messwerten, aber nicht jeden einzelnen Messwert an, der sich auf die Leistung von Firestore auswirken kann. Beispiel:
- Netzwerkprobleme zwischen Ihrer Anwendung und Google Cloud sichtbar sind. Sie werden möglicherweise als vertikale Bänder über alle Schlüssel in Key Visualizer angezeigt, sodass Sie nur Hinweise darauf erhalten, wann die Probleme aufgetreten sind.
Datenlebensdauer
Von Key Visualizer for Firestore erfasste Daten werden nach 14 Tagen gelöscht.
Key Visualizer-Daten bleiben 14 Tage lang verfügbar. Wenn Sie Key Visualizer beispielsweise am 19. Dezember um 12:45 Uhr starten, ist die früheste Startzeit einer Zeitspanne von zwei Stunden, die Sie auswählen können, der 5. Dezember um 13:00 Uhr.
Diese Beschränkung bedeutet auch, dass eine URL, die Sie für einen Key Visualizer-Scan als Lesezeichen speichern oder teilen, eine maximale Lebensdauer von 14 Tagen hat.
Nächste Schritte
- Einstieg in Key Visualizer
- Informieren Sie sich über die Muster für Dokumentschlüssel oder den Indexschlüssel. Muster, die Sie in Key Visualizer-Heatmaps sehen können.
- Wie Heatmaps im Detail untersucht werden