Zielmesswert konfigurieren

Auf dieser Seite wird beschrieben, wie Sie mit dem Messwertauswahltool einen Zielmesswert für eine Benachrichtigungsrichtlinie angeben. Einige der verlinkten Ressourcen sind ggf. nur auf Englisch verfügbar. Im Diagramm neben dem Bereich Ziel sehen Sie, welche Daten vom Ziel erfasst werden.

Im Bereich Ziel wird dieselbe Messwertauswahlfunktion wie im Messwert-Explorer und zum Erstellen von Diagrammen verwendet. Wenn Sie damit bereits vertraut sind, können Sie diese Seite überspringen.

Messwert auswählen

Einen Messwert wählen Sie im Feld Find resource type and metric (Ressourcentyp und Messwert suchen) anhand eines Ressourcentyps und eines Messwerttyps aus. Sie können sie in beliebiger Reihenfolge angeben. Klicken Sie auf das Feld, um zu beginnen. Dies ruft je nach vorheriger Auswahl eine oder zwei Listen auf. Die Listen werden unter zwei Überschriften, Resource types (Ressourcentypen) und Metrics (Messwerte), angezeigt. Das ist im folgenden Screenshot dargestellt:

Suchlisten zum Auswählen von Messwerten und Ressourcen

Sie können einen Eintrag auf zwei Arten auswählen:

  • Durch Auswahl von Einträgen aus den Listen

  • Durch Eingabe eines Messwertfilters So geben Sie einen Messwertfilter ein:

    1. Klicken Sie neben Find resource type and metric auf Help .
    2. Klicken Sie im Hilfebereich auf Direct filter mode (Direktfiltermodus).

      Wenn der Direct filter mode (Direktfiltermodus) aktiviert ist, wird die Option Find resource type and metric (Ressourcentyp und Messwert finden) durch ein bearbeitbares Textfeld mit der Bezeichnung Resource type, metric, and filter (Ressourcentyp, Messwert und Filter) ersetzt:

      Der direkte Filtermodus wird angezeigt.

      Wenn Sie für den Ressourcentyp, den Messwert oder den Filter eine Auswahl getroffen haben, bevor Sie den Direct filter mode (Direktfiltermodus) aktiviert haben, werden diese Einstellungen verwendet, um das Textfeld Resource type, metric, and filter (Ressourcentyp, Messwert und Filter) vorab zu befüllen.

    3. Geben Sie im Textfeld Resource type, metric, and filter (Ressourcentyp, Messwert und Filter) einen Messwertfilter ein. Der Filter muss einen Messwerttyp und einen Ressourcentyp enthalten. Sie können auch Labelfilter hinzufügen. Die Filtergrammatik finden Sie unter Monitoring-Filter.

      Wenn Sie beispielsweise die Logeinträge für alle Google Cloud-VM-Instanzen in der Zone us-east1-b aufrufen möchten, geben Sie Folgendes ein:

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

      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 time frame. angezeigt.

Wenn Sie den Mauszeiger über ein Objekt in einer der Listen bewegen, wird eine Kurzinfo angezeigt, in der die Informationen im Deskriptor des Objekts angezeigt werden. Informationen zu Deskriptoren für Messwerttypen oder überwachte Ressourcen finden Sie in der Liste der Messwerte oder der Liste der überwachten Ressourcen.

Wenn mindestens ein Ressourcentyp- und Messwertpaar ausgewählt wird, zeigt das Diagramm alle verfügbaren Zeitachsen. Auf dem Tab Messwert werden unterhalb des angegebenen Messwertes die zusätzlichen Elemente angezeigt. Der folgende Screenshot zeigt den Tab Metric (Messwert), nachdem ein Messwert angegeben wurde:

Zusätzliche Auswahlmöglichkeiten anzeigen

Filtern

Durch die Angabe von Filterkriterien können Sie die Menge der zurückgegebenen Daten für einen Messwert reduzieren. So werden nur Zeitachsen verwendet, die bestimmte Kriterien erfüllen. Wenn Sie Filter anwenden, enthält das Diagramm weniger Linien, was die Leistung des Diagramms verbessern kann.

Sie können mehrere Filterkriterien angeben. Das entsprechende Diagramm enthält nur die Zeitachsen, die alle Kriterien erfüllen. Dies entspricht einem logischen AND.

Klicken Sie in der Google Cloud Console auf das Feld Filter, um einen Filter hinzuzufügen. Daraufhin wird ein Bereich mit Kriterienlisten geöffnet, nach denen Sie filtern können. Sie können beispielsweise nach Ressourcengruppe, Name, Ressourcenlabel, Zone und Messwertlabel filtern.

Der folgende Screenshot zeigt die bekannten Labels, nach denen ein Projekt gefiltert werden kann:

Listen voreingestellter Filterlabels

Sie können sie aus den Listen auswählen oder manuell eingeben, um Übereinstimmungen zu finden. Darüber hinaus können Sie Filter für Daten erstellen, die noch nicht angezeigt wurden. Solche Filterkriterien werden nicht in der Auswahlliste angezeigt. Sie können jedoch manuell Filter angeben, von denen Sie wissen, dass sie in Zukunft gültig sind.

Nachdem Sie ein Label ausgewählt haben, das gefiltert werden soll, müssen Sie den Rest des Filters angeben: einen Wert oder Wertebereich sowie einen Vergleich.

Der folgende Screenshot zeigt beispielsweise einen Filter für das Ressourcenlabel zone. Das Feld Filter unterstützt ein Vergleichsoperatorpaar für Gleichheit, = und =~, und ein Paar für Ungleichheit, != und !=~. Das zweite Element in jedem Paar übernimmt einen regulären Ausdruck als Wert. Die einfache Gleichheit (=) ist die Standardeinstellung.

Vergleichsoperatoren im Filter

Unter der Liste der Vergleichsoperatoren gibt es eine Liste der verfügbaren Werte. Im folgenden Screenshot sind die Namen der Zonen im Projekt zu sehen:

Einige voreingestellte Filterwerte

Im Feld Value (Wert) können Sie eins der Elemente aus der Drop-down-Liste auswählen oder einen Ausdruck eingeben, der mit mehreren Elementen übereinstimmt:

  • Wenn Sie einen direkten Vergleich verwenden (= oder !=), können Sie einen Filterstring wie starts_with erstellen. Der Filterstring starts_with("us-central") stimmt beispielsweise mit der Zone us-central überein:

    Filterstring verwenden

    Weitere Informationen zu Filterstrings finden Sie unter Monitoring-Filter.

  • Wenn Sie =~ oder !=~ auswählen, können Sie einen regulären Ausdruck vom Typ RE2 im Wert verwenden. Der reguläre Ausdruck us-central1-.* stimmt beispielsweise mit allen us-central1-Zonen überein:

    Mit regulären Ausdrücken filtern

    Der reguläre Ausdruck ^us.*.a$ stimmt mit jeder US-Zone überein, die auf "a" endet.

    Mit weiteren regulären Ausdrücken filtern

Sie können mehrere Filterkriterien angeben und dasselbe Label mehrmals verwenden. Auf diese Weise können Sie einen Filter für einen Wertebereich angeben. Klicken Sie unten im Filterfeld auf Add a filter (Filter hinzufügen), um weitere Filter hinzuzufügen. Derzeit müssen alle Filterkriterien erfüllt sein. Sie bilden ein logisches AND. Beispielsweise können Sie die Filterstrings starts_with und ends_with zusammen verwenden, um nur die "a"-Zonen in den USA aufzurufen:

Mehrere Filter verwenden

Aggregation

Nach Auswahl der Zeitachsen werden im nächsten Schritt die Aggregationsoptionen angegeben. Die Aggregation besteht aus der Ausrichtung einzelner Zeitachsen und der Kombination der ausgerichteten Zeitachsen. Eine ausführliche Erläuterung der Aggregation finden Sie unter Filtern und Aggregation: Zeitachsen bearbeiten.

Daten ausrichten

Bei der Ausrichtung werden von Monitoring empfangenen Zeitachsendaten in eine neue Zeitachse konvertiert, bei der die Datenpunkte über einen festen Zeitraum verteilt sind. Es werden alle Datenpunkte erfasst, die in einem Intervall einer festen Länge empfangen wurden, mithilfe einer Funktion kombiniert und dem Ergebnis ein Zeitstempel zugewiesen. Diese Kombinationsfunktion kann den Durchschnitt aller Stichproben berechnen oder das Maximum aller Stichproben extrahieren. Eine allgemeine Beschreibung der Ausrichtung finden Sie unter Ausrichtung: Regularisierung innerhalb der Reihe.

Wenn Sie eine Bedingung für eine Benachrichtigungsrichtlinie erstellen, müssen Sie die Ausrichtungsparameter angeben. Wenn Sie die Google Cloud Console verwenden, nachdem Sie den Ressourcentyp und den Messwert in der Benachrichtigungsbedingung ausgewählt haben, werden mehrere zusätzliche Felder und eine Schaltfläche mit dem Titel Erweiterte Optionen einblenden angezeigt:

Grafik: Anzeige des Zeitraumfelds.

Zeitraum: Der Zeitraum ist ein Back-End-Intervall eines bestimmten Zeitpunkts. Wenn der Zeitraum beispielsweise fünf Minuten beträgt, werden um 13:00 Uhr die Proben ausgerichtet, die zwischen 12:55 Uhr und 13:00 Uhr eingegangen sind. Um 13:01 Uhr werden die Proben, die zwischen 12:56 Uhr und 13:01 Uhr empfangen werden, ausgerichtet. Bei Benachrichtigungsrichtlinien kann der Ausrichtungszeitraum als gleitendes Fenster angezeigt werden, das in der Vergangenheit liegt. Weitere Diskussionen zu diesem Feld finden Sie unter Ausrichtungszeitraum und Dauer.

Klicken Sie auf Erweiterte Optionen anzeigen, um die verbleibenden Aggregationsoptionen aufzurufen:

Grafik: Anzeige der erweiterten Optionen.

Aligner: Aligner gibt die Funktion an, die zum Kombinieren aller Datenpunkte in einem Ausrichtungszeitraum verwendet wird. Weitere Informationen zu den verfügbaren Alignern finden Sie unter Aligner in der API-Referenz. Mit einigen Alignern werden die Daten ausgerichtet und von einer Messwertart oder einem -typ in eine andere oder einen anderen konvertiert. Eine ausführliche Erläuterung finden Sie unter Arten, Typen und Conversions.

Zeitachsen kombinieren

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. Das Gruppieren erfolgt aufgrund von Labels. Mit der Funktion, die in der Google Cloud Console als Aggregator bezeichnet wird, werden die Zeitachsen in der Gruppe in einer einzigen Zeitachse kombiniert. Typische Aggregatoren sind Mittelwert, Maximum, Minimum, Standardabweichung und verschiedene Perzentilwerte.

Klicken Sie zum Hinzufügen einer Gruppierung im Textfeld Gruppieren nach auf Label hinzufügen und treffen Sie eine Auswahl im Menü. Das Menü wird dynamisch erstellt und zeigt die verfügbaren Labels an. Dies sind dieselben Labels, die Sie zum Filtern verwenden können. Wenn Sie die erste Gruppierungsoption hinzufügen, geschieht Folgendes:

  • Ein Aggregator ist ausgewählt. Die ausgewählte Funktion wird durch den angezeigten Datentyp bestimmt. Sie können diese Funktion jedoch ändern.
  • Der Aggregator kombiniert alle Zeitachsen mit demselben Labelwert zu einer einzigen Zeitachse.
  • Im Diagramm wird für jeden Wert des Labels "Gruppieren nach" eine Zeitachse angezeigt.

Der folgende Screenshot zeigt eine Gruppierung nach user_labels.version, wobei für Aggregator der Standardwert sum festgelegt ist:

Beispiel für eine Gruppierungseinstellung

Diese Auswahl ergibt eine Zeitachse für jeden Wert von 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, werden Zeitachsen nach jeder Kombination von Labelwerten gruppiert und der Aggregator wird auf jede Gruppe 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 keine Gruppierungsoption und keinen Aggregator angeben, wird der Aggregator auf alle ausgewählten Zeitachsen angewendet und führt zu einer einzigen Zeitachse. Dieses Verhalten ist im folgenden Screenshot dargestellt:

Zeitachsen werden nach Summe, aber ohne Gruppierung angezeigt

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

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.

Sekundäre Aggregation

Wenn Sie mehrere Zeitachsen haben, die bereits Aggregationen darstellen, wie die Beispiele, die die Group By-Option (Gruppieren nach) veranschaulichen, können Sie sie durch Auswählen eines Secondary Aggregator (Sekundärer Aggregator) aggregieren:

Feld für sekundäre Aggregation

Durch die sekundäre Aggregation werden alle Zeitachsen im Diagramm auf eine einzige Zeitachse reduziert.

Legendenvorlage

Wenn Sie in der Cloud Console die Aggregationsoptionen durch Klicken auf Erweiterte Optionen anzeigen erweitern, werden zusätzlich zur Anzeige von Feldern für den Aligner, den Ausrichtungszeitraum und den sekundären Aggregator, eine Legendenvorlage angezeigt.

Grafik: Platzierung des Felds der 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.

In das Feld Legend Template (Legendenvorlage) können Sie Folgendes eingeben:

  • Filter, die auf Labels in Ihrer Zeitachse verweisen. Klicken Sie auf Filter hinzufügen, um alle für die Zeitachse verfügbaren Filter aufzurufen. Nachdem Sie einen Filter ausgewählt haben, wird er dem Textfeld hinzugefügt und als Ausdruck wie ${resource.labels.zone} dargestellt. Wenn der Ausdruck ausgewertet wird, wird der Wert aus den Labels einer Zeitachse abgerufen und in die Legende eingefügt.

  • Nur Text Wenn Sie nur Text angeben, sind die Beschreibungen der Zeitachsen im Diagramm identisch. Sie können jedoch Text und Filter kombinieren.

Der folgende Screenshot zeigt beispielsweise eine Vorlage, die aus einem Nur-Text-String und dem Filterausdruck ${resource.labels.zone} besteht:

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 Vorlagen mit mehreren Strings und Filtern erstellen. Der verfügbare Platz auf der Kurzinfo ist jedoch begrenzt.