Einem benutzerdefinierten Dashboard temporäre Filter hinzufügen

In diesem Dokument wird beschrieben, wie Sie ändern können, welche Daten in einem benutzerdefinierten Dashboard angezeigt werden, ohne jedes Widget ändern zu müssen. Dazu fügen Sie temporäre Gruppierungen und temporäre Filter hinzu. Nachdem Sie eine Gruppierung oder einen Filter für das gesamte Dashboard hinzugefügt haben, wird in der Symbolleiste des Dashboards 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 von permanenten Filtern finden Sie unter Benutzerdefinierte Dashboards permanente Filter hinzufügen.

Funktionsweise von Dashboard-Filtern

Ein Dashboardfilter gibt ein Label und einen Wert an. Die im Dashboard angezeigten Zeitachsen bestimmen, welche Labels zum Filtern verfügbar sind. Wie ein Widget einen Filter für das gesamte Dashboard unterstützt, hängt vom Typ der im 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 Zeitachse das Label in einem Filter nicht unterstützt, ändert der Filter auf das gesamte Dashboard die angezeigten Daten nicht.
  
  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 im Widget ein Wert für ein Label angegeben ist, 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 ein Diagramm im Dashboard einen Filter basierend auf dem Label instance_id enthält, werden die angezeigten Daten durch den Filter auf das gesamte Dashboard nicht geändert.
- Andernfalls werden die angezeigten Daten im Diagramm nur nach den Zeitachsen gefiltert, die dem Filter für das gesamte Dashboard entsprechen.
Bei Widgets des Logbereichs wird die Abfrage durch Filter auf Dashboard-Ebene, die auf einem Ressourcenlabel basieren, aktualisiert. Wenn Sie beispielsweise den Filter cluster_name: mycluster für das gesamte Dashboard 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 durch ein logisches UND verknüpft.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring-Betrachter (roles/monitoring.viewer) für Ihr Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie benötigen, um temporäre Filter mithilfe der Google Cloud Console hinzuzufügen oder zu ändern. 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-Gruppierungen hinzufügen, zeigen die Widgets auf dem Dashboard eine Zeitachse für jeden Satz von Zeitachsen an, die dieselben Werte für die Gruppierungslabels haben. 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 mehr 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 Zone gruppieren und dann das CPU-Auslastungsdiagramm anzeigen.

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

Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und dann Dashboards aus:
Zu Dashboards
Maximieren Sie das Menü Gruppieren nach und wählen Sie dann die Labels für die Gruppierung aus.
Klicken Sie auf OK.

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

Temporären Filter erstellen

Bei der Untersuchung eines Vorfalls sollten Sie Daten auf eine bestimmte Weise betrachten. Sie können beispielsweise nur Zeitachsen für eine bestimmte virtuelle Maschine oder nur 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 entsprechend einen Filter auf der Grundlage des Labels zone.

So erstellen Sie einen temporären Filter:

Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und dann Dashboards aus:
Zu Dashboards
Klicken Sie in der -Filterleiste des Dashboards auf Filter hinzufügen und wählen Sie ein Label aus dem Menü aus.

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

Nachdem Sie ein Label ausgewählt haben, wird der Dashboard-Symbolleiste ein Filter hinzugefügt. Der Name des Filters hat denselben Namen wie Ihre Auswahl und der Wert wird auf * gesetzt, was allen Werten entspricht. Wenn Sie beispielsweise zone auswählen, wird in der Symbolleiste zone: * angezeigt.
Wenn Sie einen bestimmten Wert für die Übereinstimmung auswählen möchten, klicken Sie auf den Filter. 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 weitere Informationen zu einer bestimmten Zeitachse in einem Diagramm benötigen, können Sie die Legende des Diagramms verwenden, um temporäre Filter anzuwenden. Sie können Filter anwenden, die den spezifischen Labels der Zeitachse, der Ressource der Zeitachse oder nur den Labels des Messwerts entsprechen. In diesem Abschnitt werden diese Optionen beschrieben.

Beispiel-Dashboard

Betrachten Sie zur Beschreibung des Verhaltens der verschiedenen Optionen ein Dashboard, 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 die restriktivsten Labels anwenden möchten, filtern Sie nach allen Labels. Bei dieser Option geben die Labels eine eindeutige Ressource und einen eindeutigen Satz von Werten für die Labels des Messwerts an.

So wenden Sie temporäre Filter an, die eine bestimmte Zeitachse in einem Diagramm identifizieren:

Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und dann Dashboards aus:
Zu Dashboards
Identifizieren Sie das Diagramm und maximieren Sie die Legende, um weitere Details zu sehen. Klicken Sie dazu auf Legende maximieren.
Scrollen Sie durch die Legende, bis Sie die gewünschte Zeitachse finden, klicken Sie auf Aktionen für diese Zeitachse und wählen Sie dann Dashboard nach allen Labels filtern aus.

Wenn diese Schritte beispielsweise auf das Diagramm angewendet werden, das den Messwert CPU utilization für das Beispiel-Dashboard anzeigt, 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 CPU-Auslastung.

In der vorherigen Abbildung zeigt das Diagramm mit dem Messwert CPU utilization eine einzelne Zeitachse. Dieses Verhalten liegt daran, dass Sie Filter hinzugefügt haben, die mit den Zeitachsenlabels übereinstimmen. 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 Zeitachsen in diesem Diagramm auf dieselbe Instanz verweisen.

Zum Vergleich: Wenn die vorherigen Schritte auf das Diagramm angewendet werden, das den Messwert Disk read bytes für das Beispiel-Dashboard anzeigt, 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 für Lesebyte von Laufwerken.

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

Nach Ressourcenlabels einer Zeitachse filtern

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

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

Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und dann Dashboards aus:
Zu Dashboards
Identifizieren Sie das Diagramm und maximieren Sie die Legende, um weitere Details zu sehen. Klicken Sie dazu auf Legende maximieren.
Scrollen Sie durch die Legende, bis Sie die gewünschte Zeitachse finden, klicken Sie auf Aktionen für diese Zeitachse und wählen Sie dann Dashboard nach Ressourcenlabels filtern aus.

Wenn diese Schritte beispielsweise für das 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 Zeitachse zur CPU-Auslastung.

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

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

Nach Messwertlabels einer Zeitachse 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 sehen, die nur für ein bestimmtes Protokoll gelten.

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

Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und dann Dashboards aus:
Zu Dashboards
Identifizieren Sie das Diagramm und maximieren Sie die Legende, um weitere Details zu sehen. Klicken Sie dazu auf Legende maximieren.
Scrollen Sie durch die Legende, bis Sie die gewünschte Zeitachse finden, klicken Sie auf Aktionen für diese Zeitachse und wählen Sie dann Dashboard nach Messwertlabels filtern aus.

Wenn diese Schritte beispielsweise für das 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 Zeitachsen anzeigen, da der Wert des Labels instance_name konfigurierbar ist. Sie können also mehrere VMs mit demselben Wert für das Label instance_name haben.

Wenn zum Vergleich die vorherigen Schritte auf das Diagramm angewendet werden, das den Messwert Disk read bytes für das Beispiel-Dashboard anzeigt, 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, werden Zeitreihen für diesen Messwert angezeigt, unabhängig von der Ressource, für die die Zeitachse geschrieben wurde. Da Sie die Zeitachsen nicht auf eine bestimmte Ressource beschränken, werden möglicherweise mehrere Zeitreihen in einem Diagramm angezeigt. Im vorherigen Screenshot wird dieses Verhalten veranschaulicht, da beide Diagramme zwei Zeitreihen anzeigen.

Temporären Filter ändern oder löschen

Temporäre Filter werden automatisch gelöscht, wenn Sie das Dashboard verlassen. Wenn Sie einen temporären Filter manuell entfernen möchten, klicken Sie für diesen Filter auf Löschen.