Einstieg in Key Visualizer

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

Hinweis

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

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Informationen zum Zuweisen von Rollen.

API aktivieren

Erforderliche Rollen

Achten Sie darauf, dass Ihrem Konto eine der folgenden IAM-Rollen zugewiesen ist:

  • 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 mit Traffic verfügbar, der in einer beliebigen Minute dieses Zeitraums 3.000 Dokumentvorgänge übersteigt.

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 einen Zeitraum aus.

      Scans sind je nach Scan-Berechtigung verfügbar. Sie können keine Zeiträume auswählen, die die Berechtigungsvoraussetzungen für Scans nicht erfüllen oder noch verarbeitet werden. Die Verarbeitung der beiden letzten Scans des Tages dauert einige Zeit, bevor sie verfügbar sind.

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

    3. Klicken Sie auf Aktualisieren.

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

    Klicken Sie oben links auf das Drop-down-Menü „Messwerte“ und wählen Sie einen Messwert aus, der angezeigt werden soll. Key Visualizer wird standardmäßig mit dem Messwert Vorgänge/s für Dokumentschlüssel und dem Messwert Index-Schreibvorgänge/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 Korrelationen zwischen verschiedenen Messwerten ermitteln.

Aktivitätsübersichten ansehen

Eine Übersicht über die Aktivität im ausgewählten Zeitraum von zwei Stunden erhalten Sie in der Heatmap für den Standardmesswert.

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

Scan von Dokumentschlüsseln

Der Messwert Vorgänge/s gibt die Anzahl der Anfragen pro Sekunde für jeden Schlüsselbereich an. Dieser Messwert ist die Summe der 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.

Scan von Indexschlüsseln

Der Messwert Index-Schreibvorgänge/s in einer bestimmten Zelle gibt die durchschnittliche Anzahl der Indexschreibvorgänge pro Sekunde innerhalb des entsprechenden 10-Sekunden-Intervalls und Schlüsselbereichs an.

Nächste Schritte