Zielmesswert konfigurieren

Auf dieser Seite wird beschrieben, wie Sie mit dem Tool zur Messwertauswahl 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 Funktion zur Messwertauswahl wie im Metrics 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 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. Daraufhin werden je nach vorheriger Auswahl eine oder zwei Listen aufgeführt. Die Listen werden unter zwei Überschriften, Ressourcentypen und Messwerte, angezeigt. Dies 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 Ressourcentyp und Messwert suchen auf Hilfe .
    2. Klicken Sie im Hilfebereich auf Direct filter mode (Direktfiltermodus).

      Wenn der Direktfiltermodus aktiviert ist, wird die Option Ressourcentyp und Messwert finden durch ein bearbeitbares Textfeld mit der Bezeichnung Ressourcentyp, Messwert und Filter ersetzt:

      Der Direktfiltermodus wird angezeigt.

      Wenn Sie für den Ressourcentyp, den Messwert oder den Filter eine Auswahl getroffen haben, bevor Sie den Direktfiltermodus aktiviert haben, werden diese Einstellungen verwendet, um das Textfeld Ressourcentyp, Messwert und Filter vorab auszufüllen.

    3. Geben Sie im Textfeld 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 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. Durch das Filtern werden die Zeitachsen aus dem Diagramm entfernt, die die Filterkriterien nicht erfüllen. Dadurch enthält das Diagramm weniger Linien zur Anzeige des Messwerts, 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.

Wenn Sie das Feld Filter anklicken, wird ein Fenster angezeigt, das Listen mit Kriterien enthält, nach denen Sie filtern können. Sie können im Wesentlichen nach Ressourcengruppe, Name, Ressourcenlabel 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, nach dem 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 Wert können Sie eines 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 im Wert einen regulären Ausdruck 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 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

Gruppierung

Sie können die für einen Messwert zurückgegebene Datenmenge reduzieren. Dazu kombinieren Sie Daten aus ähnlichen Zeitachsen.

Ähnlich wie beim Filtern können Sie durch Gruppieren die Datenmenge reduzieren, die Sie bearbeiten. Beim Filtern werden gewisse Zeitachsen ausgeschlossen. Beim Gruppieren werden dagegen Sets von Zeitachsen identifiziert, die alle ein bestimmtes Kriterium erfüllen, und dann die Mitglieder der Sets kombiniert oder aggregiert.

Das Gruppieren erfolgt aufgrund von Labels. Wenn Sie auf das Feld Gruppieren nach klicken, werden die gleichen Labels angezeigt, die auch zum Filtern zur Verfügung stehen.

Mit der Option Gruppieren nach können Sie Zeitachsen nach Ressourcen- und Messwertlabels gruppieren und dann die Daten innerhalb dieser Gruppen kombinieren. Dadurch wird für jede Kombination von zu gruppierenden Werten eine einzelne neue Zeitachse erstellt; die neuen Zeitachsen repräsentieren dann alle Mitglieder der jeweiligen Gruppe.

Angenommen, Sie möchten die Logging-Auslastung untersuchen, jedoch nur auf regionaler Ebene. Die Anzahl der Einträge von bestimmten Servern ist für Sie also unwichtig. Sie können Zeitachsen nach Zonen gruppieren und anschließend den Gesamt-, Durchschnitts- oder sonstigen Messwert für jede Zone grafisch darstellen.

Wenn Sie die Option Gruppieren nach verwenden, wird auf Basis des Typs der zu gruppierenden Daten eine Standardaggregationsfunktion ausgewählt. Sie können diese Auswahl jedoch ändern. Informationen zu anderen Optionen finden Sie unter Aggregation.

Der folgende Screenshot zeigt eine Gruppierung nach Zonen. Für Aggregator ist die Auswahl sum die Standardeinstellung.

Zeitachsen gruppieren

Das erstellt für jede Zone eine neue Zeitachse mit Werten, die aus der Summe aller Werte für einzelne Zeitachsen in dieser Zone berechnet werden.

Sie können auch nach mehreren Labels gruppieren. Wenn Sie nach mehreren Labels gruppieren, erhalten Sie jeweils eine Zeitachse für jede der Labelkombinationen. Die Reihenfolge, in der Sie die Labels angeben, spielt keine Rolle.

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

  1. Die Labels "Gruppieren nach" entfernen.
  2. Die Aggregationsmethode auf none zurücksetzen.

Aggregation

Mit der Option Aggregator können Sie Zeitachsen mithilfe gängiger Funktionen kombinieren. Dadurch enthält das Diagramm weniger Linien zur Anzeige des Messwerts, was die Leistung des Diagramms verbessern kann.

Klicken Sie auf das Feld Aggregator, um eine Liste der verfügbaren Aggregationsoptionen aufzurufen. Dabei handelt es sich um die Funktionen oder Reduzierer, mit denen die Zeitachsen kombiniert werden können.

Die zur Verfügung stehenden Reduzierungsfunktionen hängen vom Typ der Werte ab, die durch den Messwert erfasst werden. Sie enthalten jedoch häufig Auswahlmöglichkeiten wie den Mittelwert, Max. oder Min., Standardabweichung, verschiedene Perzentilwerte usw. Weitere Informationen zu diesen Abhängigkeiten finden Sie unter Messwerte, Zeitachsen und Ressourcen.

Bei der Verwendung ohne Gruppierung wird die Reduzierungsfunktion auf alle ausgewählten Zeitachsen angewendet und diese werden zu einer einzelnen Zeitachse kombiniert, die aus dem Mittelwert, der Summe oder einem anderen über alle Zeitachsen berechneten Messwert besteht. Bei der Verwendung mit Gruppierung wird die Funktion auf die Zeitachsen in jeder Gruppe angewendet.

Weitere Informationen zur Aggregation finden Sie unter Aggregation in der API-Referenz.

Die Option Gruppieren nach wendet die Aggregation automatisch zur Berechnung von Statistiken innerhalb jeder Gruppe an. Die Linien in einem Gruppieren nach-Diagramm stellen bereits Aggregationen dar. Wenn Sie die Option Gruppieren nach verwenden, wird auf Basis des Typs der zu gruppierenden Daten eine Standardaggregationsfunktion ausgewählt. Sie können diese Auswahl jedoch ändern.

Sie können die Aggregation auch auf ein Set von Zeitachsen anwenden, die Sie gefiltert haben. Wie bei der Aggregation ungefilterter Zeitachsen reduziert die Aggregation gefilterter Zeitachsen alle Linien auf eine Linie, die die gewählte Aggregationsfunktion widerspiegelt, es sei denn, Sie verwenden zusätzlich die Gruppierung.

Es gibt zusätzliche Optionen, um einen Messwert auszuwählen. Diese Optionen haben Standardwerte. Sie können sich diese Optionen aber anzeigen lassen und die Standardwerte überschreiben. Klicken Sie auf Show advanced options (Erweiterte Optionen anzeigen), um sich die zusätzlichen Optionen anzeigen zu lassen.

Ausrichtung

Eine Zeitachse ist ein Satz von Datenpunkten in zeitlicher Reihenfolge. Zum Ausrichten einer Zeitachse müssen die Datenpunkte in regelmäßige Zeiteinheiten aufgeteilt werden, die Ausrichtungsdauer. Es müssen mehrere Zeitachsen ausgerichtet werden, bevor sie kombiniert werden können.

Die Ausrichtung ist eine Voraussetzung für die Aggregation von Zeitachsen. Jede Zeitachse wird einzeln ausgerichtet. Da die Ausrichtung eine Voraussetzung dafür ist, aus den Daten ein Diagramm zu erstellen, führt Monitoring die Ausrichtung anhand der Standardwerte automatisch durch. Sie können diese Standardwerte mithilfe der Ausrichtungsoptionen Aligner und Ausrichtungszeitraum überschreiben:

Ausrichtungsoptionsfelder

Ausrichtungszeitraum: Mit dem Ausrichtungszeitraum bestimmen Sie die Dauer der Zeiträume, die zur Unterteilung der Zeitachsen verwendet werden. Eine Zeitachse kann beispielsweise in einminütige oder einstündige Zeiträume aufgeteilt werden. Die Daten jedes Zeitraums werden so zusammengefasst, dass ein einzelner Wert den Zeitraum darstellt. Der standardmäßige Ausrichtungszeitraum beträgt eine Minute.

Sie können das Ausrichtungsintervall für Ihre Daten zwar festlegen, aber es kann dennoch sein, dass die Zeitachsen neu ausgerichtet werden, wenn Sie das in einem Diagramm angezeigte Zeitintervall oder den Zoomfaktor ändern.

Aligner: Aligner ist eine Funktion, die bestimmt, wie die Daten in den Ausrichtungszeiträumen zusammengefasst werden. Zu den Alignern gehören die Summe, der Mittelwert usw. Gültige Ausrichtungsoptionen hängen von der Art und dem Typ der Messwertdaten ab, die in einer Zeitachse gespeichert sind. Das heißt, es hängt von MetricKind und ValueType der Zeitachse ab, welche Aligner zur Wahl stehen.

Mit einigen Alignern werden die Daten ausgerichtet und von einer Messwertart oder einem -typ in eine andere oder einen anderen konvertiert. Weitere Informationen zu den verfügbaren Alignern finden Sie unter Aligner in der API-Referenz.

Sekundäre Aggregation

Wenn Sie mehrere Zeitachsen haben, die bereits Aggregationen darstellen, wie die Beispiele, die die Gruppieren nach-Option veranschaulichen, können Sie sie durch Auswählen eines sekundären Aggregators unter 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 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.

Diese Beschreibungen werden standardmäßig aus den Werten verschiedener Labels 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:

  • Nur Text
  • Variablen, die Labels in Ihrer Zeitachse darstellen. Welche Labels verfügbar sind, hängt von der Zeitachse ab, die Sie grafisch dargestellt haben. Die Variablensyntax sieht jedoch im Allgemeinen etwa so aus: ${resource.labels.project_id}. Die ${}-Notation bewirkt, dass die Variable in der Beschreibung ausgewertet wird.

Wenn Sie nur Text angeben, sind die Beschreibungen der Zeitachsen im Diagramm identisch. Mit Variablen können Sie dafür sorgen, dass Werte aus Labels der Zeitachse in den Beschreibungen verwendet werden.

Wenn Sie die Variablennamen kennen, können Sie diese manuell in das Vorlagenfeld eingeben. Sie können auch mithilfe des Widgets + Filter hinzufügen in diesem Feld Variablen für die verfügbaren Labels auswählen. Mit dieser Methode sorgen Sie dafür, dass die Variablensyntax richtig ist.

Der folgende Screenshot zeigt eine Vorlage, die aus einem String und einer einzelnen Variable besteht:

Vorlage für eine einfache Beschreibung

In der Diagrammlegende werden die aus der Vorlage generierten Werte in einer Spalte mit dem Header Name angezeigt. Die Werte werden auch in der Kurzinfo angezeigt.

Der folgende Screenshot zeigt die Name-Werte und die Kurzinfos, die aus der Vorlage generiert wurden:

Aus einer Vorlage generierte Beschreibungen

Sie können auch Vorlagen mit mehreren Strings und Variablen erstellen, der in der Kurzinfo verfügbare Anzeigebereich ist jedoch begrenzt.