Messwerte bei Verwendung von Metrics Explorer auswählen

Metrics Explorer ist ein eigenständiges Diagrammtool, mit dem Sie Diagramme für jeden (numerischen) Messwert erstellen können, der von Ihrem Projekt erfasst wird. Auf dieser Seite wird beschrieben, wie Sie Metrics Explorer über den Tab Configuration (Konfiguration) konfigurieren. Wenn Sie Monitoring Query Language (MQL) verwenden, gelten die auf dieser Seite beschriebenen Konzepte Sie müssen jedoch die in der Einführung in die Monitoring-Abfragesprache (MQL) definierte Syntax verwenden.

Informationen zum Konfigurieren des Stils eines Diagramms finden Sie unter Ansichtsoptionen festlegen.

Anzuzeigende Daten auswählen

Zur Angabe der Messwerte, die beim Verwenden von Metrics Explorer angezeigt werden sollen, geben Sie Werte für einen Messwert und einen Ressourcentyp an:

  • Das Feld metric gibt die Messwerte an, die von einer überwachten Ressource erfasst werden sollen. Er enthält eine Beschreibung dessen, was gemessen wird und wie die Messwerte interpretiert werden. Messwert ist eine Kurzform des Messwerttyps. Konzeptionelle Informationen finden Sie unter Messwerttypen.

  • Das Feld Ressourcentyp gibt an, von welcher Ressource die Messwertdaten erfasst werden. Der Ressourcentyp wird manchmal als überwachter Ressourcentyp oder Ressource bezeichnet. Konzeptionelle Informationen finden Sie unter Überwachte Ressourcen.

Für das Monitoring stehen viele vordefinierte Messwerttypen und überwachte Ressourcen zur Verfügung. Sie können auch benutzerdefinierte Messwerte erstellen:

Messwertangabefeld

Die Felder Ressourcentyp und Messwert bestimmen den im Diagramm dargestellten Messwert. Sie können diese Felder in beliebiger Reihenfolge ausfüllen. In beiden Feldern können Sie Werte eingeben oder Einträge aus dem Menü auswählen:

  • Um die Anzahl der in einem Menü angezeigten Optionen zu reduzieren, geben Sie einen Wert in die Filterleiste ein. Wenn Sie beispielsweise cpu eingeben, werden im Menü nur Einträge aufgeführt, die cpu enthalten. Anhand eines Tests, bei dem die Groß- und Kleinschreibung nicht berücksichtigt wird, wird ermittelt, ob ein Eintrag aufgeführt ist.

  • Wenn Sie weitere Informationen zu einem Eintrag erhalten möchten, platzieren Sie den Mauszeiger auf dem Eintrag, um die Kurzinfo zu aktivieren.

  • Informationen zum Aufrufen eines Monitoring-Filters finden Sie unter Direktfiltermodus.

Nachdem der Ressourcentyp und der Messwert ausgewählt wurden, werden im Diagramm alle verfügbaren Zeitachsen für dieses Paar angezeigt. Der folgende Screenshot zeigt ein Diagramm, nachdem der Ressourcentyp und der Messwert ausgewählt wurden:

Grafik: Diagramm mit ausgewähltem Messwert

Dieses Diagramm enthält mehr Daten, als angezeigt werden können. Die Anzahl anzeigbarer Zeilen in Diagrammen ist auf 300 begrenzt. Das Diagramm gibt einen Hinweis, dass zu viele Daten zum Anzeigen vorhanden sind, und schlägt vor, den Ausreißermodus zu verwenden, der die anzuzeigende Datenmenge stark reduziert. Klicken Sie auf Einstellungen, um die Ausreißermodus-Steuerelemente aufzurufen. Weitere Informationen finden Sie unter Ansichtsoptionen festlegen.

Sie können auch die Filter- und Aggregationsoptionen verwenden, um die Menge der im Diagramm dargestellten Daten zu reduzieren. Durch diese Techniken werden die Diagramme für Diagnosen und Analysen nützlicher und die Leistung und Reaktionsfähigkeit der Benutzeroberfläche selbst wird erhöht.

Direkter Filtermodus

Im Direktfiltermodus können Sie einen Ausdruck eingeben, mit dem Monitoring die zu überwachende Zeitachse identifiziert. Die Ausdrücke, die Sie im direkten Filtermodus eingeben, werden manchmal als Messwertfilter oder Monitoring-Filter bezeichnet. Der folgende Ausdruck zeigt einen Ausdruck, der dazu führt, dass Monitoring die Logeinträge für alle Google Cloud-VM-Instanzen in der Zone us-east1-b anzeigt:

metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance"
resource.label."zone"="us-east1-b"

Der direkte Filtermodus ist nützlich, wenn Sie die richtige Syntax für einen API-Aufruf ermitteln oder prüfen möchten, ob ein Monitoring-Filter ordnungsgemäß formatiert ist. Es ist auch nützlich, wenn Sie Daten grafisch darstellen möchten, die die Ressource und das Messwertmodell nicht darstellen können. Der folgende Ausdruck führt beispielsweise zu einem Diagramm, in dem die Anzahl der Prozesse angezeigt wird, deren Name nginx enthält:

select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
resource.type="gce_instance"

Informationen zur Syntax finden Sie unter Prozessintegritätsfilter und SLO-Daten abrufen. Allgemeine Informationen finden Sie unter Monitoring-Filter.

So rufen Sie einen Monitoring-Filter auf:

  1. Maximieren Sie das Menü Ressourcentyp und wählen Sie Direkter Filtermodus aus.
  2. Geben Sie einen Monitoring-Filterausdruck in das Textfeld ein.

    Das Textfeld enthält den Ressourcentyp, den Messwert und die Filtereinstellung, die Sie vor der Änderung in den direkten Filtermodus vorgenommen haben.

    Wenn Sie im Direktfiltermodus Diagramme oder Benachrichtigungsrichtlinien konfiguriert haben und keine Daten verfügbar sind, wird im Diagramm eine Fehlermeldung angezeigt. Die genaue Fehlermeldung hängt vom eingegebenen Filter ab. Eine typische Meldung wäre beispielsweise Chart definition invalid. Unter Umständen wird auch die Meldung No data is available for the selected timeframe. angezeigt.

Um zur menügesteuerten Benutzeroberfläche zurückzukehren, klicken Sie auf Standardmodus.

Diagrammdaten filtern

Um die Menge der zu erfassenden Daten zu reduzieren geben Sie Filterkriterien an, nutzen die Aggregation oder verwenden den Ausreißermodus. Filter stellen sicher, dass nur Zeitachsen verwendet werden, die bestimmte Kriterien erfüllen. Wenn Sie Filter anwenden, enthält das Diagramm weniger Linien, was die Leistung des Diagramms verbessern kann.

Wenn Sie mehrere Filterkriterien angeben, zeigt das entsprechende Diagramm nur die Zeitachsen, die alle Kriterien erfüllen, ein logisches AND. Typischerweise können Sie nach Ressourcengruppe, Name, Ressourcenlabel, Zone und Messwertlabel filtern.

Wenn Sie einen Filter auf dem Tab MQL hinzufügen möchten, geben Sie ihn im Abfrageeditor an.

Wenn Sie auf dem Tab Konfiguration einen Filter hinzufügen möchten, klicken Sie auf Filter hinzufügen und geben Sie dann das Filterlabel, den Vergleich und den Wert oder Bereich an. Werte:

  1. Klicken Sie auf Label und wählen Sie einen Eintrag aus dem Menü aus.

    Zur Suche nach einem bestimmten Label können Sie die Bildlaufleiste verwenden oder Text in den Textbereich Filter eingeben. Wenn Sie Text eingeben, werden im Menü nur die Einträge angezeigt, die den eingegebenen Text enthalten.

    Folgender Screenshot zeigt die bekannten Labels, nach denen ein bestimmter Messwert gefiltert werden kann:

    Beispiel für eine Liste mit Filterlabels.

  2. Klicken Sie auf Vergleich und wählen Sie einen Eintrag aus dem Menü aus. Sie können zwischen vier Operatoren wählen: Gleichheitsoperatoren (=), Gleichheitszeichen (gleich), !=, Übereinstimmung mit regulärem Ausdruck, =~ und regulärer Ausdruck stimmt nicht überein (!=~):

    Liste der Vergleichsoperatoren im Filter.

  3. Klicken Sie auf Wert und führen Sie einen der folgenden Schritte aus:

    • Wenn Sie einen direkten Vergleich ausgewählt haben, wählen Sie = oder != aus dem Menü aus oder geben Sie einen Wert ein und klicken Sie auf Fertig. Die eingegebenen Werte können einfache Werte wie us-central1-a sein oder Sie können einen Filterstring erstellen, der mit starts_with oder ends_with beginnt. Zum Aufrufen von Daten für eine beliebige us-central1-Zone können Sie beispielsweise den Filterstring starts_with("us-central1") eingeben. Weitere Informationen zu Filterstrings finden Sie unter Monitoring-Filter.

      Da die Menüeinträge aus der empfangenen Zeitachse abgeleitet werden, müssen Sie einen Wert für das Label eingeben, wenn eine überwachte Ressource keine Daten für den ausgewählten Messwert generiert.

      Folgender Screenshot zeigt das Wertemenü, das für ein Projekt angezeigt wird, wenn das Ressourcenlabel zone ausgewählt wird:

      Beispiel für eine Liste mit Filterlabels.

    • Wenn Sie einen Vergleich mit einem regulären Ausdruck ausgewählt haben, =~ oder !=~, geben Sie einen regulären Ausdruck RE2 in das Feld Wert ein und klicken Sie auf Fertig. Beispielsweise entspricht der reguläre Ausdruck us-central1-.* allen us-central1-Zonen.

      Für jede US-Zone, die mit "a" endet, können Sie den regulären Ausdruck ^us.*.a$ verwenden.

      Mit regulären Ausdrücken können Sie das Ressourcenlabel project_id nicht filtern.

      Beispiel: Wenn Sie nur die Zeitachsen aus einer der us-central1-Zonen aufrufen möchten, wenden Sie einen der Filter zone="starts_with("us-central1")" oder zone=~"us-central1.*" an:

      Grafik: Gefilterte Zeitachse

Sie können mehrere Filterkriterien angeben und dasselbe Label mehrmals verwenden. Mit diesen Funktionen können Sie einen Filter für einen Wertebereich angeben. Alle Filterkriterien müssen erfüllt sein sie bilden ein logisches AND. Bei folgender Konfiguration können Sie beispielsweise die Filterstrings starts_with und ends_with verwenden, um nur „a“-Zonen in den USA aufzurufen:

Beispiel mit mehreren Filtern.

Legen Sie fest, wie Diagrammdaten angezeigt werden sollen

In diesem Abschnitt wird gezeigt, wie die ausgewählten Daten durch Festlegen der Aggregationsfelder angezeigt werden können. Bei der Aggregation werden Datenpunkte innerhalb einer Zeitachse ausgerichtet und verschiedene Zeitachsen miteinander kombiniert. Eine ausführliche Erläuterung der Aggregation finden Sie unter Filtern und Aggregation: Zeitachsen bearbeiten.

Zeitachsenreihen gruppieren

Sie können die für einen Messwert zurückgegebene Datenmenge reduzieren. Dazu kombinieren Sie verschiedene Zeitachsen. Um mehrere Zeitachsen zu kombinieren, geben Sie in der Regel eine Gruppierung und eine Funktion an. Die Gruppierung erfolgt nach Labelwerten. Die Funktion definiert, wie alle Zeitachsendaten innerhalb einer Gruppe zu einer neuen Zeitachse kombiniert werden.

Klicken Sie zum Hinzufügen einer Gruppierung auf den Text im Textfeld Gruppieren nach und treffen Sie dann eine Auswahl aus dem Menü. Das Menü wird dynamisch anhand der Zeitachsendaten der Ressource und des Messwerts erstellt, die Sie ausgewählt haben. Für Gruppierung und Filterung werden dieselben Labels verwendet.

Wenn Sie das erste Label hinzufügen, geschieht Folgendes:

  • Ein Aggregator ist ausgewählt. Die Art der angezeigten Daten bestimmt den Standard-Aggregator. Sie können diese Funktion jedoch ändern.
  • Der Aggregator bestimmt, wie die Zeitachsen mit demselben Labelwert in einer einzelnen Zeitachse kombiniert werden.
  • Das Diagramm zeigt für jeden Wert des Labels, der im Textfeld Gruppieren nach aufgelistet ist, eine Zeitachse an.

Wenn Sie nach mehreren Labels gruppieren, kombiniert der Aggregator die Zeitachsen, die denselben Wert für die angegebenen Labels haben.

Wenn Sie keine Gruppierungsoption angeben, sondern einen Aggregator, wird diese Funktion auf alle ausgewählten Zeitachsen angewendet und führt zu einer einzelnen Zeitachse.

Wenn das Feld Gruppieren nach beispielsweise auf user_labels.version und der Aggregator auf sum festgelegt ist, gibt es eine Zeitachse für jeden Wert der Label user_labels.version. Die Datenpunkte in jeder Zeitachse werden aus der Summe aller Werte für einzelne Zeitachsen für eine bestimmte Version berechnet:

Zeitachsen werden gruppiert nach user_labels.version angezeigt

Sie können nach mehreren Labels gruppieren. Wenn Sie mehrere Gruppierungsoptionen haben, wird der Aggregator auf die Zeitachse mit denselben Werten für die ausgewählten Labels angewendet.

Das resultierende Diagramm zeigt eine Zeitachse für jede Kombination von Labelwerten an. Die Reihenfolge, in der Sie die Labels angeben, spielt keine Rolle.

Der folgende Screenshot zeigt beispielsweise die Gruppierung nach user_labels.version und system_labels.machine_image:

Zeitachsen werden nach Version und Maschinen-Image gruppiert angezeigt.

Wie Sie sehen, erhalten Sie bei einer Gruppierung nach beiden Labels eine Zeitachse für jedes Wertepaar. Die Tatsache, dass Sie für jede Labelkombination eine Zeitachse erhalten, bedeutet, dass mit dieser Technik problemlos mehr Daten erstellt werden können, als Sie in einem einzelnen Diagramm verwenden können.

Wenn Sie eine Gruppierung angeben oder einen Aggregator auswählen, enthält die in einem Diagramm dargestellte Zeitachse nur die Labels, die obligatorisch sind, z. B. die Projekt-ID, und die von der Gruppierung angegebenen Labels.

"Gruppieren nach"-Bedingungen entfernen

Gehen Sie wie folgt vor, um eine Bedingung "Gruppieren nach" zu entfernen:

  1. Die Labels "Gruppieren nach" entfernen.
  2. Legen Sie den Aggregator auf none fest.

Zeitachsen ausrichten

Bei der Ausrichtung werden die von Monitoring empfangenen Zeitachsendaten in eine neue Zeitachse umgewandelt, die Datenpunkte in festen Intervallen enthält. Der Ausrichtungsprozess besteht aus dem Erfassen aller Datenpunkte, die innerhalb eines festgelegten Zeitraums empfangen wurden, einer Funktion zum Kombinieren dieser Datenpunkte und dem Zuweisen eines Zeitstempels zum Ergebnis. Diese Kombinationsfunktion kann den Durchschnitt aller Stichproben berechnen oder das Maximum aller Stichproben extrahieren.

Der Ausrichtungszeitraum gibt das Mindestintervall an, das beim Ausrichten von Zeitachsendaten verwendet werden soll. Sind im ausgewählten Anzeigezeitraum zu viele Datenpunkte für das Diagramm vorhanden, so wird der Ausrichtungszeitraum automatisch erhöht, sodass alle Datenpunkte dargestellt werden können. Die Standardeinstellung für dieses Feld ist eine Minute.

Stellen Sie sich beispielsweise einen Messwert mit einem Stichprobenzeitraum von einer Minute vor. Wenn ein Diagramm so konfiguriert ist, dass Daten aus einer Stunde angezeigt werden, kann das Diagramm alle 60 Datenpunkte anzeigen. Wenn der Ausrichtungszeitraum auf 10 minutes festgelegt ist, zeigt das Diagramm sechs Datenpunkte an. Wenn Sie das Diagramm jedoch so konfigurieren, dass Daten aus einer Woche angezeigt werden, sind zu viele Punkte für die Anzeige im Diagramm vorhanden und der Zeitraum wird automatisch angepasst. In diesem Beispiel beträgt der geänderte Ausrichtungszeitraum eine Stunde.

Aligner: Das Alignerfeld gibt die Funktion an, mit der alle Datenpunkte in einem Ausrichtungszeitraum kombiniert werden. Die meisten Aligner führen gängige mathematische Funktionen aus. Wenn Sie beispielsweise min auswählen, ist der ausgerichtete Datenpunkt das Minimum aller Datenpunkte innerhalb des Ausrichtungszeitraums. Einige Aligner führen komplexere Aktionen aus:

  • next old: Wenn Sie nur die neueste Stichprobe innerhalb eines Ausrichtungszeitraums speichern möchten, verwenden Sie den Aligner next older. Dieser Aligner wird häufig für Verfügbarkeitsdiagnosen genutzt und ist eine gute Wahl, wenn Sie nur den neuesten Wert berücksichtigen möchten.

    Der Aligner ist nur für absolute Messwerte verfügbar.

  • percentile: Um einen Verteilungsmesswert in einem Liniendiagramm, in einem gestapelten Flächendiagramm oder in einem gestapelten Balkendiagramm darzustellen, müssen Sie festlegen, welches Perzentil in der Verteilung angezeigt werden soll. Eine Möglichkeit dafür ist die Auswahl eines Perzentil-Aligners. Sie können das 5., 50., 95. und 99. Perzentil auswählen. Der ausgerichtete Datenpunkt wird durch Berechnen des angegebenen Perzentils mithilfe aller Datenpunkte im Ausrichtungszeitraum bestimmt.

    Dieser Aligner ist nur für absolute und Deltamesswerte gültig, wenn sie einen Verteilungsdatentyp haben.

  • delta:: Verwenden Sie diesen Aligner, um einen kumulativen Messwert oder einen Deltamesswert in einen Deltamesswert mit einer Stichprobe pro Ausrichtungszeitraum umzuwandeln. Dieser Aligner kann zu einer Dateninterpolation führen. Ein Beispiel finden Sie unter Arten, Typen und Umwandlungen.

    Dieser Aligner ist nur für kumulative und Deltamesswerte verfügbar.

  • rate: Mit diesem Aligner können Sie einen kumulativen oder Deltamesswert in einen absoluten Messwert umwandeln. Mit diesem Aligner wird die Zeitachse mit einem Delta-Aligner transformiert und die Einheiten werden dann durch den Ausrichtungszeitraum geteilt. Wenn die Einheit der ursprünglichen Zeitachse beispielsweise MiB ist und die Einheit des Ausrichtungszeitraums an zweiter Stelle ist, enthält das Diagramm eine Einheit von MiB/Sekunde. Weitere Informationen finden Sie unter Arten, Typen und Umwandlungen.

    Dieser Aligner ist nur für kumulative und Deltamesswerte verfügbar.

Weitere Informationen zu den verfügbaren Alignern finden Sie unter Aligner in der API-Referenz.

Um die Ausrichtungsfunktion aufzurufen oder zu ändern, klicken Sie auf Erweiterte Optionen einblenden.

Der folgende Screenshot zeigt die CPU-Auslastung der Compute Engine-VM-Instanzen in einem bestimmten Google Cloud-Projekt. In diesem Bild haben die Ausrichtungsfelder die Standardwerte. Die Ausrichtungsfunktion ist auf mean und der Ausrichtungszeitraum auf 1 minute festgelegt:

Grafik: CPU-Auslastung von VM-Instanzen mit Standardausrichtungseinstellungen

Der folgende Screenshot zeigt zum Beispiel, wie sich die Änderung des Zeitraums von 1 minute auf 5 minutes auswirkt:

CPU-Auslastung von VM-Instanzen unter Verwendung eines Standardausrichtungszeitraum von 5 Minuten

Wird der Zeitraum erhöht, so enthält das resultierende Diagramm weniger Punkte. Genauer werden aus den 60 Punkten pro Zeitachse 10 Punkte pro Zeitachse. Um die einzelnen Punkte im Diagramm zu berechnen werden die Zeitachsenwerte im Ausrichtungszeitraum gemittelt. Durch Erhöhen des Ausrichtungszeitraums werden mehr Punkte gemittelt, was eine ausgeglichene Wirkung auf die dargestellten Daten zur Folge hat.

Sekundäre Aggregation

Wenn Sie mehrere Zeitachsen haben, die bereits Aggregationen darstellen, können Sie alle Zeitachsen im Diagramm auf eine einzelne Zeitachse reduzieren, indem Sie einen sekundären Aggregator auswählen. Wenn Sie beispielsweise Daten nach Zone gruppieren, zeigt Ihr Diagramm eine Zeitachse für jede Zone. Verwenden Sie die sekundären Aggregationsfelder, um ein Diagramm mit einer einzelnen Zeitachse zu erstellen.

Klicken Sie auf Erweiterte Optionen einblenden, um die Einstellungen für die sekundäre Aggregation aufzurufen oder zu ändern.

Der folgende Screenshot zeigt mehrere Zeitachsen, die sich aus der Gruppierung eines gefilterten Datasets ergeben. Gruppierung benötigt eine Aggregation. Jede Liniengruppe wird zu einer zusammengefasst. Der folgende Screenshot zeigt Zeitachsen, die nach Zonen gruppiert sind:

Grafik: Gefilterte Zeitreihe nach Zone gruppiert

Der folgende Screenshot zeigt das Ergebnis, wenn mit sekundärer Aggregation der Mittelwert über die gruppierte Zeitachse ermittelt wurde:

Grafik: Sekundäre Aggregation, die auf das vorherige Beispiel angewendet wurde

Legendenvorlage

Im Feld Legend Template (Legendenvorlage) können Sie die Beschreibungen für die Zeitachsen im Diagramm anpassen. Diese Beschreibungen werden in der Kurzinfo für das Diagramm und in der Diagrammlegende in der Spalte Name angezeigt. Standardmäßig werden die Beschreibungen in der Legende aus den Werten verschiedener Labels in Ihrer Zeitachse erstellt. Da das System die Labels auswählt, sind die Ergebnisse für Sie möglicherweise nicht hilfreich. Mit diesem Feld können Sie eine Vorlage für die Beschreibungen erstellen.

Wenn Sie auf die Legendenvorlage für ein Diagramm zugreifen möchten, wählen Sie in der Cloud Console im Konfigurationsbereich des Diagramms den Tab Advanced (Erweitert) aus. Die Legendenvorlage finden Sie unter Weitere Optionen.

In das Feld Legendenvorlage können Sie nur Text und Vorlagen eingeben. Wenn Sie eine Vorlage hinzufügen, fügen Sie einen Ausdruck hinzu, der ausgewertet wird, wenn die Legende angezeigt wird.

So fügen Sie einen Filter hinzu:

  • Klicken Sie auf Vorlage einfügen.
  • Wählen Sie im Menü einen Eintrag aus. Nachdem Sie einen Eintrag ausgewählt haben, wird automatisch eine Vorlage hinzugefügt. Wenn Sie beispielsweise response_code auswählen, wird die Vorlage ${resource.labels.zone} hinzugefügt.

Der folgende Screenshot zeigt beispielsweise eine Legendenvorlage, die nur Text und den Ausdruck ${resource.labels.zone} enthält:

Vorlage für eine einfache Beschreibung

In der Diagrammlegende werden die aus der Vorlage generierten Werte in einer Spalte mit der Überschrift Name und im Kurzprofil angezeigt:

Aus einer Vorlage generierte Beschreibungen

Sie können die Legendenvorlage so konfigurieren, dass sie mehrere Textstrings und Vorlagen enthält. Der verfügbare Platz der Kurzinfo ist jedoch begrenzt.

Nächste Schritte