Diagramme und Tabellen zu einem benutzerdefinierten Dashboard hinzufügen

In diesem Dokument wird beschrieben, wie Sie einem benutzerdefinierten Dashboard mithilfe der Google Cloud Console Diagramme, Tabellen, Messinstrumente und Kurzübersichten hinzufügen. Sie können Messwertdaten über ein Zeitintervall anzeigen lassen, indem Sie ein Liniendiagramm, ein gestapeltes Flächendiagramm, ein Balkendiagramm oder eine Heatmap hinzufügen. Wenn Sie sich nur für die neuesten Messungen interessieren, fügen Sie eine Tabelle, ein Kreisdiagramm, eine Anzeige oder eine Kurzübersicht hinzu. Die Farbe von Messwerten und Kurzübersichten ändert sich je nachdem, wie sich der aktuelle Wert im Vergleich zu den Warn- und Gefahrenschwellen darstellt.

Die Visualisierungen, die Sie Dashboards hinzufügen können, werden als Widgets bezeichnet. Allgemeine Informationen zu den verschiedenen Widgettypen finden Sie unter Dashboards – Übersicht.

In Diagrammen, Tabellen, Messinstrumenten und Kurzübersichten in benutzerdefinierten Dashboards können alle Messwerttypen mit einem numerischen Wert oder einem Verteilungswert angezeigt werden, einschließlich benutzerdefinierter Messwerte und logbasierter Messwerte. Diagramme können keine Daten des Stringtyps darstellen.

In diesem Dokument wird beschrieben, wie Sie einem benutzerdefinierten Dashboard Diagramme, Tabellen, Messwerte und Kurzübersichten hinzufügen, in denen Zeitreihendaten angezeigt werden. Informationen zum Hinzufügen anderer Widget-Typen zu Ihren Dashboards finden Sie in den folgenden Dokumenten:

• Benachrichtigungsrichtlinien und Vorfälle
• Protokolle und Fehler
• Beschreibender Text
• Service Level Objectives (SLOs) für eine Reihe von Diensten
• Diagramme mit den Ergebnissen einer Log Analytics-Abfrage

Informationen zur Cloud Monitoring API finden Sie unter Dashboards nach API verwalten.

Hinweise

• Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.editor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Ändern benutzerdefinierter Dashboards in der Google Cloud Console benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

  Sie können 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.

• Ein Dashboard kann maximal 40 Widgets enthalten.

• Wenn Sie einem Dashboard ein Widget hinzufügen möchten, können Sie entweder die Visualisierung auswählen und dann das Widget konfigurieren oder zuerst den Datentyp auswählen und dann die Visualisierung konfigurieren.

  Wenn Sie beispielsweise einem Dashboard eine Tabelle mit der CPU-Auslastung Ihrer VM-Instanzen hinzufügen möchten, haben Sie folgende Möglichkeiten:

  • Wählen Sie das Widget Tabelle aus und konfigurieren Sie es so, dass die CPU-Auslastung Ihrer VM-Instanzen angezeigt wird.
  • Wählen Sie den Datentyp Messwert aus, konfigurieren Sie das Widget so, dass die CPU-Auslastung Ihrer VM-Instanzen angezeigt wird, und ändern Sie dann den Widget-Typ in Tabelle.

  In der Anleitung auf dieser Seite wird davon ausgegangen, dass Sie zuerst den Datentyp auswählen und dann konfigurieren, wie diese Daten angezeigt werden.

Dashboards Diagramme und Tabellen hinzufügen

In diesem Abschnitt wird beschrieben, wie Sie Diagramme und Tabellen mit der Google Cloud Console konfigurieren:

• Diagramme zeigen Daten im Zeitverlauf. Es sind vier Stile verfügbar: Liniendiagramm, Gestapeltes Flächendiagramm, Gestapeltes Balkendiagramm und Heatmap. In einem einzelnen Diagramm können mehrere Messwerttypen dargestellt werden. Sie können beispielsweise ein Diagramm so konfigurieren, dass die von Ihren Instanzen gelesenen und auf Ihre Instanzen geschriebenen Laufwerk-Byte angezeigt werden.

  Nachdem ein Diagramm konfiguriert wurde, können Sie den Widget-Typ ändern. Informationen dazu, warum Sie einen bestimmten Stil auswählen sollten, finden Sie unter Diagramme, die Daten im Zeitverlauf darstellen.

  Informationen zum Konfigurieren eines Diagramms mit der Cloud Monitoring API finden Sie unter Dashboard mit einem XyChart-Widget.

• Tabellen enthalten eine Zeile für jede Kombination von Labelwerten. Wenn in Tabellen Daten aus mehreren Messwerttypen angezeigt werden, enthält jede Zeile ein Ergebnis aus allen Abfragen, sofern eine solche Zusammenführung möglich ist.

  Es gibt zwei Arten von Tabellen. Im Tabellen-Widget wird ein numerischer Wert wie „25 %“ angezeigt. Im Widget Top-Liste werden sowohl der Wert als auch ein visueller Indikator für den Wert im Vergleich zum Bereich der möglichen Werte angezeigt.

  Sie können den Stil zwischen Tabellen und Diagrammen ändern, Tabellenspaltennamen konfigurieren und Grenzwerte hinzufügen, die die Farbe der Tabellenzellen ändern. Weitere Informationen und ein Beispiel finden Sie unter Daten in tabellarischer Form in einem Dashboard anzeigen.

  Informationen zum Konfigurieren einer Tabelle mit der Cloud Monitoring API finden Sie unter Dashboard mit einem TimeSeriesTable-Widget.

So fügen Sie einem Dashboard ein Diagramm oder eine Tabelle hinzu:

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

   Dashboards aufrufen

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

2. Führen Sie einen der folgenden Schritte aus:

   • Zum Erstellen eines neuen Dashboards wählen Sie Dashboard erstellen aus.
   • Wenn Sie ein vorhandenes Dashboard aktualisieren möchten, suchen Sie in der Liste mit allen Dashboards nach dem gewünschten Dashboard und wählen Sie es aus.

3. Klicken Sie in der Symbolleiste auf  Widget hinzufügen.

4. Wählen Sie im Dialogfeld Widget hinzufügen die Option  Messwert aus.

5. Geben Sie die Daten an, die im Diagramm angezeigt werden sollen. Sie können die menügesteuerte Benutzeroberfläche, die Monitoring Query Language (MQL), PromQL oder einen Monitoring-Filter verwenden:

   Menügesteuerte Benutzeroberfläche

   1. Wählen Sie die Zeitachsendaten aus, die Sie ansehen möchten:

      1. Maximieren Sie im Element Messwert das Menü Messwert auswählen.

         Das Menü Messwert auswählen enthält Funktionen, mit denen Sie die verfügbaren Messwerttypen finden können:

         • Verwenden Sie die Filterleiste, um einen bestimmten Messwerttyp zu finden. Wenn Sie beispielsweise util eingeben, werden im Menü nur Einträge angezeigt, die util enthalten. Einträge werden angezeigt, wenn sie einen Groß-/Kleinschreibungs-insensitiven „contains“-Test bestehen.

         • Wenn Sie alle Messwerttypen sehen möchten, auch die ohne Daten, klicken Sie auf  Aktiv. Standardmäßig werden in den Menüs nur Messwerttypen mit Daten angezeigt.

         Sie können beispielsweise die folgenden Optionen auswählen:

         1. Wählen Sie im Menü Aktive Ressourcen die Option VM-Instanz aus.
         2. Wählen Sie im Menü Aktive Messwertkategorien die Option uptime_check aus.
         3. Wählen Sie im Menü Aktive Messwerte die Option Anfragelatenz aus.
         4. Klicken Sie auf Anwenden.

      2. Optional: Wenn nur eine Teilmenge der Daten angezeigt werden soll, wählen Sie im Element Filter die Option Filter hinzufügen aus und nehmen Sie die erforderlichen Einstellungen vor. Sie können beispielsweise Daten für eine Zone aufrufen. Wenden Sie dazu einen Filter an. Sie können mehrere Filter hinzufügen. Weitere Informationen finden Sie unter Diagrammdaten filtern.

      Weitere Informationen finden Sie unter Daten für das Diagramm auswählen.

   2. So kombinieren und richten Sie Zeitreihen aus:

      • Wenn Sie alle Zeitreihen anzeigen möchten, legen Sie im Element Aggregation im ersten Menü die Option Nicht aggregiert und im zweiten Menü die Option Keine fest.

      • So kombinieren Sie Zeitreihen:

        1. Maximieren Sie das erste Menü und wählen Sie eine Funktion aus.

           Das Diagramm wird aktualisiert und zeigt eine einzelne Zeitreihe an. Wenn Sie beispielsweise Mittelwert auswählen, ist die angezeigte Zeitreihe der Durchschnitt aller Zeitreihen.

        2. Wenn Sie Zeitreihen mit denselben Labelwerten kombinieren möchten, maximieren Sie das zweite Menü und wählen Sie dann ein oder mehrere Labels aus.

           Das Diagramm wird aktualisiert und zeigt eine Zeitachse für jede eindeutige Kombination von Labelwerten an. Wenn Sie beispielsweise Zeitreihen nach Zone anzeigen möchten, legen Sie das zweite Menü auf Zone fest.

           Wenn das zweite Menü auf Keine gesetzt ist, wird im Diagramm eine Zeitreihe angezeigt.

      • Optional: Wenn Sie den Abstand zwischen den Datenpunkten konfigurieren möchten, klicken Sie auf Abfrageelement hinzufügen, wählen Sie Min Interval (Minimales Intervall) aus und geben Sie einen Wert ein.

      Weitere Informationen zur Gruppierung und Ausrichtung finden Sie unter Festlegen, wie Diagrammdaten angezeigt werden sollen.

   3. Optional: Wenn Sie nur die Zeitreihen mit den höchsten oder niedrigsten Werten anzeigen möchten, verwenden Sie das Element Sortieren und Limits.

   MQL

   1. Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche  MQL oder  PromQL.
   2. Prüfen Sie, ob MQL im Schalter Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

   3. Geben Sie eine Abfrage in den Abfrageeditor ein. Wenn Sie beispielsweise die CPU-Auslastung der VM-Instanzen in Ihrem Google Cloud-Projekt in einem Diagramm darstellen möchten, verwenden Sie die folgende Abfrage:

      fetch gce_instance
      | metric 'compute.googleapis.com/instance/cpu/utilization'
      | group_by 1m, [value_utilization_mean: mean(value.utilization)]
      | every 1m
      

      Weitere Informationen zu MQL finden Sie in den folgenden Dokumenten:

      • Einführung in MQL
      • Code-Editor für MQL verwenden

   PromQL

   1. Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche  MQL oder  PromQL.
   2. Prüfen Sie, ob PromQL in der Ein-/Aus-Schaltfläche PromQL ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

   3. Geben Sie eine Abfrage in den Abfrageeditor ein. Wenn Sie beispielsweise die durchschnittliche CPU-Auslastung der VM-Instanzen in Ihrem Google Cloud-Projekt in einem Diagramm darstellen möchten, verwenden Sie die folgende Abfrage:

      avg(compute_googleapis_com:instance_cpu_utilization)
      

      Weitere Informationen zur Verwendung von PromQL finden Sie unter PromQL in Cloud Monitoring.

   Monitoring-Filter

   1. Klicken Sie im Element Messwert auf  Hilfe und wählen Sie dann Direkter Filtermodus aus.

      Die Elemente Messwert und Filter werden gelöscht und ein Element Filter erstellt, in das Sie Text eingeben können.

      Wenn Sie einen Ressourcentyp, einen Messwert oder Filter ausgewählt haben, bevor Sie zum Direktfiltermodus gewechselt sind, werden diese Einstellungen im Feld des Elements Filter angezeigt.

   2. Geben Sie einen Monitoring-Filter in das Feld des Elements Filter ein.

   3. So kombinieren und richten Sie Zeitreihen aus:

      • Wenn Sie alle Zeitreihen anzeigen möchten, legen Sie im Element Aggregation im ersten Menü die Option Nicht aggregiert und im zweiten Menü die Option Keine fest.

      • So kombinieren Sie Zeitreihen:

        1. Maximieren Sie das erste Menü und wählen Sie eine Funktion aus.

           Das Diagramm wird aktualisiert und zeigt eine einzelne Zeitreihe an. Wenn Sie beispielsweise Mittelwert auswählen, ist die angezeigte Zeitreihe der Durchschnitt aller Zeitreihen.

        2. Wenn Sie Zeitreihen mit denselben Labelwerten kombinieren möchten, maximieren Sie das zweite Menü und wählen Sie dann ein oder mehrere Labels aus.

           Das Diagramm wird aktualisiert und zeigt eine Zeitachse für jede eindeutige Kombination von Labelwerten an. Wenn Sie beispielsweise Zeitreihen nach Zone anzeigen möchten, legen Sie das zweite Menü auf Zone fest.

           Wenn das zweite Menü auf Keine gesetzt ist, wird im Diagramm eine Zeitreihe angezeigt.

      • Optional: Wenn Sie den Abstand zwischen den Datenpunkten konfigurieren möchten, klicken Sie auf Abfrageelement hinzufügen, wählen Sie Min Interval (Minimales Intervall) aus und geben Sie einen Wert ein.

      Weitere Informationen zur Gruppierung und Ausrichtung finden Sie unter Festlegen, wie Diagrammdaten angezeigt werden sollen.

6. Optional: Konfigurieren Sie das Diagramm oder die Tabelle so, dass mehrere Messwerttypen angezeigt werden.

   Hinweis :Wenn Sie mehrere Messwerttypen hinzufügen und ein Tabellen-Widget auswählen, werden in der Google Cloud Console nach Möglichkeit die Werte für beide Messwerttypen in derselben Zeile angezeigt. Weitere Informationen finden Sie unter Daten aus mehreren Messwerttypen in Tabellen zusammenführen.

   Menügesteuerte Benutzeroberfläche

   1. Wählen Sie Abfrage hinzufügen aus. Eine neue Abfrage wird hinzugefügt. Beispielsweise könnte eine Abfrage mit dem Label B hinzugefügt werden.

   2. Wählen Sie für die neue Abfrage im Element Messwert einen Ressourcentyp und einen Messwerttyp aus. Außerdem können Sie Filter hinzufügen, Zeitreihen kombinieren und die Anzahl der angezeigten Zeitreihen sortieren und begrenzen.

   Der folgende Screenshot zeigt die Darstellung im Metrics Explorer, wenn zwei Messwerttypen dargestellt werden:

   

   MQL

   Nicht unterstützt.

   PromQL

   Nicht unterstützt.

   Monitoring-Filter

   Nicht unterstützt.

7. Optional: Konfigurieren Sie das Diagramm so, dass ein Verhältnis der Messwerttypen angezeigt wird.

   Menügesteuerte Benutzeroberfläche

   1. Konfigurieren Sie das Diagramm so, dass zwei Messwerttypen mit derselben Messwertart angezeigt werden. Beide sind beispielsweise GAUGE-Messwerte.
   2. Der Wert für das Feld Min. Intervall muss für beide Messwerttypen identisch sein. Klicken Sie auf Abfrageelement hinzufügen und wählen Sie Min. Intervall aus, um auf dieses Feld zuzugreifen.

   3. Aktualisieren Sie die Aggregationsfelder.

      Wir empfehlen, dass die Labels für den Nennermesswerttyp mit den Werten übereinstimmen, die für den Nennermesswerttyp festgelegt wurden. Sie können beispielsweise das Label zone für den Nenner und den Zähler auswählen.

      Sie müssen nicht für beide Messwerttypen dieselben Labels verwenden. Sie können jedoch nur Labels auswählen, die für beide Messwerttypen gemeinsam sind.

   4. Wählen Sie in der Symbolleiste des Abfragebereichs Verhältnis erstellen aus und schließen Sie das Dialogfeld ab.

      Nachdem Sie das Verhältnis erstellt haben, werden drei Abfragen angezeigt:

      • A/B-Verhältnis gibt die Verhältnisabfrage an.
      • A gibt die Abfrage für den Nenner an.
      • B gibt die Abfrage für den Nenner an.

      Das folgende Beispiel veranschaulicht ein Verhältnis, bei dem die Summe der pro Zone auf das Laufwerk geschriebenen Byte mit der Gesamtzahl der auf das Laufwerk geschriebenen Byte verglichen wird:

      

   5. Optional: Wenn Sie den Nenner und den Zähler tauschen möchten, maximieren Sie das Menü im Element Verhältnis und treffen Sie eine Auswahl.

   MQL

   1. Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche  MQL oder  PromQL.
   2. Prüfen Sie, ob MQL im Schalter Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

   3. Geben Sie eine Abfrage in den Abfrageeditor ein. Mit MQL können Sie ein Verhältnis aus zwei verschiedenen Messwerten berechnen. Außerdem können Sie einen einzelnen Messwert nach einem Label filtern und dann das Verhältnis berechnen. Mit der folgenden Abfrage wird das Verhältnis der Antworten mit dem Wert 500 zur Gesamtzahl der Antworten berechnet:

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
      | {
          filter response_code_class = 500
        ;
          ident
        }
      | group_by [matched_url_path_rule]
      | outer_join 0
      | div
      

      Weitere Informationen zu MQL finden Sie in den folgenden Dokumenten:

      • Einführung in MQL
      • Codeeditor verwenden
      • Computing-Verhältnisse

   PromQL

   1. Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche  MQL oder  PromQL.
   2. Prüfen Sie, ob PromQL in der Ein-/Aus-Schaltfläche PromQL ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

   3. Geben Sie eine Abfrage in den Abfrageeditor ein. Wenn Sie beispielsweise das Verhältnis der durchschnittlichen Latenz Ihres my_summary_latency_seconds-Messwerts in einem Diagramm darstellen möchten, verwenden Sie die folgende Abfrage:

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
      sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
      

      Weitere Informationen zur Verwendung von PromQL finden Sie unter PromQL in Cloud Monitoring.

   Monitoring-Filter

   Nicht unterstützt.

8. Optional: Wenn Sie die Visualisierung ändern möchten, klicken Sie im Bereich Darstellung auf  Widgettyp und treffen Sie eine Auswahl.

   Im Menü Widget-Typ sind alle Widget-Typen aufgeführt, die denselben Datentyp anzeigen können. Einige Widgets sind jedoch möglicherweise nicht aktiviert. Angenommen, ein Diagramm in einem Dashboard ist so konfiguriert, dass ein Messwerttyp angezeigt wird. Das Liniendiagramm enthält mehrere Zeitreihen und jeder Messwert ist ein Doppelwert:

   • Die Widgets Tabelle, Kreisdiagramm, Liniendiagramm, Übereinander angeordnetes Balkendiagramm und Übereinander angeordnetes Flächendiagramm sind als Kompatibel aufgeführt. Sie können einen beliebigen dieser Typen auswählen.

     Hinweis :Wenn Sie die Daten in Tabellenform anzeigen möchten, legen Sie den Widget-Typ auf Tabelle fest. Wenn Sie auf der Ein/Aus-Schaltfläche Diagramm Tabelle Beides die Option Tabelle auswählen, wird die Anzeige geändert, die Einstellung wird jedoch nicht gespeichert.

   • Kurzübersichten und Tachometerdiagramme sind als Mit Anpassungen kompatibel aufgeführt, da in diesen Widgets nur eine einzelne Zeitreihe angezeigt werden kann. Wenn Sie diese Widget-Typen aktivieren möchten, ändern Sie die Gruppierungskonfiguration.

   • Das Widget Heatmap ist deaktiviert, da in diesen Widgets nur Daten mit Verteilungswerten angezeigt werden können.

   • Der Bereich „Protokolle“ ist nicht aufgeführt, da dort keine Zeitreihendaten angezeigt werden können.

9. Optional: Wenn Sie ändern möchten, wie die ausgewählten Daten in einem Diagramm oder einer Tabelle dargestellt werden, verwenden Sie die Optionen im Bereich Darstellung:

   • Diagrammoptionen:

     • Menü Analysemodus: Sie können zwischen Liniendiagrammen, Röntgendiagrammen und Statistiken wählen.
     • Menü Mit früheren Daten vergleichen: Hier können Sie aktuelle Daten mit früheren Daten vergleichen.
     • Menü Schwellenlinie: Sie können einen Referenzgrenzwert hinzufügen.
     • Menü Legend Alias (Legendenalias): Hier können Sie den Namen einer Legendenspalte konfigurieren.
     • Die Menüs Zuweisung der Y-Achse, Labels der Y-Achse und Skala der Y-Achse: Mit diesen Menüs können Sie die Zuweisung, die Labels oder die Skala der Y-Achse konfigurieren.

   • Tabellenoptionen:

     • Menü Wertoption: Sie können zwischen dem aktuellen Wert und einem aggregierten Wert wählen.
     • Menü Sichtbare Spalten: Hier können Sie auswählen, welche Spalten angezeigt werden.
     • Menü Spaltenformatierung: Hier können Sie Spaltennamen, die Ausrichtung von Daten in einer Spalte, Einheiten und die Farbcodierung von Zellen konfigurieren.
     • Menü Messwertansicht: Sie können auswählen, ob der Wert einzeln oder relativ zu einem Wertebereich angezeigt werden soll.
     • Menü Legend Alias (Legendenalias): Hier können Sie den Namen einer Legendenspalte konfigurieren.

10. Klicken Sie in der Symbolleiste auf Übernehmen, um die Änderungen auf das Dashboard anzuwenden. Wenn Sie die Änderungen verwerfen möchten, klicken Sie auf Abbrechen.

11. Klicken Sie in der Symbolleiste auf Speichern, um das geänderte Dashboard zu speichern.

Nur die neuesten Daten anzeigen

Im Monitoring haben Sie mehrere Möglichkeiten, nur die letzten Messungen statt des Messverlaufs zu visualisieren:

• Wenn Sie den jeweils aktuellen Wert jeder Zeitreihe grafisch darstellen möchten, wobei jeder Wert als Bruchteil der Summe aller Werte angezeigt wird, fügen Sie ein Kreisdiagramm hinzu. Sie können diese Diagramme so konfigurieren, dass der Gesamtwert angezeigt wird.

• Wenn Sie den jeweils aktuellen Wert jeder Zeitreihe in tabellarischer Form anzeigen möchten, fügen Sie eine Tabelle hinzu. Sie können die Anzahl der Zeilen in einer Tabelle begrenzen und die Zeilen einer Tabelle so konfigurieren, dass ein Wert im Vergleich zu einem Wertebereich angezeigt wird.

• Wenn Sie eine grüne, gelbe oder rote Kennzeichnung des aktuellen Werts im Vergleich zu einer Reihe von Grenzwerten erhalten möchten, fügen Sie dem Dashboard eine Anzeige oder eine Kurzübersicht hinzu.

Aktuelle Daten in einem Kreisdiagramm darstellen

Wenn Sie die neuesten Daten als Anteil am Gesamtwert sehen möchten, fügen Sie ein Kreisdiagramm hinzu. Wie Tabellen können auch Kreisdiagramme jeden Messwerttyp anzeigen, der einen numerischen Wert hat. Außerdem können sie Perzentile für Verteilungsmesswerte anzeigen. Jede Zeitachse trägt einen Tortenabschnitt bei.

Der folgende Screenshot zeigt ein Dashboard, in dem die CPU-Auslastung von VM-Instanzen mit zwei verschiedenen Konfigurationen eines Kreisdiagramms dargestellt wird:

Informationen zum Hinzufügen von Kreisdiagrammen zu einem Dashboard finden Sie in den folgenden Dokumenten:

• Google Cloud Console: Weitere Informationen finden Sie in diesem Dokument im Abschnitt Diagramme und Tabellen hinzufügen.

  • Nachdem Sie die Daten für das Diagramm ausgewählt haben, legen Sie im Bereich Anzeige im Feld Widgettyp die Option Kreisdiagramm fest.
  • Wenn Sie den Gesamtwert sehen möchten, legen Sie im Feld Diagrammtyp die Option Apfelkuchen fest.

• Cloud Monitoring API: Weitere Informationen finden Sie unter Dashboard mit einem PieChart-Widget.

Aktuelle Daten in Tabellenform anzeigen

Wenn Sie die neuesten Daten in Tabellenform aufrufen möchten, fügen Sie eine Tabelle hinzu. In Tabellen können numerische Daten angezeigt werden. Sie können beispielsweise einen oder mehrere Messwerttypen oder Perzentile für Verteilungsmesswerte anzeigen.

Wenn in einer Tabelle ein Messwerttyp angezeigt wird, entspricht jede Zeile der Tabelle einer Zeitachse. Eine Tabellenspalte mit einem numerischen Wert, der entweder der aktuelle Wert oder ein Gesamtwert ist. In den anderen Spalten sind die Labels in der Zeitreihe zu sehen. Wenn in einer Tabelle mehrere Messwerttypen angezeigt werden, werden die Daten für beide Messwerttypen nach Möglichkeit in derselben Zeile angezeigt. Weitere Informationen finden Sie unter Mehrere Messwerttypen in Tabellen zusammenführen.

Es gibt zwei Widgets, die Daten in Tabellenform anzeigen: das Widget Top-Liste und das Widget Tabelle. Der Hauptunterschied zwischen diesen beiden Widgets besteht darin, dass das Widget Top-Liste die Reihenfolge der Zeilen sortiert und den Wert zusammen mit einer visuellen Darstellung des Werts im Vergleich zum Bereich der möglichen Werte anzeigt. Da das Widget Top-Liste eine visuelle Darstellung des Werts bietet, können Sie die Zelle nicht farblich codieren, je nachdem, wie der Wert im Vergleich zu einem Schwellenwert abschneidet.

Informationen zum Konfigurieren von Tabellen finden Sie in den folgenden Abschnitten:

• Allgemeine Informationen zum Auswählen von Messwerten und Festlegen von Aggregationsoptionen finden Sie in diesem Dokument im Abschnitt Diagramme und Tabellen hinzufügen.

  Nachdem Sie die Daten für das Diagramm ausgewählt haben, legen Sie im Bereich Anzeige im Feld Widget-Typ die Option Tabelle oder Top-Liste fest.

• Informationen zu den Konfigurationsoptionen finden Sie in den folgenden Abschnitten dieses Dokuments:

  • Letzten Wert oder aggregierten Wert anzeigen
  • Wählen Sie die Spalten aus, die angezeigt werden sollen.
  • Spalten konfigurieren
  • Referenzwert anzeigen

• Informationen zum Sortieren und Filtern von Tabellen finden Sie im Abschnitt Tabellen sortieren und filtern dieses Dokuments.

• Informationen zum Konfigurieren einer Tabelle mit der API finden Sie unter Dashboard mit einem TimeSeriesTable-Widget.

Der folgende Screenshot zeigt zwei Tabellen. In der ersten Tabelle sind zwei Messwerttypen zu sehen: die Anzahl der Byte, die aus Instanzen gelesen wurden, und die Anzahl der Byte, die in Instanzen geschrieben wurden. Ein aggregierter Wert wird zusammen mit einem Referenzbalken angezeigt. In der zweiten Tabelle ist der aktuelle Wert eines Messwerttyps zu sehen. Die Wertspalte ist so konfiguriert, dass die Zelle je nach Vergleich des Werts mit einem Schwellenwert eine bestimmte Farbe hat:

Letzten Wert oder aggregierten Wert anzeigen

In Tabellen wird standardmäßig der jeweils aktuelle Wert angezeigt. In einer Tabelle kann jedoch ein Wert angezeigt werden, der für den für Ihr Dashboard ausgewählten Zeitraum berechnet wird.

Im Feld Wertoption können Sie zwischen dem aktuellen Wert und dem aggregierten Wert wählen.

Wenn Sie den aggregierten Wert anzeigen, werden für jede Zeitreihe die Daten im vom Dashboard ausgewählten Zeitraum mithilfe der Ausrichtungsfunktion kombiniert. Die Ausrichtungsfunktion ist eine der Aggregationsoptionen und wird standardmäßig nicht angezeigt. Maximieren Sie das Element Aggregation und wählen Sie im ersten Element Aligner konfigurieren aus, um die Ausrichtungsfunktion aufzurufen. Danach wird das Element Aggregation durch ein Element Gruppierung und ein Menü namens Ausrichtungsfunktion ersetzt.

Anzuzeigende Spalten auswählen

Standardmäßig enthält eine Spalte in der Tabelle einen numerischen Wert. Alle anderen Spalten entsprechen einem Label in der Zeitreihe. Bei Labelspalten wird der Spaltenname aus dem Label abgeleitet.

Wenn Sie die in der Tabelle angezeigten Spalten konfigurieren möchten, maximieren Sie das Menü Sichtbare Spalten und treffen Sie Ihre Auswahl.

Hinweis :Achten Sie darauf, dass Sie die Spalte mit dem numerischen Wert auswählen.

Spaltenformat konfigurieren

• Wenn Sie eine einzelne Spalte konfigurieren möchten, maximieren Sie im Element Spalten das Menü Spalte überschreiben, wählen Sie die zu ändernde Spalte aus und gehen Sie dann so vor:

  • Verwenden Sie das Feld Anzeigename, um den Namen der Spalte festzulegen.
  • Mit den Schaltflächen Linksbündig, Zentriert und Rechtsbündig können Sie die Ausrichtung der Daten in der Spalte festlegen.
  • Wenn die Zelle je nach Vergleich des numerischen Werts mit einem Grenzwert farblich codiert werden soll, legen Sie die Warn- und Gefahrenschwelle fest.
  • Wenn Sie PromQL-Abfragen schreiben, können Sie über das Menü Einheit die Einheiten festlegen, die mit den Daten angezeigt werden. Die Einheiten werden automatisch konfiguriert, wenn Sie die Abfrage über Menüauswahlen konfigurieren.

Referenzwert anzeigen

Hinweis: Diese Option ist nicht verfügbar, wenn Sie eine Spalte so konfiguriert haben, dass Zellen basierend auf dem numerischen Wert in der Zelle farbcodiert werden.

In Tabellen kann nur ein Wert oder ein Wert relativ zum Wertebereich angezeigt werden. Wenn die Option „Bereich“ ausgewählt ist, wird der Wert zusammen mit einem blauen Balken angezeigt. Die Länge des Balkens ist proportional zum angezeigten Wert.

Mit dem Element Messwertansicht können Sie festlegen, ob ein Referenzwert angezeigt wird.

Tabellen sortieren und filtern

Sie können die Reihenfolge der Zeilen in der Tabellenansicht ändern und den Tabelleninhalt so filtern, dass nur bestimmte Zeilen angezeigt werden. Diese Einstellungen sind nicht dauerhaft. Wenn Sie die Dashboard-Seite verlassen oder das Dashboard neu laden, werden die von Ihnen angewendeten Sortier- und Filteroptionen verworfen.

Sie haben folgende Sortier- und Filteroptionen:

• Klicken Sie auf eine Spaltenüberschrift, um die Tabelle nach einer Spalte zu sortieren.

• Klicken Sie zum Ändern der Tabellenspalten auf Spalten anzeigen, nehmen Sie die gewünschten Änderungen vor und klicken Sie dann auf OK.

• Wenn Sie nur bestimmte Zeilen auflisten möchten, fügen Sie einen oder mehrere Filter hinzu. Sie können mehrere Filter hinzufügen. Wenn Sie den Operator OR nicht zwischen zwei Filtern angeben, werden diese durch ein logisches AND verknüpft.

  Klicken Sie auf Enter property name or value, wählen Sie ein Attribut aus dem Menü aus, geben Sie einen Wert ein oder wählen Sie aus dem Wertmenü aus, um einen Filter hinzuzufügen. Wenn Sie beispielsweise nach dem Attribut Name filtern und den Wert demo eingeben, werden in der Tabelle nur Zeilen aufgelistet, in denen das Feld Name den Wert demo enthält.

Aktuelle Daten mit Warn- oder Fehlerhinweis anzeigen

Fügen Sie ein Messgerät oder eine Kurzübersicht hinzu, um die neueste Messung im Vergleich zu einem farbcodierten Satz von Grenzwerten anzuzeigen. In Messwerten wird nur die letzte Messung angezeigt, während in Kurzübersichten auch ein Verlauf der letzten Messungen zu sehen ist. Die Hintergrundfarbe dieser Widgets ist ebenfalls farblich gekennzeichnet. Wenn der aktuelle Wert innerhalb der erwarteten Bereiche liegt, ist die Widget-Farbe weiß. Wenn der Wert im Warnbereich liegt, wird das Widget gelb. Wenn der Wert im Gefahrenbereich liegt, wird das Widget rot.

In beiden Widgets wird eine einzelne Zeitreihe angezeigt. Der folgende Screenshot zeigt ein Beispiel für eine Anzeige, wenn der Messwert unter den Warn- und Gefahrengrenzwerten liegt:

Der Rest der Informationen in diesem Abschnitt bezieht sich auf die Google Cloud Console. Informationen zur Verwendung der Cloud Monitoring API finden Sie unter Dashboard mit einer einfachen Scorecard.

So fügen Sie einem Dashboard eine Anzeige oder Kurzübersicht hinzu:

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

   Dashboards aufrufen

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

2. Führen Sie einen der folgenden Schritte aus:

   • Zum Erstellen eines neuen Dashboards wählen Sie Dashboard erstellen aus.
   • Wenn Sie ein vorhandenes Dashboard aktualisieren möchten, suchen Sie in der Liste mit allen Dashboards nach dem gewünschten Dashboard und wählen Sie es aus.

3. Klicken Sie in der Symbolleiste auf  Widget hinzufügen.

4. Wählen Sie im Dialogfeld Widget hinzufügen die Option  Messwert aus.

5. Geben Sie die Daten an, die im Diagramm angezeigt werden sollen. Sie können die menügesteuerte Benutzeroberfläche, die Monitoring Query Language (MQL), PromQL oder einen Monitoring-Filter verwenden:

   Menügesteuerte Benutzeroberfläche

   1. Wählen Sie die Zeitachsendaten aus, die Sie ansehen möchten:

      1. Maximieren Sie im Element Messwert das Menü Messwert auswählen.

         Das Menü Messwert auswählen enthält Funktionen, mit denen Sie die verfügbaren Messwerttypen finden können:

         • Verwenden Sie die Filterleiste, um einen bestimmten Messwerttyp zu finden. Wenn Sie beispielsweise util eingeben, werden im Menü nur Einträge angezeigt, die util enthalten. Einträge werden angezeigt, wenn sie einen Groß-/Kleinschreibungs-insensitiven „contains“-Test bestehen.

         • Wenn Sie alle Messwerttypen sehen möchten, auch die ohne Daten, klicken Sie auf  Aktiv. Standardmäßig werden in den Menüs nur Messwerttypen mit Daten angezeigt.

         Sie können beispielsweise die folgenden Optionen auswählen:

         1. Wählen Sie im Menü Aktive Ressourcen die Option VM-Instanz aus.
         2. Wählen Sie im Menü Aktive Messwertkategorien die Option uptime_check aus.
         3. Wählen Sie im Menü Aktive Messwerte die Option Anfragelatenz aus.
         4. Klicken Sie auf Anwenden.

      2. Optional: Wenn nur eine Teilmenge der Daten angezeigt werden soll, wählen Sie im Element Filter die Option Filter hinzufügen aus und nehmen Sie die erforderlichen Einstellungen vor. Sie können beispielsweise Daten für eine Zone aufrufen. Wenden Sie dazu einen Filter an. Sie können mehrere Filter hinzufügen. Weitere Informationen finden Sie unter Diagrammdaten filtern.

      Weitere Informationen finden Sie unter Daten für das Diagramm auswählen.

   2. Kombinieren Sie die Zeitreihen mithilfe der Felder Aggregation:

      • Maximieren Sie das erste Menü und wählen Sie die Funktion aus, mit der die Zeitreihen kombiniert werden sollen.
      • Maximieren Sie das zweite Menü und achten Sie darauf, dass keine Labels ausgewählt sind.

   MQL

   1. Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche  MQL oder  PromQL.
   2. Prüfen Sie, ob MQL im Schalter Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

   3. Geben Sie eine Abfrage in den Abfrageeditor ein. Die Aggregationsfelder müssen so konfiguriert sein, dass alle Zeitreihen kombiniert werden. Wenn Sie beispielsweise die CPU-Auslastung der VM-Instanzen in Ihrem Google Cloud-Projekt in einem Diagramm darstellen möchten, verwenden Sie die folgende Abfrage:

      fetch gce_instance
      | metric 'compute.googleapis.com/instance/cpu/utilization'
      | group_by 1m, [value_utilization_mean: mean(value.utilization)]
      | every 1m
      | group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]
      

      Weitere Informationen zu MQL finden Sie in den folgenden Dokumenten:

      • Einführung in MQL
      • Codeeditor verwenden

   PromQL

   1. Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche  MQL oder  PromQL.
   2. Prüfen Sie, ob PromQL in der Ein-/Aus-Schaltfläche PromQL ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

   3. Geben Sie eine Abfrage in den Abfrageeditor ein. Wenn Sie beispielsweise die durchschnittliche CPU-Auslastung der VM-Instanzen in Ihrem Google Cloud-Projekt in einem Diagramm darstellen möchten, verwenden Sie die folgende Abfrage:

      avg(compute_googleapis_com:instance_cpu_utilization)
      

      Weitere Informationen zur Verwendung von PromQL finden Sie unter PromQL in Cloud Monitoring.

   Monitoring-Filter

   1. Klicken Sie im Element Messwert auf  Hilfe und wählen Sie dann Direkter Filtermodus aus.

      Die Elemente Messwert und Filter werden gelöscht und ein Element Filter erstellt, in das Sie Text eingeben können.

      Wenn Sie einen Ressourcentyp, einen Messwert oder Filter ausgewählt haben, bevor Sie zum Direktfiltermodus gewechselt sind, werden diese Einstellungen im Feld des Elements Filter angezeigt.

   2. Geben Sie einen Monitoring-Filter ein.

   3. Kombinieren Sie die Zeitreihen mithilfe der Felder Aggregation:

      • Maximieren Sie das erste Menü und wählen Sie die Funktion aus, mit der die Zeitreihen kombiniert werden sollen.
      • Maximieren Sie das zweite Menü und achten Sie darauf, dass keine Labels ausgewählt sind.

6. Konfigurieren Sie die Anzeige oder Kurzübersicht im Bereich Anzeige:

   1. Klicken Sie auf Widgettyp und wählen Sie Anzeige oder Dashboard aus.

   2. Klicken Sie bei Messwert-Widgets auf Messwertbereich und legen Sie dann die Mindest- und Höchstwerte fest. Wenn der Messwert einen Prozentwert anzeigt, setzen Sie diese Werte auf 0 bzw. 1.

   3. Klicken Sie auf Grenzwert für Messwert und legen Sie dann die Warn- und Gefahrenschwelle fest. Leere Grenzwertfelder werden nicht verwendet.

      Für das zuvor angezeigte Messgerät sind zwei Schwellenwerte festgelegt. Werte über 0,9 liegen im Gefahrenbereich. Werte über 0,7, die aber nicht im Gefahrenbereich liegen, befinden sich im Warnbereich.

   4. Klicken Sie bei Kurzübersichten auf Spark-Diagrammansicht, maximieren Sie das Optionsmenü und wählen Sie den Darstellungsstil aus.

7. Klicken Sie in der Symbolleiste auf Übernehmen, um die Änderungen auf das Dashboard anzuwenden. Wenn Sie die Änderungen verwerfen möchten, klicken Sie auf Abbrechen.

8. Klicken Sie in der Symbolleiste auf Speichern, um das geänderte Dashboard zu speichern.

So werden Daten für mehrere Messwerttypen in Tabellen zusammengeführt

Wenn in einer Tabelle nach mehreren Messwerttypen abgefragt wird, führt die Google Cloud Console einen Zusammenführungsvorgang durch. Dabei werden die Labels untersucht, die den aggregierten Daten für beide Messwerttypen zugeordnet sind. Wenn anhand der Labels, die beiden Abfragen gemeinsam sind, eine eindeutige Zeilen-ID ermittelt werden kann, wird in einer einzelnen Zeile der Tabelle der jeweils aktuelle Wert für jede Abfrage angezeigt. Andernfalls gibt es eine Zeile pro Zeitreihe.

Angenommen, in einer Tabelle werden zwei verschiedene Messwerttypen abgefragt. Nennen wir diese Abfragen A und B. Im Folgenden wird beschrieben, wie die Abfrageergebnisse zusammengeführt werden:

• Wenn das Ergebnis beider Abfragen dieselben Labels enthält, ist die Zusammenführung immer erfolgreich. Jede Zeile enthält den neuesten Wert für jede Abfrage. Wenn eine Abfrage für eine bestimmte Kombination von Labels keinen Wert zurückgibt, ist die Tabellenzelle leer.

  Angenommen, beide Abfragen enthalten das Label zone. Die Tabelle enthält eine Zeile für jede Zone, die in den Abfragen A und B erfasst wurde. Wenn Abfrage A jedoch eine Zeitreihe mit der Zone us-central1-a zurückgibt, Abfrage B aber keine Zeitreihe mit diesem Wert, wird der aktuelle Wert für Abfrage B als leere Zelle angezeigt.

• Wenn die Labels für die Ergebnisse einer Abfrage eine Teilmenge der Labels für die Ergebnisse der anderen Abfrage sind, werden die Ergebnisse zusammengeführt.

  Angenommen, die Ergebnisse für beide Abfragen enthalten Labels für location und cluster_name, die Ergebnisse für Abfrage A aber auch ein Label für memory_type. In diesem Fall entspricht jede Zeile einer Zeitachse mit eindeutigen Werten für die drei Labels.

  In jeder Zeile ist der Wert für Abfrage B der Wert der Zeitachse, der mit den beiden gemeinsamen Labels location und cluster_name übereinstimmt. Das dritte Label wird ignoriert.

• Wenn die Ergebnisse der beiden Abfragen keine gemeinsamen Labels haben oder einige Labels gemeinsam haben, aber nicht genug, um eine eindeutige Zeilenkennzeichnung zu bilden, können die Ergebnisse nicht zusammengeführt werden. Die Tabelle enthält eine Zeile für jede Zeitreihe, die von Abfrage A oder Abfrage B zurückgegeben wird. Einige Tabellenzellen sind leer.

  Angenommen, die Labels für Abfrage A sind location und memory_type und die Labels für Abfrage B sind location und cluster_name. Das Label location ist zwar häufig, reicht aber nicht aus, um eine eindeutige Zeilenkennzeichnung zu erstellen.

  Wie im nächsten Abschnitt beschrieben, können Sie einen Zusammenführungsfehler möglicherweise beheben.

Fehler beim Zusammenführen beheben

Wenn Sie mehrere Messwerte in einem Diagramm darstellen, kann es zu einem Zusammenführungsfehler kommen, weil für dasselbe Feld unterschiedliche Labelnamen verwendet werden. Eine Möglichkeit, dieses Problem zu beheben, besteht darin, eine Abfrage in PromQL zu konvertieren und dann mit der Funktion label_replace() die Labelnamen des einen Messwerttyps an den anderen anzupassen.

Angenommen, Sie haben eine Tabelle mit zwei Abfragen konfiguriert:

• A: Der Messwerttyp Prometheus/kube_pod_container_status_ready/gauge wird abgefragt. Die Aggregationsoptionen sind so festgelegt, dass Zeitreihen summiert werden, nachdem die Daten nach dem Label cluster gruppiert wurden.

• B: Der Messwerttyp kubernetes.io/container/memory/request_bytes wird abgefragt. Die Aggregationsoptionen sind so festgelegt, dass Zeitreihen summiert werden, nachdem die Daten nach dem Label cluster_name gruppiert wurden.

Die Ergebnisse können in der Tabelle nicht zusammengeführt werden, da die Ergebnisse für Abfrage A und Abfrage B unterschiedliche Labels haben.

Um den Fehler zu beheben, konvertieren Sie die Abfrage A in PromQL und ersetzen Sie cluster durch cluster_name. Das folgende Beispiel zeigt die geänderte Abfrage:

sum by (cluster_name)(
    label_replace(
        avg_over_time(kube_pod_container_status_ready[${__interval}]),
        "cluster_name", "$1", "cluster", "(.*)"
    )
)

Nach den Änderungen werden mit beiden Abfragen dieselben Labels generiert. Daher enthält jede Zeile der Tabelle einen Clusternamen, den Wert für Abfrage A und den Wert für Abfrage B.

Weitere Informationen zur Verwendung von PromQL finden Sie unter PromQL in Cloud Monitoring.

Nächste Schritte

Sie können Ihren benutzerdefinierten Dashboards auch die folgenden Widgets hinzufügen:

• Benachrichtigungsrichtlinien und Vorfälle anzeigen
• Logeinträge
• Beschreibender Text
• Service Level Objectives (SLOs) für eine Reihe von Diensten

Informationen zum Untersuchen von Diagrammdaten und zum Filtern von Dashboards finden Sie in den folgenden Dokumenten:

• Im Diagramm aufgeführte Daten untersuchen
• Benutzerdefiniertes Dashboard filtern