Einem benutzerdefinierten Dashboard temporäre Filter hinzufügen

In diesem Dokument wird beschrieben, wie Sie durch temporäre Gruppierungen und temporäre Filter ändern können, welche Daten in einem benutzerdefinierten Dashboard angezeigt werden, ohne jedes Widget ändern zu müssen. Nachdem Sie eine Gruppierung oder einen Filter für das gesamte Dashboard hinzugefügt haben, wird in der Dashboard-Symbolleiste ein Menüelement für diese Gruppierung oder diesen Filter angezeigt.

Bei der Fehlerbehebung können Sie die in einem Dashboard angezeigten Daten ändern, indem Sie temporäre Gruppierungen oder Filter hinzufügen. Wenn Sie beispielsweise einen Vorfall untersuchen und im Dashboard nur Daten für eine bestimmte virtuelle Maschine (VM) anzeigen möchten, fügen Sie einen temporären Filter hinzu.

Temporäre Gruppierungen und Filter werden beim Aktualisieren der Seite automatisch gelöscht. Sie können sie jedoch auch manuell löschen.

Informationen zum Erstellen dauerhafter Filter finden Sie unter [Dauerhafte Filter zu benutzerdefinierten Dashboards hinzufügen][Permanentfilter].

Funktionsweise von Dashboard-Filtern

Ein Dashboard-Filter gibt ein Label und einen Wert an. Die im Dashboard angezeigten Zeitreihen bestimmen, welche Labels zum Filtern zur Verfügung stehen. Wie ein Widget einen Dashboard-Filter unterstützt, hängt vom Typ der vom Widget angezeigten Daten und der Konfiguration des Widgets ab:

  • Für Widgets, die Zeitreihendaten anzeigen, z. B. Liniendiagramme, gelten die folgenden Regeln:

    • Wenn die vom Widget angezeigte Zeitreihe das Label in einem Filter nicht unterstützt, werden die angezeigten Daten durch den Filter für das gesamte Dashboard nicht geändert.

      Wenn Sie beispielsweise einen Filter für das Label instance_id hinzufügen, aber in einem Diagramm im Dashboard keine Daten mit dem Label instance_id angezeigt werden, werden die angezeigten Daten durch den Filter nicht geändert.

    • Wenn das Widget einen Wert für ein Label angibt, ändert der Filter für das gesamte Dashboard die angezeigten Daten nicht.

      Wenn Sie beispielsweise einen Filter für das Label instance_id hinzufügen, aber ein Diagramm im Dashboard einen Filter enthält, der auf dem Label instance_id basiert, werden die angezeigten Daten durch den Filter für das gesamte Dashboard nicht geändert.

    • Andernfalls werden die angezeigten Daten im Diagramm so gefiltert, dass nur die Zeitachsen angezeigt werden, die dem Filter für das gesamte Dashboard entsprechen.

  • Bei Widgets für das Logfeld aktualisieren Dashboard-weite Filter, die auf einem Ressourcenlabel basieren, die Abfrage. Wenn Sie beispielsweise den Dashboard-weiten Filter cluster_name: mycluster hinzufügen, enthält die Abfrage resource.labels."cluster_name"="mycluster".

Sie können mehrere Filter für das gesamte Dashboard hinzufügen. Diese Filter werden mit einem logischen UND verknüpft.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Viewer (roles/monitoring.viewer) für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Hinzufügen oder Ändern temporärer Filter über die Google Cloud Console benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Weitere Informationen zu Rollen finden Sie unter Zugriff mit Identity and Access Management steuern.

Temporäre Gruppierungen erstellen oder ändern

Wenn Sie Dashboard-weite Gruppierungen hinzufügen, zeigen die Widgets auf dem Dashboard für jeden Satz von Zeitachsen, die dieselben Werte für die Gruppierungslabels haben, eine Zeitachse an. Standardmäßig wird der Durchschnitt jeder Gruppe angezeigt. Wenn das Widget jedoch eine Gruppierungsfunktion definiert, wird diese Funktion verwendet.

Angenommen, Ihr Dashboard enthält ein Diagramm, das die CPU-Auslastung Ihrer VM-Instanzen anzeigt. Um festzustellen, ob Sie weitere VMs in einer bestimmten Zone bereitstellen müssen, können Sie das Dashboard und dieses Diagramm bearbeiten, um die Gruppierungsoptionen zu ändern. Alternativ können Sie das Dashboard vorübergehend nach Zonen gruppieren und sich dann das CPU-Auslastungsdiagramm ansehen.

So erstellen oder ändern Sie die temporären Gruppierungen:

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

    Zu Dashboards

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Maximieren Sie das Menü Gruppieren nach und wählen Sie dann die Labels für die Gruppierung aus.
  3. Klicken Sie auf OK.

Wenn Sie das Dashboard verlassen, werden alle von Ihnen erstellten Gruppierungen verworfen.

Vorübergehenden Filter erstellen

Wenn Sie einen Vorfall untersuchen, möchten Sie die Daten möglicherweise auf bestimmte Weise betrachten. Sie können beispielsweise nur Zeitachsen für eine bestimmte virtuelle Maschine oder für Ressourcen in einer bestimmten Region anzeigen lassen. Wenn Sie einen temporären Filter erstellen, werden alle Dashboard-Widgets so geändert, dass Daten angezeigt werden, die diesem Filter entsprechen. Wenn Sie beispielsweise alle Diagramme so konfigurieren möchten, dass nur Zeitachsen für eine bestimmte VM-Instanz angezeigt werden, erstellen Sie einen Filter auf Basis des Labels instance_id. Wenn Sie das Dashboard so konfigurieren möchten, dass nur Zeitachsen für eine bestimmte Zone angezeigt werden, erstellen Sie einen Filter auf der Grundlage des Labels zone.

So erstellen Sie einen temporären Filter:

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

    Zu Dashboards

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Klicken Sie in der Filterleiste des Dashboards auf Filter hinzufügen und wählen Sie dann ein Label aus dem Menü aus.

    Im Menü werden die Labels für jede Zeitreihe aufgelistet, die im Dashboard angezeigt wird.

    Nachdem Sie ein Label ausgewählt haben, wird der Dashboard-Symbolleiste ein Filter hinzugefügt. Der Name des Filters hat den gleichen Namen wie Ihre Auswahl und sein Wert ist auf * festgelegt, d. h., er entspricht allen Werten. Wenn Sie beispielsweise zone auswählen, wird in der Symbolleiste zone: * angezeigt.

  3. Klicken Sie auf den Filter, um einen bestimmten Wert für die Übereinstimmung auszuwählen. Klicken Sie beispielsweise auf zone: * und wählen Sie dann einen Wert aus dem Menü aus. Wenn Sie die Anzahl der Menüoptionen reduzieren möchten, geben Sie einen Teil des Werts in den Bereich Filter ein.

Wenn Sie das Dashboard verlassen, werden alle erstellten Filter verworfen.

Temporäre Filter hinzufügen, die einer Zeitreihe entsprechen

Wenn Sie mehr Informationen zu einer bestimmten Zeitachse in einem Diagramm benötigen, können Sie über die Legende des Diagramms temporäre Filter anwenden. Sie können Filter anwenden, die mit den bestimmten Labels der Zeitreihe, der Ressource der Zeitreihe oder nur mit den Labels des Messwerts übereinstimmen. In diesem Abschnitt werden diese Optionen beschrieben.

Beispiel-Dashboard

Zur Beschreibung des Verhaltens der verschiedenen Optionen können Sie ein Dashboard verwenden, in dem die Messwerte CPU utilization und Disk read bytes für Compute Engine-VM-Instanzen angezeigt werden. Der folgende Screenshot zeigt dieses Dashboard für ein System:

Anzeige des Beispiel-Dashboards.

Nach allen Labels einer Zeitreihe filtern

Wenn Sie den restriktivsten Labelsatz anwenden möchten, filtern Sie nach allen Labels. Bei dieser Option geben die Labels eine eindeutige Ressource und eine eindeutige Gruppe von Werten für die Labels des Messwerts an.

So wenden Sie temporäre Filter an, mit denen eine bestimmte Zeitachse in einem Diagramm identifiziert wird:

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

    Zu Dashboards

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Suchen Sie das Diagramm und maximieren Sie die Legende, um weitere Details zu sehen. Klicken Sie dazu auf  Legende maximieren.
  3. Scrollen Sie durch die Legende, bis Sie die gewünschte Zeitachse finden, klicken Sie auf Aktionen für diese Zeitreihe und wählen Sie dann Dashboard nach allen Labels filtern aus.

Wenn diese Schritte beispielsweise auf das Diagramm angewendet werden, in dem der Messwert CPU utilization für das Beispiel-Dashboard angezeigt wird, werden die folgenden Filter hinzugefügt:

  • Messwertlabel: instance_name.

  • Ressourcenlabels für Compute Engine-VM-Instanzen:

    • project_id
    • instance_id
    • zone

Der folgende Screenshot veranschaulicht das Ergebnis:

Anzeige des Beispiel-Dashboards mit Filtern für alle Labels einer Zeitreihe für die CPU-Auslastung.

In der vorherigen Abbildung zeigt das Diagramm mit dem Messwert CPU utilization eine einzelne Zeitachse. Dies liegt daran, dass Sie Filter hinzugefügt haben, die den Zeitachsenlabels entsprechen. Im Diagramm mit dem Messwert Disk read bytes werden jedoch mehrere Zeitreihen angezeigt. Der Messwert Disk read bytes enthält zusätzlich zum Label instance_name drei Labels. Daher können mehrere Zeitreihen in diesem Diagramm auf dieselbe Instanz verweisen.

Wenn Sie die vorherigen Schritte zum Vergleich auf das Diagramm anwenden, in dem der Messwert Disk read bytes für das Beispiel-Dashboard angezeigt wird, werden die folgenden Filter hinzugefügt:

  • Messwertlabels:

    • instance_name
    • device_name
    • storage_type
    • device_type

  • Ressourcenlabels für Compute Engine-VM-Instanzen:

    • project_id
    • instance_id
    • zone

Anzeige des Beispiel-Dashboards mit Filtern für alle Labels einer Zeitachse der Lesebyte eines Laufwerks.

Wie im vorherigen Screenshot gezeigt, zeigen beide Diagramme jetzt eine einzelne Zeitachse an.

Nach Ressourcenlabels einer Zeitreihe filtern

Wenn Sie nach allen Ressourcenlabels filtern, beschränken Sie das Dashboard auf Zeitachsen für eine bestimmte Ressource. Sie können jetzt nur die Messwerte für diese Ressource ansehen und die Zeitachsen, die nicht von Interesse sind, vorübergehend aus der Anzeige entfernen.

So wenden Sie temporäre Filter an, mit denen die Ressource für eine bestimmte Zeitachse identifiziert wird, die in einem Diagramm angezeigt wird:

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

    Zu Dashboards

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Suchen Sie das Diagramm und maximieren Sie die Legende, um weitere Details zu sehen. Klicken Sie dazu auf  Legende maximieren.
  3. Scrollen Sie durch die Legende, bis Sie die gewünschte Zeitachse finden, klicken Sie auf Aktionen für diese Zeitreihe und wählen Sie dann Dashboard nach Ressourcenlabels filtern aus.

Wenn diese Schritte beispielsweise im Diagramm ausgeführt werden, in dem der Messwert CPU utilization für das Beispiel-Dashboard angezeigt wird, werden drei Filter hinzugefügt. Diese Filter entsprechen den Labels für die Ressource, eine VM-Instanz:

Anzeige des Beispiel-Dashboards mit Filtern für die Ressourcenlabels einer Zeitreihe für die CPU-Auslastung.

Wie im vorherigen Screenshot dargestellt, können in einem Diagramm mehrere Zeitreihen angezeigt werden, wenn Sie nach Ressource filtern.

Da mit der Option Dashboard nach Ressourcenlabels filtern nur Ressourcenlabels auf die temporäre Filterleiste angewendet werden, ist das Ergebnis das gleiche, wenn Sie diese Option in einem der beiden Diagramme auswählen.

Nach Messwertlabels einer Zeitreihe filtern

Mit dieser Option können Sie Filter anwenden, die den Werten für die Labels eines Messwerts entsprechen. Wenn Sie sich beispielsweise Load-Balancing-Messwerte ansehen, möchten Sie möglicherweise Zeitachsen anzeigen, die nur für ein bestimmtes Protokoll gelten.

So wenden Sie temporäre Filter an, die den Messwert für eine bestimmte in einem Diagramm angezeigte Zeitachse identifizieren:

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

    Zu Dashboards

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Suchen Sie das Diagramm und maximieren Sie die Legende, um weitere Details zu sehen. Klicken Sie dazu auf  Legende maximieren.
  3. Scrollen Sie durch die Legende, bis Sie die gewünschte Zeitachse finden, klicken Sie auf Aktionen für diese Zeitreihe und wählen Sie dann Dashboard nach Messwertlabels filtern aus.

Wenn diese Schritte beispielsweise im Diagramm ausgeführt werden, in dem der Messwert CPU utilization für das Beispiel-Dashboard angezeigt wird, wird ein Filter hinzugefügt, der auf dem Label instance_name basiert. In diesem Fall ist es möglich, dass beide Diagramme mehrere Zeitreihen anzeigen, da der Wert des Labels instance_name konfigurierbar ist. Das heißt, Sie können mehrere VMs mit demselben Wert für das Label instance_name haben.

Zum Vergleich: Wenn die vorherigen Schritte auf das Diagramm angewendet werden, in dem der Messwert Disk read bytes für das Beispiel-Dashboard angezeigt wird, werden vier Filter hinzugefügt. Diese Filter entsprechen den Labels für den Messwert Disk read bytes.

Wenn Ihre temporären Filter nur Messwertfilter enthalten, sehen Sie Zeitachsen für diesen Messwert, unabhängig von der Ressource, für die die Zeitachse geschrieben wurde. Da Sie die Zeitreihe nicht auf eine bestimmte Ressource beschränken, werden in einem Diagramm möglicherweise mehrere Zeitreihen angezeigt. Der vorherige Screenshot veranschaulicht dieses Verhalten, da beide Diagramme zwei Zeitreihen anzeigen.

Vorübergehenden Filter ändern oder löschen

Temporäre Filter werden automatisch gelöscht, wenn Sie das Dashboard verlassen. Klicken Sie auf Löschen, um einen temporären Filter manuell zu entfernen.

Nächste Schritte