Übersicht über Key Visualizer

Diese Seite bietet einen Überblick über das Diagnosetool Key Visualizer für Cloud Firestore.

Was ist Key Visualizer?

Key Visualizer ist ein Tool, das Sie bei der Analyse Ihrer Cloud Firestore Nutzungsmuster unterstützt. Es generiert grafische Berichte, die Ihre Nutzung basierend auf den Dokumenten aufgliedern, auf die Sie zugreifen, oder auf Indexeinträgen, die geschrieben oder gelöscht werden, wenn Dokumente geändert werden.

Key Visualizer kann umfassende Einblicke in Nutzungsmuster geben. Anwendungsmöglichkeiten für Key Visualizer:

  • Leistungsprobleme beheben Mit Key Visualizer können Sie Leistungsprobleme in Ihrer Datenbank identifizieren, die durch Hotspots durch sequenzielle Dokument- oder Indexschlüssel oder plötzliche Erhöhungen des Traffics verursacht werden.
  • Besseres Verständnis dafür, wie Sie auf die in Cloud Firestore gespeicherten Daten zugreifen
  • Ein Datenmodell iterativ entwerfen oder das Design eines vorhandenen Datenmodells verbessern Bei jeder Iteration können Sie Key Visualizer prüfen, um Probleme zu ermitteln, 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 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.
  • Prüfen Sie die Struktur der Indexschlüssel, um die Indexdefinitionen zu identifizieren, die Probleme mit der Indexlast verursachen.
  • Verwenden Sie die Visualisierung der Indexschlüssel, um bessere Vorhersagen zu 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 beliebigen Minute dieses Zeitraums 3.000 Dokumentvorgänge übersteigt.

Die Voraussetzungen für Scans hängen vollständig von der Datenbankaktivität ab. Sie hängen nicht von der Datenmenge oder dem Datentyp in Ihrer 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 Dokumentschlüsseln oder Indexschlüsseln im Zeitverlauf zeigt.

Beispiel für einen Key Visualizer-Scan

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 Lebensdauer 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 Dokumentschlüssel stellt die X-Achse der Heatmap die Zeit dar und die Y-Achse die Dokumentschlüssel. Bei einer Heatmap für Indexschlüssel stellt die X-Achse der Heatmap die Zeit dar und die Y-Achse die Indexschlüssel.

Jeder Key Visualizer-Scan für Cloud Firestore deckt die Aktivität von zwei Stunden ab, die in Segmente von 10 Sekunden unterteilt sind.

Ein niedriger Wert für einen Messwert gilt als „kalt“ und wird in einer dunklen Farbe dargestellt. Ein hoher Wert ist „heiß“ und wird in einer hellen Farbe dargestellt. Die Höchstwerte werden in Weiß abgebildet.

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 Dokumentschlüssel oder Heatmap-Muster für Index schlü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 unterteilt alle Schlüssel in Ihrer Datenbank in bis zu 1.000 zusammenhängende Bereiche mit ungefähr derselben Anzahl von Schlüsseln und Ops/s in jedem Bereich. Diese Bereiche werden als Schlüssel-Buckets bezeichnet.

Key Visualizer verwendet die Gesamt-Ops/s einer Datenbank, um Schlüssel-Buckets so zu unterteilen, dass jeder Bucket ungefähr dieselbe Anzahl von Ops/s erfasst, wobei eine Mindestgröße von 50 Ops/s pro Schlüssel-Bucket angestrebt wird. Bei Datenbanken mit höheren Gesamt-Ops/s können Schlüssel-Buckets jeweils mehr als 50 Ops/s erfassen. Bei Datenbanken mit weniger als 50 Ops/s werden Scans mit einem einzelnen Schlüssel-Bucket erstellt.

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. Entspricht ungefähr der Summe der Schreibvorgänge, Suchvorgänge und Abfragen pro Sekunde. Dieser Messwert kann angeben, welche Schlüssel Hotspots sind.
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 für Suchvorgänge.
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
Index-Schreibvorgänge/Sekunde Durchschnittliche Anzahl der Indexschreibvorgänge pro Sekunde.

Durchschnittliche Leistungswerte

Bei den Messwerten für die durchschnittliche Latenz wird ein Durchschnittswert für die Schlüssel im Schlüssel-Bucket berechnet. Da diese Messung auf der Speicherebene erfolgt, ist die hier angegebene Latenz möglicherweise niedriger als die Gesamtlatenz eines API-Aufrufs.

Limits

Key Visualizer zeigt zwar eine Vielzahl von Messwerten, aber nicht jeden einzelnen Messwert an, der sich auf die Leistung von Cloud Firestore auswirken kann. Beispiel:

  • Netzwerkprobleme zwischen Ihrer Anwendung und Google Cloud sind möglicherweise nicht sichtbar. 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

Daten, die von Key Visualizer für Cloud Firestore 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