Diese Seite bietet eine Übersicht über das Key Visualizer-Diagnosetool für Firestore im Datastore-Modus.
Was ist Key Visualizer?
Key Visualizer ist ein Tool, mit dem Sie Ihre Nutzungsmuster im Datastore-Modus analysieren können. Das Tool generiert visuelle Berichte, in denen Ihre Nutzung basierend auf den Entitäten aufgeschlüsselt wird, auf die Sie zugreifen, oder auf Indexeinträgen, die geschrieben oder gelöscht werden, wenn Entitäten geändert werden.
Key Visualizer kann umfassende Einblicke in Nutzungsmuster geben. Anwendungsmöglichkeiten für Key Visualizer:
- Leistungsprobleme beheben Key Visualizer unterstützt Sie beim Identifizieren von Leistungsproblemen in Ihrer Datenbank, die durch Hotspots durch sequentielle Entitäten- oder Indexschlüssel oder plötzliche Traffic-Anstiege verursacht werden.
- Sich ein genaueres Bild davon machen, wie der Zugriff auf die im Datastore-Modus gespeicherten Daten funktioniert.
- Iteratives Entwerfen eines Datenmodells oder Verbesserung des Designs eines vorhandenen Datenmodells. Bei jeder Iteration können Sie Key Visualizer überprüfen, um Probleme zu erkennen, die Ihr Datenmodell 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 Entitätsbereichen 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 von Arbeitslastmustern 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 Traffic verfügbar, der in einer bestimmten Minute innerhalb dieses Zeitraums 3.000 Dokumentvorgänge überschreitet.
Ob ein Scan möglich ist, hängt vollständig von der Datenbankaktivität ab. Sie hängt nicht von der Datenmenge oder dem Datentyp in der Datenbank ab.
Key Visualizer-Scans
In der folgenden Abbildung sehen Sie einen Key Visualizer-Scan. Jeder Scan enthält eine Heatmap, die Zugriffsmuster oder Leistungsmesswerte für eine Gruppe von Entitätsschlüsseln oder Indexschlüsseln im Zeitverlauf zeigt.
Scan-URLs teilen
Sie können die URL eines Key Visualizer-Scans teilen oder als Lesezeichen speichern. Über die URL wird derselbe Key Visualizer-Scan geöffnet und derselbe Messwert ausgewählt. Diese URL ist gültig, bis die Dauer der Scandaten abläuft.
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 Entitätsschlüssel stellt die x-Achse der Heatmap die Zeit und die y-Achse die Entitätsschlüssel dar. Bei einer Indexschlüssel-Heatmap stellt die X-Achse der Heatmap die Zeit und die y-Achse die Indexschlüssel dar.
Jeder Key Visualizer-Scan für Firestore im Datastore-Modus deckt die Aktivität von zwei Stunden ab, die in Segmente von 10 Sekunden unterteilt sind.
Ein niedriger Wert für einen Messwert wird als „kalt“ betrachtet und erscheint dunkler. Ein hoher Wert ist „heiß“ und erscheint als leuchtende Farbe. Die höchsten Werte werden weiß dargestellt.
Unterschiedliche Nutzungsarten führen zu unterschiedlichen grafischen Mustern innerhalb der Heatmap. Dadurch lassen sich Probleme auf einen Blick diagnostizieren. Beispiele für einige gängige Muster finden Sie unter Heatmap-Muster für Entitätsschlüssel oder Heatmap-Muster für Indexschlüssel.
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 derselben Anzahl von Schlüsseln in jedem Bereich auf. Diese Bereiche werden als Schlüssel-Buckets bezeichnet.
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 Entitätsschlüssel in Key Visualizer-Scans verfügbar:
| Messwerte | Beschreibung |
|---|---|
| Aktivitätsmessdaten | |
| Ops/s | Durchschnittliche Anzahl der Entitätsvorgänge pro Sekunde. Entspricht in etwa der Summe der Schreibvorgänge, Lookups und Abfragen pro Sekunde. Dieser Messwert kann angeben, welche Schlüssel besonders häufig verwendet werden. |
| Write ops/s (Schreibvorgänge/Sekunde) | Durchschnittliche Anzahl der Entitätsvorgänge pro Sekunde für Schreib- und Löschvorgänge. |
| Lookup ops/s (Suchvorgänge/Sekunde) | Durchschnittliche Anzahl der Entitätsvorgänge pro Sekunde für Lookups. |
| Query ops/s (Abfragevorgänge/Sekunde) | Durchschnittliche Anzahl der Entitätsvorgänge pro Sekunde für Abfragen. |
| Leistungsmesswerte | |
| Durchschnittliche Schreiblatenz | Durchschnittliche Latenz für Schreib- und Löschvorgänge in den 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 | Durchschnittliche Anzahl der Indexschreibvorgänge pro Sekunde. |
Durchschnittliche Leistungswerte
Durchschnittliche Latenzmesswerte ermitteln einen Durchschnitt über die Schlüssel im Schlüssel-Bucket. Da diese Messung auf Speicherebene erfolgt, ist die hier gemeldete Latenz möglicherweise geringer als die Gesamtlatenz bei einem API-Aufruf.
Limits
Key Visualizer zeigt zwar eine Vielzahl von Messwerten, aber nicht jeden einzelnen Messwert an, der sich auf die Leistung des Datastore-Modus auswirken kann. Beispiel:
- Netzwerkprobleme zwischen Ihrer Anwendung und Google Cloud sind möglicherweise nicht sichtbar. Sie können in Key Visualizer als vertikale Bänder über alle Schlüssel hinweg angezeigt werden und geben Ihnen nur Hinweise darauf, wann die Probleme aufgetreten sind.
Datenlebensdauer
Daten, die von Key Visualizer für Firestore im Datastore-Modus erfasst werden, 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
- Informationen zu Entitätsschlüsselmustern oder Indexschlüsselmustern, die Sie möglicherweise in Key Visualizer-Heatmaps sehen
- Wie Heatmaps im Detail untersucht werden