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.

Erforderliche Rollen zum Aktivieren von APIs

Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

API aktivieren

Erforderliche Rollen

Ihr Konto muss eine der folgenden IAM-Rollen haben:

  • 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 in diesem Zeitraum 3.000 Dokumentvorgänge überschreitet.

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 verfügbar, wenn die Voraussetzungen für Scans erfüllt sind. Sie können keine Zeiträume auswählen, die nicht für den Scan infrage kommen oder noch verarbeitet werden. Die Verarbeitung der beiden letzten Scans des Tages dauert einige Zeit, bevor sie 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ü für Messwerte und wählen Sie einen Messwert aus. Key Visualizer wird standardmäßig mit dem Messwert Vorgänge/s für Dokumentschlüssel und dem Messwert Indexschreibvorgänge/s für Indexschlüssel geöffnet.

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

Aktivitätsübersichten ansehen

Sehen Sie sich die Heatmap für den Standardmesswert an, um einen Überblick über die Aktivität im ausgewählten zweistündigen Zeitraum zu erhalten.

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

Dokumentenschlüssel-Scan

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 diesen Messwert standardmäßig 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üsselscan

Der Messwert Index Write Ops/s in einer bestimmten Zelle misst die durchschnittlichen Indexschreibvorgänge pro Sekunde innerhalb des entsprechenden 10-Sekunden-Intervalls und Schlüsselbereichs.

Nächste Schritte