Einstieg in Key Visualizer

Auf dieser Seite wird beschrieben, wie Sie mit Key Visualizer nach Leistungsproblemen suchen, die mit Ihren Firestore-Nutzungsmustern zusammenhängen.

Hinweis

Wenn Sie Key Visualizer for Firestore verwenden möchten, müssen Sie die Firestore Key Visualizer API aktivieren.

Enable the API

Erforderliche Rollen

Ihrem Konto muss eine der folgenden IAM-Rollen zugewiesen sein:

  • Cloud Datastore-Inhaber
  • Cloud Datastore Key Visualizer-Betrachter
  • Editor
  • Inhaber

Diese Rollen enthalten die folgenden IAM-Berechtigungen, die für den Zugriff auf Key Visualizer erforderlich sind:

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

Sie können auch eine benutzerdefinierte Rolle mit den erforderlichen Berechtigungen definieren.

Scans für einen bestimmten Zeitraum abrufen

Jeder Key Visualizer-Scan deckt einen Zeitraum von zwei Stunden ab. Ein Scan für einen bestimmten Zeitraum ist für Datenbanken verfügbar, bei denen in einer bestimmten Minute in diesem Zeitraum mehr als 3.000 Dokumentvorgänge stattfinden.

So starten Sie Key Visualizer:

  1. Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.

    Zur Seite „Datenbanken“

  2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

  3. Klicken Sie im Navigationsmenü auf Key Visualizer.

  4. Wählen Sie einen Zeitraum und einen Messwert aus den verfügbaren Key Visualizer-Scans aus:

    1. Klicken Sie oben rechts auf das Stiftsymbol. Wählen Sie ein Datum und eine Zeitspanne aus.

      Scans sind abhängig von den Voraussetzungen für Scans verfügbar. Sie können keine Zeiträume auswählen, die nicht für den Scan infrage kommen oder die noch verarbeitet werden. Die beiden letzten Scans des Tages benötigen einige Zeit, bis sie verarbeitet und verfügbar sind.

    2. Wählen Sie als Quelle Alle Dokumentdaten oder Alle Indexdaten aus.

    3. Klicken Sie auf Aktualisieren.

  5. Wählen Sie einen Messwert für die Analyse aus:

    Klicken Sie links oben auf das Drop-down-Menü „Messwerte“ und wählen Sie einen Messwert aus. Der Key Visualizer wird standardmäßig mit dem Messwert Ops/s für Dokumentschlüssel und dem Messwert Index Write Ops/s für Indexschlüssel geöffnet.

Wenn Sie Messwerte vergleichen oder Datenkorrelationen untersuchen möchten, können Sie mehrere Key Visualizer-Messwerte gleichzeitig einblenden. Weitere Informationen finden Sie unter Verbindungen zwischen verschiedenen Messwerten finden.

Aktivitätsübersichten ansehen

In der Heatmap für den Standardmesswert erhalten Sie eine Übersicht über die Aktivitäten im ausgewählten Zeitraum von zwei Stunden.

Das folgende Beispiel zeigt eine Heatmap, bei der das Nutzungsmuster für die verschiedenen Schlüsselbereiche stark variiert:

  • Bereiche in dunklen Farben haben wenig oder keine Aktivität.
  • Bereiche in hellen Farben haben deutlich mehr Aktivität.
  • Der leuchtend weiße Bereich in der Mitte hat eine sehr hohe Aktivität.

Beispiel für einen Key Visualizer-Scan

Scannen von Dokumentschlüsseln

Der Messwert Ops/s gibt die Anzahl der Anfragen pro Sekunde für jeden Schlüsselbereich an. Dieser Messwert ist die Summe aus Schreib-, Such- und Abfrageanfragen. Key Visualizer zeigt standardmäßig diesen Messwert an, wenn Sie eine Heatmap öffnen.

Nachdem Sie sich einen Überblick über die Gesamtaktivität in Ihrer Datenbank verschafft haben, können Sie Ihre Untersuchung fortsetzen, indem Sie sich andere Messwerte ansehen und sich auf Schlüsselbereiche konzentrieren, die möglicherweise Probleme verursachen. Weitere Informationen

Indexschlüssel-Scan

Der Messwert Index Write Ops/s in einer bestimmten Zelle gibt die durchschnittlichen Indexeinträge pro Sekunde innerhalb des entsprechenden 10-Sekunden-Zeitraums und Schlüsselbereichs an.

Nächste Schritte