Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

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

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.

Geben Sie mehrere Filterkriterien an, so zeigt das entsprechende Diagramm 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.

Folgender Screenshot zeigt die bekannten Labels, nach denen ein bestimmter Messwert 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.

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

Beispiel für 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:

    Beispiel für die Verwendung eines Filterstrings.

    Weitere Informationen zu Filterstrings finden Sie unter Monitoring-Filter.

  • Wenn Sie =~ oder !=~ auswählen, geben Sie einen regulären Ausdruck RE2 als Wert ein. Der reguläre Ausdruck us-central1-.* stimmt beispielsweise mit allen us-central1-Zonen überein:

    Beispiel für das Filtern mit regulären Ausdrücken.

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

    Beispiel für das Filtern nach Zonen mithilfe von regulären Ausdrücken.

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:

Beispiel mit mehreren Filtern.

Wenn ein zone="starts_with("asia-east1")"- oder zone=~"asia-east1.*"-Filter aktiviert ist, wird nur die Zeitachse mit Daten aus einer der asia-east1-Zonen angezeigt:

Grafik: Gefilterte Zeitachse

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. Die Gruppierung erfolgt nach Labelwerten. Die Funktion definiert, wie alle Zeitachsen innerhalb einer Gruppe in einer neuen Zeitachse zusammengefasst 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 von Ihnen gewählten Ressourcen-/Messwertkombination erstellt. Für Gruppierung und Filterung werden dieselben Labels verwendet.

Wenn Sie das erste Label 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 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 und einen Aggregator angeben, wird diese Funktion auf alle ausgewählten Zeitachsen angewendet und führt zu einer einzigen Zeitachse.

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

Gehen Sie so 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

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

Sie können im Feld Legendenvorlage 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 eine Vorlage hinzu:

  • Klicken Sie auf Vorlage einfügen.
  • Wählen Sie einen Eintrag aus dem Menü 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 Klartext 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 auf der Kurzinfo verfügbare Anzeigebereich ist jedoch begrenzt.