Diagramme und Tabellen zu einem benutzerdefinierten Dashboard hinzufügen

In diesem Dokument wird beschrieben, wie Sie einem benutzerdefinierten Dashboard mithilfe der Google Cloud Konsole Diagramme, Tabellen, Messgeräte und Scorecards hinzufügen. Sie können Messwertdaten über ein Zeitintervall hinweg darstellen, indem Sie ein Liniendiagramm, ein gestapeltes Flächendiagramm, ein Balkendiagramm oder ein Heatmap-Diagramm hinzufügen. Wenn Sie nur an den neuesten Messungen interessiert sind, fügen Sie eine Tabelle, ein Kreisdiagramm, eine Anzeige, eine Kurzübersicht oder ein Baumdiagramm hinzu. Die Farbe von Anzeigen und Kurzübersichten ändert sich je nachdem, wie der letzte Wert im Vergleich zu den Warn- und Gefahrenschwellen abschneidet.

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

In Diagrammen, Tabellen, Messgeräten und Kurzübersichten in benutzerdefinierten Dashboards kann jeder Messwerttyp angezeigt werden, der einen numerischen Wert oder einen Verteilungswert hat, 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, Messgeräte und Kurzübersichten hinzufügen, in denen Zeitachsendaten dargestellt werden. Informationen zum Hinzufügen anderer Arten von Widgets zu Ihren Dashboards finden Sie in den folgenden Artikeln:

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

Diese Funktion wird nur für Google Cloud -Projekte unterstützt. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.

Hinweise

Führen Sie die folgenden Schritte im Google Cloud -Projekt aus, in dem Sie Dashboards erstellen und verwalten möchten:

  • Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.editor) für Ihr Projekt zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Erstellen und Ändern von benutzerdefinierten Dashboards über die Google Cloud Konsole 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 100 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 einem Dashboard beispielsweise eine Tabelle hinzufügen möchten, in der die CPU-Auslastung Ihrer VM-Instanzen angezeigt wird, 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.

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

Diagramme und Tabellen zu einem Dashboard hinzufügen

In diesem Abschnitt wird beschrieben, wie Sie Diagramme und Tabellen mit derGoogle Cloud -Konsole konfigurieren:

  • In Diagrammen werden Daten im Zeitverlauf dargestellt. Es gibt vier Stile: Linie, Gestapelte Fläche, Gestapelter Balken 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 die auf Ihre Instanzen geschriebenen Laufwerksbytes 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 mit Zeitachse.

    Informationen zur Verwendung der Cloud Monitoring API zum Konfigurieren eines Diagramms 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 eine visuelle Darstellung des Werts 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 Tabellenform in einem Dashboard präsentieren.

    Informationen zur Verwendung der Cloud Monitoring API zum Konfigurieren einer Tabelle 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. Wählen Sie in der Symbolleiste der Google Cloud -Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.

  3. 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 es in der Liste aller Dashboards und wählen Sie den Namen aus.

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

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

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

    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 Test mit „contains“ (Groß-/Kleinschreibung wird nicht berücksichtigt) 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 Übernehmen.

      2. Optional: Wenn Sie eine Teilmenge der anzuzeigenden Daten angeben möchten, wählen Sie im Element Filter die Option Filter hinzufügen aus und füllen Sie das Dialogfeld aus. 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. Zeitachsen kombinieren und ausrichten:

      • Wenn Sie alle Zeitreihen anzeigen möchten, legen Sie im Element Aggregation das erste Menü auf Nicht aggregiert und das zweite Menü auf Keine fest.

      • So kombinieren Sie Zeitreihen im Element Aggregation:

        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 Zeitachsen mit denselben Labelwerten kombinieren möchten, maximieren Sie das zweite Menü und wählen Sie 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 Zeitachse angezeigt.

      • Optional: Wenn Sie den Abstand zwischen Datenpunkten konfigurieren möchten, klicken Sie auf  Abfrageelement hinzufügen, wählen Sie Mindestintervall 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 Limit.

    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 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:

    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 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 in den Direktfiltermodus gewechselt sind, werden diese Einstellungen im Feld des Elements Filter angezeigt.

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

    3. Zeitachsen kombinieren und ausrichten:

      • Wenn Sie alle Zeitreihen anzeigen möchten, legen Sie im Element Aggregation das erste Menü auf Nicht aggregiert und das zweite Menü auf Keine fest.

      • So kombinieren Sie Zeitreihen im Element Aggregation:

        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 Zeitachsen mit denselben Labelwerten kombinieren möchten, maximieren Sie das zweite Menü und wählen Sie 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 Zeitachse angezeigt.

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

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

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

    1. Wählen Sie Abfrage hinzufügen aus. Eine neue Abfrage wird hinzugefügt. Beispiel: Eine Abfrage mit dem Label B wird hinzugefügt.

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

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

    Beispiel für Metrics Explorer mit zwei Messwerttypen

    MQL

    Nicht unterstützt.

    PromQL

    Nicht unterstützt.

    Monitoring-Filter

    Nicht unterstützt.

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

    1. Konfigurieren Sie das Diagramm so, dass zwei Messwerttypen mit derselben Messwertart angezeigt werden. Beide sind beispielsweise GAUGE-Messwerte.
    2. Achten Sie darauf, dass der Wert des Felds Min. Intervall für beide Messwerttypen gleich ist. Wenn Sie auf dieses Feld zugreifen möchten, klicken Sie auf  Abfrageelement hinzufügen und wählen Sie Mindestintervall aus.

    3. Aktualisieren Sie die Zusammenfassungsfelder.

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

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

    4. Wählen Sie in der Symbolleiste des Abfragebereichs Verhältnis erstellen aus und füllen Sie das Dialogfeld aus.

      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 Zähler an.
      • B gibt die Abfrage für den Nenner an.

      Das folgende Beispiel veranschaulicht ein Verhältnis, das die Summe der pro Zone auf die Festplatte geschriebenen Byte mit der Gesamtzahl der auf die Festplatte geschriebenen Byte vergleicht:

      Beispiel für ein Verhältnis von Messwerten

    5. Optional: Wenn Sie die Messwerte für Zähler und Nenner 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 das Verhältnis von zwei verschiedenen Messwerten berechnen und 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:

    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 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.

  9. Optional: Wenn Sie die Visualisierung ändern möchten, klicken Sie im Bereich Display auf Widget-Typ und treffen Sie eine Auswahl.

    Im Menü Widget-Typ werden alle Widget-Typen aufgeführt, mit denen derselbe Datentyp angezeigt werden kann. Einige Widgets sind jedoch möglicherweise nicht aktiviert. Angenommen, Sie haben ein Diagramm in einem Dashboard, das für die Anzeige eines Messwerttyps konfiguriert ist. Das Liniendiagramm zeigt mehrere Zeitreihen und jeder Messwert ist ein Double:

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

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

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

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

  10. 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 Anzeige:

  11. Optional: Konfigurieren Sie im Bereich Display die Sichtbarkeit des Diagramms oder der Tabelle. Standardmäßig ist Ihr Widget sichtbar. Sie können jedoch eine Variable verwenden, um festzulegen, ob das Widget ein- oder ausgeblendet wird.

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

  13. Klicken Sie zum Speichern des geänderten Dashboards in der Symbolleiste auf Speichern.

Nur die neuesten Daten anzeigen

Mit Monitoring haben Sie mehrere Möglichkeiten, nur die letzten Messungen zu visualisieren, anstatt den Verlauf der Messungen anzuzeigen:

  • Wenn Sie den letzten 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 die letzten Werte aggregierter Daten als Reihe verschachtelter Rechtecke visualisieren möchten, wobei die Farbe eines Rechtecks proportional zu seinem Wert ist, fügen Sie ein Treemap-Widget hinzu.

  • Wenn Sie den letzten Wert jeder Zeitachse in Tabellenform 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 Anzeige 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.

Die neuesten Daten in einem Kreisdiagramm darstellen

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

Der folgende Screenshot zeigt ein Dashboard, das die CPU-Auslastung von VM-Instanzen mit zwei verschiedenen Konfigurationen eines Kreisdiagramm-Widgets anzeigt:

Beispiel für **PieChart**-Widgets.

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 darzustellenden Daten ausgewählt haben, legen Sie im Bereich Anzeige das Feld Widget-Typ auf Kreisdiagramm fest.
    • Wenn Sie den Gesamtwert anzeigen möchten, legen Sie das Feld Diagrammtyp auf Ringdiagramm fest.

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

Neuesten Wert als Baumdiagramm anzeigen

Fügen Sie ein Baumdiagramm hinzu, um die neuesten Daten als verschachtelte Rechtecke darzustellen, wobei jedes Rechteck einer eindeutigen Sammlung von Labelwerten entspricht. Angenommen, Sie haben die Daten, die Sie in einem Diagramm darstellen möchten, nach dem Label zone zusammengefasst. Wenn Sie den Widget-Typ auf „Baumdiagramm“ festlegen, entspricht jedes Rechteck im Baumdiagramm einer Zone. Die Farbsättigung eines Rechtecks ist proportional zum Wert, den es darstellt.

Der folgende Screenshot zeigt ein Baumdiagramm-Widget, in dem die Zeitreihen nach zone und storage_type aggregiert werden:

Beispiel für ein **Strukturkarten-Widget**.

Im Screenshot ist die Kurzinfo für ein Rechteck zu sehen.

So konfigurieren Sie ein Baumdiagramm:

  1. Wählen Sie das Baumdiagramm-Widget im Bereich Widget hinzufügen aus.
  2. Wählen Sie mit dem Element Messwert auswählen den anzuzeigenden Messwerttyp aus.
  3. Wenn im Element Aggregation die Option Nicht aggregiert angezeigt wird, wählen Sie im Menü eine Aggregationsfunktion aus. Wählen Sie beispielsweise Mittelwert oder Max aus.
  4. Wählen Sie im zweiten Feld des Elements Aggregation mindestens ein Label aus.
  5. Klicken Sie in der Symbolleiste auf Anwenden, um die Änderungen auf das Dashboard anzuwenden. Wenn Sie die Änderungen verwerfen möchten, klicken Sie auf Abbrechen.
  6. Klicken Sie zum Speichern des geänderten Dashboards in der Symbolleiste auf Speichern.

Informationen zur Verwendung der API zum Konfigurieren eines Treemaps finden Sie unter Dashboard mit einem Treemap-Widget.

Aktuelle Daten in Tabellenform anzeigen

Wenn Sie die neuesten Daten in Tabellenform ansehen 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 letzte Wert oder ein aggregierter Wert ist. In den anderen Spalten werden die Labels in der Zeitreihe angezeigt. Wenn in einer Tabelle mehrere Messwerttypen angezeigt werden, werden die Daten für beide Messwerttypen nach Möglichkeit in derselben Zeile dargestellt. Weitere Informationen finden Sie unter So werden in Tabellen mehrere Messwerttypen zusammengeführt.

Es gibt zwei Widgets, in denen Daten in Tabellenform angezeigt werden: das Widget Top-Liste und das Widget Tabelle. Der Hauptunterschied zwischen diesen beiden Widgets besteht darin, dass im Widget Top-Liste die Reihenfolge der Zeilen sortiert wird und der Wert zusammen mit einem visuellen Indikator für den Wert im Vergleich zum Bereich der möglichen Werte angezeigt wird. Da das Widget Top-Liste eine visuelle Darstellung des Werts bietet, können Sie die Zelle nicht basierend darauf farblich kennzeichnen, wie der Wert im Vergleich zu einem Schwellenwert abschneidet.

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

Der folgende Screenshot zeigt zwei Tabellen. In der ersten Tabelle werden zwei Messwerttypen angezeigt: 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 wird der letzte Wert eines Messwerttyps angezeigt. Die Spalte „Wert“ wurde so konfiguriert, dass die Zelle basierend darauf, wie der Wert im Vergleich zu einem Schwellenwert abschneidet, farblich codiert wird:

Beispiel für eine Tabelle mit zwei Messwerttypen.

Letzten Wert oder aggregierten Wert anzeigen

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

Mit dem Feld Value option (Wertoption) können Sie zwischen dem letzten Wert und dem aggregierten Wert auswählen.

Wenn Sie den aggregierten Wert anzeigen, werden die Daten für jede Zeitreihe im ausgewählten Zeitraum mit der Ausrichtungsfunktion kombiniert. Die Ausrichtungsfunktion ist eine der Aggregationsoptionen und wird nicht standardmäßig angezeigt. Wenn Sie die Ausrichtungsfunktion aufrufen möchten, maximieren Sie das Element Aggregation und wählen Sie im ersten Element Aligner konfigurieren aus. Nachdem Sie diese Auswahl getroffen haben, wird das Element Aggregation durch ein Element Gruppierung und ein Menü mit dem Namen Ausrichtungsfunktion ersetzt.

Anzuzeigende Spalten auswählen

Standardmäßig wird in einer Spalte der Tabelle ein numerischer Wert angezeigt. Alle anderen Spalten entsprechen einem Label in der Zeitachse. Bei labelbasierten Spalten 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 eine Auswahl.

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 führen Sie dann einen der folgenden Schritte aus:

    • Verwenden Sie das Feld Anzeigename, um den Namen der Spalte festzulegen.
    • Mit den Schaltflächen Linksbündig ausrichten, Zentriert ausrichten und Rechtsbündig ausrichten können Sie die Ausrichtung der Daten in der Spalte festlegen.
    • Wenn Sie die Zelle farblich kennzeichnen möchten, je nachdem, wie der numerische Wert im Vergleich zu einem Schwellenwert abschneidet, legen Sie die Warn- und Gefahrenschwellen fest.
    • Wenn Sie PromQL-Abfragen schreiben, verwenden Sie das Menü Einheit, um die Einheiten festzulegen, die mit den Daten angezeigt werden. Die Einheiten werden automatisch konfiguriert, wenn Sie Ihre Abfrage über Menüauswahlen konfigurieren.

Referenzwert anzeigen

In Tabellen kann nur ein Wert oder ein Wert relativ zum Wertebereich angezeigt werden. Wenn die Bereichsoption 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 Metric view (Messwertansicht) können Sie konfigurieren, ob ein Referenzwert angezeigt werden soll.

Tabellen sortieren und filtern

Sie können die Reihenfolge der Zeilen in der Tabellenansicht ändern und den Tabelleninhalt filtern, sodass nur bestimmte Zeilen angezeigt werden. Diese Einstellungen werden nicht gespeichert. 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, verknüpft ein logisches AND die Filter.

    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 Warnung oder Fehleranzeige anzeigen

Fügen Sie ein Tachometer oder eine Kurzübersicht hinzu, um die jeweils aktuelle Messung im Vergleich zu einem farbcodierten Satz von Schwellenwerten anzuzeigen. In Messinstrumenten wird nur die letzte Messung angezeigt, in Kurzübersichten auch ein Verlauf der letzten Messungen. Die Hintergrundfarbe dieser Widgets ist ebenfalls farblich gekennzeichnet. Wenn der letzte Wert im erwarteten Bereich liegt, ist das Widget weiß. Wenn der Wert in einem 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 die letzte Messung unter den Warn- und Gefahrengrenzwerten liegt:

Beispiel für eine Anzeige.

Die restlichen Informationen in diesem Abschnitt beziehen sich auf dieGoogle 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. Wählen Sie in der Symbolleiste der Google Cloud -Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt des für Apps aktivierten Ordners aus.

  3. 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 es in der Liste aller Dashboards und wählen Sie den Namen aus.

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

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

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

    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 Test mit „contains“ (Groß-/Kleinschreibung wird nicht berücksichtigt) 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 Übernehmen.

      2. Optional: Wenn Sie eine Teilmenge der anzuzeigenden Daten angeben möchten, wählen Sie im Element Filter die Option Filter hinzufügen aus und füllen Sie das Dialogfeld aus. 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 mit den Feldern unter Aggregation:

      • Maximieren Sie das erste Menü und wählen Sie die Funktion aus, mit der die Zeitachsen kombiniert werden.
      • 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. Sie müssen dafür sorgen, dass die Aggregationsfelder so eingestellt sind, dass alle Zeitreihen kombiniert werden. Wenn Sie beispielsweise die CPU-Auslastung der VM-Instanzen in Ihrem Google Cloud Projekt 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:

    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 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 in den Direktfiltermodus gewechselt sind, werden diese Einstellungen im Feld des Elements Filter angezeigt.

    2. Geben Sie einen Monitoring-Filter ein.

    3. Kombinieren Sie die Zeitreihen mit den Feldern unter Aggregation:

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

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

    1. Klicken Sie auf  Widget-Typ und wählen Sie Messgerät oder Scorecard aus.

    2. Klicken Sie für Anzeigen-Widgets auf Anzeigenbereich 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  Anzeigenschwelle und legen Sie dann die Warn- und Gefahrenschwellen fest. Leere Felder für Grenzwerte werden nicht verwendet.

      Für das zuvor angezeigte Messgerät werden zwei Grenzwerte 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 für Kurzübersichten auf  Spark-Diagrammansicht, maximieren Sie das Optionsmenü und wählen Sie dann den Darstellungsstil aus.

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

  9. Klicken Sie zum Speichern des geänderten Dashboards in der Symbolleiste auf Speichern.

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

Wenn in einer Tabelle mehrere Messwerttypen abgefragt werden, führt die Google Cloud Konsole einen Merge-Vorgang durch, indem sie die Labels der aggregierten Daten für beide Messwerttypen untersucht. Wenn die Labels, die beiden Abfragen gemeinsam sind, einen eindeutigen Zeilen-Identifier für die Überwachung ermöglichen, wird in einer einzelnen Zeile der Tabelle der jeweils letzte Wert für jede Abfrage angezeigt. Andernfalls gibt es eine Zeile für jede 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 für eine bestimmte Kombination von Labels kein Wert zurückgegeben wird, ist die Tabellenzelle leer.

    Angenommen, beide Abfragen enthalten das Label zone. Die Tabelle enthält eine Zeile für jede Zone, die von Abfrage A und Abfrage B gemeldet wird. Wenn mit der Abfrage A jedoch eine Zeitreihe mit der Zone us-central1-a zurückgegeben wird, mit der Abfrage B aber keine Zeitreihe mit diesem Wert, wird der letzte Wert für die 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 die Abfrage B der Wert der Zeitachse, die den beiden gemeinsamen Labels location und cluster_name entspricht. Das dritte Label wird ignoriert.

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

    Angenommen, die Labels für die Abfrage A sind location und memory_type und die Labels für die Abfrage B sind location und cluster_name. Auch wenn das Label location häufig vorkommt, reicht es nicht aus, um eine eindeutige Zeilen-ID zu erstellen.

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

Fehler beim Zusammenführen beheben

Wenn Sie mehrere Messwerte in einem Diagramm darstellen, kann es zu einem Fehler beim Zusammenführen kommen, weil für dasselbe Feld unterschiedliche Labelnamen verwendet werden. Eine Möglichkeit, diesen Fehler zu beheben, besteht darin, eine Abfrage in PromQL zu konvertieren und dann die Funktion label_replace() zu verwenden, um die Labelnamen eines Messwerttyps an die des anderen Messwerttyps anzupassen.

Angenommen, Sie haben eine Tabelle, die mit zwei Abfragen konfiguriert ist:

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

  • B: Fragt den Messwerttyp kubernetes.io/container/memory/request_bytes ab. 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 die Abfrage A und die 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 veranschaulicht die geänderte Abfrage:

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

Durch die Änderungen wird für beide Abfragen dieselbe Gruppe von Labels generiert. Daher enthält jede Zeile in der Tabelle einen Clusternamen, den Wert für die Abfrage A und den Wert für die Abfrage B.

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:

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