Einstieg in Key Visualizer

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

Hinweise

Wenn Sie Key Visualizer für 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
  • Owner

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 bestimmten Minute innerhalb dieses Zeitraums 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 erforderliche Datenbank aus der Liste der Datenbanken aus.

  3. Klicken Sie im Navigationsmenü auf Key Visualizer.

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

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

      Scans sind verfügbar, wenn die Voraussetzungen für die Verwendung von Scans erfüllt sind. Sie können keine Zeiträume auswählen, die die Voraussetzungen für Scans nicht erfüllen oder noch verarbeitet werden. Die zwei letzten Scans des Tages werden einige Zeit in Anspruch nehmen, 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 zu analysierenden Messwert aus:

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

Sie können mehrere Key Visualizer-Messwerte zusammen anzeigen, um Messwerte zu vergleichen oder nach Datenkorrelationen zu suchen. Weitere Informationen finden Sie unter Verbindungen zwischen verschiedenen Messwerten finden.

Aktivitätsübersichten ansehen

Einen Überblick über die Aktivitäten während des ausgewählten zweistündigen Zeitraums 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

Scannen von Dokumentschlüsseln

Der Messwert Ops/s misst die Anzahl der Anfragen pro Sekunde für jeden Schlüsselbereich. Dieser Messwert ist die Summe von 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

Scan der Indexschlüssel

Der Messwert Index-Schreibvorgänge (Ops)/s für eine bestimmte Zelle misst die durchschnittlichen Indexschreibvorgänge pro Sekunde innerhalb des entsprechenden 10-Sekunden-Zeitintervalls und des Schlüsselbereichs.

Nächste Schritte