Diagramme mit Metrics Explorer erstellen

In diesem Dokument wird beschrieben, wie Sie Messwertdaten untersuchen können, indem Sie mit Metrics Explorer ein temporäres Diagramm erstellen. Wenn Sie beispielsweise die CPU-Auslastung einer virtuellen Maschine (VM) ansehen möchten, können Sie mit dem Metrics Explorer ein Diagramm mit den neuesten Daten erstellen. Permanente Diagramme können Sie mit dem Metrics Explorer erstellen und in einem benutzerdefinierten Dashboard speichern. Alternativ können Sie ein benutzerdefiniertes Dashboard erstellen, in dem Diagramme, Logs, Vorfälle und andere Inhalte angezeigt werden, und dann über die Dashboard-Oberfläche Diagramme zu diesem Dashboard hinzufügen. Informationen zu benutzerdefinierten Dashboards finden Sie unter Benutzerdefinierte Dashboards erstellen und verwalten.

Sie können Diagramme erstellen, z. B. solche, die einen einzelnen Messwerttyp darstellen, und komplexe Diagramme, z. B. solche, die mehrere Messwerttypen darstellen. Nachdem Sie ein Diagramm mit dem Metrics Explorer erstellt haben, können Sie es verwerfen, in einem benutzerdefinierten Dashboard speichern oder seine Konfiguration speichern oder freigeben.

Der folgende Screenshot zeigt einen einzelnen Messwerttyp – die CPU-Auslastung einer VM-Instanz –, der auf der Seite Metrics Explorer dargestellt wird:

Im Metrics Explorer dargestellte Werte.

Der vorherige Screenshot zeigt mehrere Zeilen. Jede Zeile zeigt die durchschnittliche CPU-Auslastung für alle VMs in einer bestimmten Zone.

Diagramm für einen einzelnen Messwerttyp erstellen

So konfigurieren Sie ein Diagramm für die Anzeige eines einzelnen Messwerts:

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

    Zum Metrics Explorer

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

  2. Geben Sie an, welche Daten 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:

        • Über die Filterleiste können Sie einen bestimmten Messwerttyp finden. Wenn Sie beispielsweise util eingeben, schränken Sie das Menü auf Einträge ein, die util enthalten. Einträge werden angezeigt, wenn sie einen „Enthält“-Test bestehen, bei dem die Groß-/Kleinschreibung nicht berücksichtigt wird.

        • Klicken Sie auf Aktiv, um alle Messwerttypen (auch solche ohne Daten) aufzurufen. 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 Sie nur einen Teil 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 einen Filter anwenden, um Daten für eine Zone anzusehen. 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. Zeitreihen kombinieren und ausrichten:

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

      • So kombinieren Sie Zeitachsen 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 Mean auswählen, ist die angezeigte Zeitachse der Durchschnitt aller Zeitachsen.

        2. Maximieren Sie das zweite Menü und wählen Sie ein oder mehrere Labels aus, um Zeitreihen mit denselben Labelwerten zu kombinieren.

          Das Diagramm wird aktualisiert und zeigt eine Zeitachse für jede eindeutige Kombination von Labelwerten. Wenn beispielsweise Zeitachsen pro Zone angezeigt werden sollen, stellen Sie das zweite Menü auf zone ein.

          Wenn das zweite Menü auf None (Keine) festgelegt ist, wird im Diagramm eine Zeitachse angezeigt.

      • Optional: Zum Konfigurieren des Abstands zwischen Datenpunkten klicken Sie auf Abfrageelement hinzufügen, wählen Sie Min. Intervall aus und geben Sie dann einen Wert ein.

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

    3. Optional: Mit dem Element Sort & Limit (Sortieren und Limit) können Sie nur die Zeitachsen mit den höchsten oder niedrigsten Werten aufrufen.

    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 die Abfrage in den Abfrageeditor ein. Wenn Sie beispielsweise die CPU-Auslastung der VM-Instanzen in Ihrem Google Cloud-Projekt grafisch 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 Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

    3. Geben Sie die Abfrage in den Abfrageeditor ein. Wenn Sie beispielsweise die durchschnittliche CPU-Auslastung der VM-Instanzen in Ihrem Google Cloud-Projekt grafisch 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 Metric (Messwert) auf Help (Hilfe) und wählen Sie dann Direct Filter Mode (Direktfiltermodus) aus.

      Die Elemente Metric und Filter werden gelöscht und das Element Filters wird erstellt, über das Sie Text eingeben können.

      Wenn Sie vor dem Wechsel in den direkten Filtermodus einen Ressourcentyp, einen Messwert oder Filter ausgewählt haben, werden diese Einstellungen im Feld des Elements Filter angezeigt.

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

    3. Zeitreihen kombinieren und ausrichten:

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

      • So kombinieren Sie Zeitachsen 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 Mean auswählen, ist die angezeigte Zeitachse der Durchschnitt aller Zeitachsen.

        2. Maximieren Sie das zweite Menü und wählen Sie ein oder mehrere Labels aus, um Zeitreihen mit denselben Labelwerten zu kombinieren.

          Das Diagramm wird aktualisiert und zeigt eine Zeitachse für jede eindeutige Kombination von Labelwerten. Wenn beispielsweise Zeitachsen pro Zone angezeigt werden sollen, stellen Sie das zweite Menü auf zone ein.

          Wenn das zweite Menü auf None (Keine) festgelegt ist, wird im Diagramm eine Zeitachse angezeigt.

      • Optional: Zum Konfigurieren des Abstands zwischen Datenpunkten klicken Sie auf Abfrageelement hinzufügen, wählen Sie Min. Intervall aus und geben Sie dann einen Wert ein.

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

  3. Aktualisieren Sie die Diagrammeinstellungen basierend auf dem ausgewählten Messwerttyp:

    • Verwenden Sie für Kontingentmesswerttypen die folgenden Einstellungen:

      • Stellen Sie in der Symbolleiste die Zeitsteuerung auf mindestens eine Woche ein. Kontingentmesswerte melden normalerweise eine Stichprobe pro Tag.
      • Maximieren Sie im Bereich Anzeige das Menü Widget-Typ und wählen Sie Gestapeltes Balkendiagramm aus.

    • Achten Sie bei Messwerttypen mit dem Werttyp Distribution darauf, dass das Menü Widget-Typ auf Heatmap-Diagramm festgelegt ist. Weitere Informationen finden Sie unter Verteilungswert-Messwerte.

    • Für andere Messwerttypen können Sie das Menü Widget-Typ verwenden, um sich anzusehen, wie die Daten dargestellt werden. Im Menü Widget-Typ werden alle verfügbaren Widgettypen aufgeführt. Einige Widgets sind jedoch möglicherweise nicht aktiviert. Nehmen wir als Beispiel ein Diagramm mit mehreren Zeitreihen und nehmen an, dass jeder gemessene Wert ein Doppelter ist:

      • Die Widgets für Liniendiagramm, Gestapeltes Balkendiagramm und Gestapeltes Flächendiagramm sind als kompatibel aufgeführt. Sie können jeden dieser Typen auswählen.
      • Das Heatmap-Widget ist deaktiviert, da diese Widgets nur Daten mit Verteilungswerte anzeigen können.

  4. Optional: Mit den Optionen im Bereich Anzeige können Sie ändern, wie die ausgewählten Daten im Diagramm angezeigt werden:

Mehrere Messwerttypen in einem Diagramm darstellen

In einigen Situationen kann es sinnvoll sein, Zeitreihen verschiedener Messwerttypen im selben Diagramm anzuzeigen. Wenn Sie beispielsweise die Lese- und Schreiblasten auf einer VM vergleichen möchten, konfigurieren Sie ein Diagramm, das die Anzahl der gelesenen und die Anzahl der geschriebenen Byte anzeigt.

Wenn Sie Diagramme für mehrere Messwerte erstellen möchten, müssen Sie die menügesteuerte Benutzeroberfläche verwenden. Auf den anderen Oberflächen wird die Darstellung mehrerer Messwerte nicht unterstützt.

So rufen Sie mehrere Messwerte in einem Diagramm auf:

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

    Zum Metrics Explorer

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

  2. Geben Sie an, welche Daten im Diagramm angezeigt werden sollen.

    1. Wählen Sie im Element Metric (Messwert) den ersten Messwerttyp aus, dessen Daten Sie ansehen möchten. Informationen zu diesen Schritten finden Sie unter Diagramm für einen einzelnen Messwerttyp erstellen.

      Die Abfrage für diese Auswahl hat die Kennzeichnung A.

    2. Gehen Sie für jeden weiteren Messwerttyp so vor:

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

      2. Wählen Sie für die neue Abfrage im Element Metric (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.

      Im folgenden Screenshot sehen Sie, wie der Metrics Explorer angezeigt wird, wenn zwei Messwerttypen im Diagramm dargestellt werden:

      Beispiel für einen Metrics Explorer mit zwei Messwerttypen

    3. Optional: Maximieren Sie im Bereich Anzeige das Menü Y-Achse und legen Sie fest, welche Y-Achse für den jeweiligen Messwerttyp verwendet werden soll.

    MQL

    Nicht unterstützt.

    PromQL

    Nicht unterstützt.

    Monitoring filter

    Nicht unterstützt.

Diagramm eines Verhältnisses von Messwerten

Es kann hilfreich sein, die Anzahl der gemeldeten Fehler zu überwachen. In diesem Fall ist es jedoch wahrscheinlicher, dass Sie die Fehlerrate überwachen müssen. Das heißt, Sie möchten wissen, wie viele Fehler im Vergleich zur Gesamtzahl der Antworten aufgetreten sind. Um diese Anforderung zu erfüllen, können Sie ein Diagramm so konfigurieren, dass das Verhältnis zweier Messwerte angezeigt wird. Informationen zu Beispielen und Informationen zu Anomalien, die beim Diagramm von Verhältnissen von Messwerten auftreten können, finden Sie unter Verhältnisse von Messwerten.

So rufen Sie ein Verhältnis von Messwerten in einem Diagramm auf:

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

    Zum Metrics Explorer

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

  2. Geben Sie die Daten an, die im Diagramm angezeigt werden sollen:

    1. Konfigurieren Sie den Zähler:

      1. Wählen Sie in den Menüs des Elements Metric (Messwert) einen Ressourcentyp und einen Messwerttyp aus. Informationen zu diesen Schritten finden Sie unter Diagramm für einen einzelnen Messwerttyp erstellen.
      2. Aktualisieren Sie die Zusammenfassungsfelder. Standardmäßig wird der Durchschnitt aus allen Zeitreihen ermittelt.
      3. Optional: Aktualisieren Sie die feste Dauer für die Punkte innerhalb einer Zeitreihe, die kombiniert werden sollen. Klicken Sie zum Ändern dieses Felds auf Abfrageelement hinzufügen, wählen Sie Mindestintervall aus und füllen Sie das Dialogfeld aus.

    2. Wählen Sie Abfrage hinzufügen aus und konfigurieren Sie den Nenner:

      1. Wählen Sie für die neue Abfrage im Element Messwert einen Ressourcentyp und einen Messwerttyp aus.

        Wählen Sie einen Messwerttyp aus, dessen Messwertart mit dem Zähler übereinstimmt. Wenn der Zählermesswert beispielsweise ein GAUGE-Messwert ist, wählen Sie den Messwert GAUGE für den Nenner aus.

      2. Aktualisieren Sie die Zusammenfassungsfelder.

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

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

      3. Klicken Sie auf Abfrageelement hinzufügen, wählen Sie Mindestintervall aus und achten Sie darauf, dass dieses Feld auf den Wert festgelegt ist, der vom Zähler verwendet wird.

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

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

      Beispiel für ein Verhältnis von Messwerten.

    4. Optional: Wenn Sie die Zähler- und Nennermesswerte ändern möchten, maximieren Sie im Element Verhältnis das Menü 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 die Abfrage in den Abfrageeditor ein. Mit MQL können Sie ein Verhältnis von zwei verschiedenen Messwerten berechnen und einen einzelnen Messwert nach einem Label filtern und dann das Verhältnis berechnen. Die folgende Abfrage berechnet das Verhältnis der Antworten mit dem Wert 500 zur Gesamtzahl der Antworten:

      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 Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

    3. Geben Sie die Abfrage in den Abfrageeditor ein. Wenn Sie beispielsweise das Verhältnis der durchschnittlichen Latenz Ihres Messwerts my_summary_latency_seconds 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.

Diagramme für später speichern

Mit dem Metrics Explorer können Sie ein Diagramm erstellen, mit dem Sie einen Messwert untersuchen können. Die von diesem Tool erstellten Diagramme sind jedoch nicht persistent. Wenn Sie die Seite „Metrics Explorer“ verlassen, wird das Diagramm verworfen.

Wenn Sie ein Diagramm, das Sie mit Metrics Explorer konfiguriert haben, für eine spätere Verwendung speichern möchten, fügen Sie es einem benutzerdefinierten Dashboard hinzu oder speichern Sie die URL des Diagramms:

  • Führen Sie einen der folgenden Schritte aus, um das Diagramm einem benutzerdefinierten Dashboard hinzuzufügen:

    • Wenn Sie die Google Cloud Console zum Verwalten Ihrer benutzerdefinierten Dashboards verwenden, wählen Sie in der Symbolleiste des Metrics Explorer Diagramm speichern aus und füllen das Dialogfeld aus. Sie können das Diagramm in einem vorhandenen benutzerdefinierten Dashboard speichern oder ein Dashboard erstellen.

    • Wenn Sie die Cloud Monitoring API zum Verwalten Ihrer benutzerdefinierten Dashboards verwenden, aktualisieren Sie die JSON-Datei, die das Dashboard und seinen Inhalt definiert. Klicken Sie in der Diagrammsymbolleiste auf  JSON Editor, um auf die JSON-Darstellung zuzugreifen.

      Ausführliche Informationen zur Verwendung der API zum Verwalten benutzerdefinierter Dashboards finden Sie unter Dashboards nach API erstellen und verwalten.

  • Speichern Sie die Diagramm-URL, um einen Verweis auf die Diagrammkonfiguration beizubehalten. Da die Diagramm-URL die Diagrammkonfiguration codiert, wird das von Ihnen konfigurierte Diagramm angezeigt, wenn Sie diese URL in einen Browser einfügen.

    Die URL des Diagramms erhalten Sie, indem Sie in der Diagrammsymbolleiste auf Link klicken.

Konfiguration eines Diagramms speichern

Wenn Sie benutzerdefinierte Dashboards mithilfe der Cloud Monitoring API verwalten, können Sie den Metrics Explorer zum Erstellen der Daten verwenden, die Sie der API zur Verfügung stellen:

  • Um die JSON-Darstellung für ein Diagramm zu generieren, das Sie einem Dashboard hinzufügen möchten, konfigurieren Sie das Diagramm mit dem Metrics Explorer. Anschließend können Sie die Optionen im Metrics Explorer verwenden, um die JSON-Darstellung des Diagramms anzusehen und zu kopieren.

  • Um die Syntax für einen Monitoring-Filter zu ermitteln, der mit der Cloud Monitoring API verwendet wird, konfigurieren Sie das Diagramm über die menübasierte Oberfläche des Metrics Explorer. Nachdem Sie den Messwert und die Filter ausgewählt haben, wechseln Sie in den direkten Filtermodus, um den entsprechenden Monitoring-Filter aufzurufen.

Die im Diagramm angezeigten Daten speichern

Klicken Sie auf CSV herunterladen, um die im Diagramm angezeigten Daten in Ihrem lokalen System zu speichern.

Nächste Schritte