Messwerte auswählen und konfigurieren

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

In diesem Dokument werden die Felder beschrieben, die Sie beim Konfigurieren der Bedingung einer Benachrichtigungsrichtlinie festlegen. In der Regel erstellen Sie eine Benachrichtigungsrichtlinie, wenn Sie benachrichtigt werden möchten, wenn Zeitachsendaten wie die CPU-Nutzung einer virtuellen Maschine bestimmte Bedingungen erfüllen. Dieser Inhalt gilt nicht für logbasierte Benachrichtigungsrichtlinien. Informationen zu logbasierten Benachrichtigungsrichtlinien, die Sie benachrichtigen, wenn eine bestimmte Nachricht in Ihren Logs angezeigt wird, finden Sie unter Logs überwachen.

In diesem Dokument wird die Terminologie verwendet, die von der menügesteuerten Oberfläche der Google Cloud Console verwendet wird. Die konzeptionellen Informationen gelten jedoch für alle Ansätze, die Sie zum Erstellen einer Benachrichtigungsrichtlinie verwenden können. Informationen zur Verwendung der Cloud Monitoring API finden Sie unter Benachrichtigungsrichtlinien in der Cloud Monitoring API.

Anzuzeigende Daten auswählen

Um die Messwerte anzugeben, die beim Erstellen einer Benachrichtigungsrichtlinie angezeigt werden sollen, geben Sie Werte für einen Messwert und einen Ressourcentyp an:

Sie können die Cloud Monitoring API oder die Google Cloud Console verwenden, um eine Bedingung in einer Benachrichtigungsrichtlinie zu konfigurieren. Das Standarddialogfeld, in dem Sie eine Benachrichtigungsrichtlinie erstellen, wenn Sie die Google Cloud Console verwenden, ist menügesteuert. Wenn Sie jedoch Monitoring Query Language (MQL) verwenden möchten, können Sie die Google Cloud Console so konfigurieren, dass ein MQL-Editor aktiviert wird.

Nicht alle Zeitreihen können mit einem Messwert- und Ressourcenmodell dargestellt werden. Sie können beispielsweise einen Messwert und eine Ressource nicht angeben, wenn Sie die Anzahl der Prozesse überwachen möchten, die auf einer virtuellen Maschine (VM) ausgeführt werden. Konfigurieren Sie in solchen Fällen die Google Cloud Console so, dass der direkte Filtermodus geöffnet wird.

Standardmodus

Verwenden Sie den Standardmodus, wenn Sie eine Bedingung konfigurieren möchten, die einen Messwerttyp für einen bestimmten Ressourcentyp überwacht und keine Monitoring Query Language (MQL) verwenden soll. Standardmäßig werden in den Menüs nur Messwerte aufgeführt, für die Daten empfangen wurden. Mithilfe einer Ein-/Aus-Schaltfläche können Sie alle Google Cloud-Messwerte auflisten.

  • Das Feld metric gibt die Messungen 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 von Messwerttyp. Konzeptionelle Informationen finden Sie unter Messwerttypen.

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

So verwenden Sie den Standardmodus:

  1. Wählen Sie in der Google Cloud Console Monitoring aus oder klicken Sie auf die folgende Schaltfläche:
    Zu Monitoring
  2. Wählen Sie im Navigationsbereich Benachrichtigungen aus.
  3. Klicken Sie auf Richtlinie erstellen.
  4. Wählen Sie im Menü Messwert auswählen eine Ressource und einen Messwert aus.
  5. Fügen Sie Filter hinzu, geben Sie die Datentransformation an und schließen Sie das Dialogfeld der Benachrichtigungsrichtlinie ab. Weitere Informationen finden Sie unter Messwertbasierte Benachrichtigungsrichtlinie erstellen.

MQL-Modus

Verwenden Sie [MQL], um die Bedingung in Monitoring Query Language (MQL) zu beschreiben oder ein Verhältnis von Messwerten zu überwachen.

So verwenden Sie MQL:

  1. Wählen Sie in der Google Cloud Console Monitoring aus oder klicken Sie auf die folgende Schaltfläche:
    Zu Monitoring
  2. Wählen Sie im Navigationsbereich Benachrichtigungen aus.
  3. Klicken Sie auf Richtlinie erstellen.
  4. Wählen Sie in der Symbolleiste MQL aus.
  5. Geben Sie einen MQL-Ausdruck ein. Informationen zur Verwendung von MQL finden Sie unter Monitoring-Abfragesprache verwenden.
  6. Schließen Sie das Dialogfeld für die Benachrichtigungsrichtlinie ab. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien mit MQL verwalten.

Direkter Filtermodus

Wenn Sie eine der folgenden Aktionen ausführen möchten, verwenden Sie den Modus für direkte Filter:

  • Monitoring von Service Level Objectives (SLO).
  • Konfigurieren Sie eine Benachrichtigung für benutzerdefinierte Messwerte, für die Sie noch keine Daten haben.
  • Überwachen Sie die Anzahl der auf VMs ausgeführten Prozesse.
  • Prüfen Sie die Syntax für eine Filteranweisung, die in einem API-Befehl enthalten sein soll.
  • Konfigurieren Sie eine Benachrichtigung, in der Nutzerlabels angegeben werden, für die Sie noch keine Daten haben.

Wenn Sie den direkten Filtermodus verwenden, geben Sie zum Auswählen der Zeitachsen einen Monitoring-Filter ein. Der folgende Monitoring-Filter im Diagramm zeigt beispielsweise die Anzahl der Prozesse an, deren Name nginx enthält:

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

Der nächste Filter wählt die Zeitachse Disk write bytes für Compute Engine-VMs aus, die sich in der Zone us-central1-a befinden:

metric.type="compute.googleapis.com/instance/disk/write_bytes_count"
resource.type="gce_instance"
resource.label."zone"="us-central1-a"

So geben Sie einen Monitoringfilter oder eine Zeitachsenauswahl ein:

  1. Wählen Sie in der Google Cloud Console Monitoring aus oder klicken Sie auf die folgende Schaltfläche:
    Zu Monitoring
  2. Wählen Sie im Navigationsbereich Benachrichtigungen aus.
  3. Klicken Sie auf Richtlinie erstellen.
  4. Wählen Sie ? in der Abschnittsüberschrift Messwert wählen und wählen Sie dann in der Kurzinfo Direkter Filtermodus aus.
  5. Geben Sie einen Monitoringfilter oder eine Zeitachsenauswahl ein. Informationen zur Syntax finden Sie in den folgenden Dokumenten:

  6. Geben Sie die Datentransformation an und schließen Sie das Dialogfeld der Benachrichtigungsrichtlinie ab. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinie für Prozessintegrität erstellen.

Ausgewählte Daten filtern

Durch die Angabe von Filterkriterien oder durch Aggregation können Sie die Menge der zu überwachenden Daten reduzieren. Filter stellen sicher, dass nur Zeitachsen verwendet werden, die bestimmte Kriterien erfüllen. Wenn Sie Filter anwenden, müssen weniger Zeitachsen ausgewertet werden, wodurch die Leistung der Benachrichtigung verbessert werden kann.

Wenn Sie mehrere Filterkriterien angeben, enthält das entsprechende Diagramm nur die Zeitachse, die alle Kriterien erfüllt, ein logisches AND.

Um einen Filter hinzuzufügen, klicken Sie auf Filter hinzufügen, füllen Sie das Dialogfeld aus und klicken Sie dann auf Fertig. Im Dialogfeld verwenden Sie das Feld Filter, um das Kriterium auszuwählen, nach dem gefiltert werden soll. Sie können beispielsweise nach Ressourcengruppe, Name, Ressourcenlabel, Zone und Messwertlabel filtern. Nachdem Sie das Filterkriterium ausgewählt haben, schließen Sie den Filter ab, indem Sie den Vergleichsoperator und den Wert auswählen. In jeder Zeile der folgenden Tabelle sind ein Vergleichsoperator, seine Bedeutung und ein Beispiel aufgeführt:

OperatorBedeutungBeispiel
= Entsprechung resource.labels.zone = "us-central1-a
!= Ungleichheit resource.labels.zone != "us-central1-a"
=~ Gleichheit mit regulärem Ausdruck2 monitoring.regex.full_match("^us.*")
!=~ Ungleichheit mit regulärem Ausdruck2 monitoring.regex.full_match("^us.*")
starts_with Wert beginnt mit resource.labels.zone = starts_with("us")
ends_with Wert endet mit resource.labels.zone = ends_with("b")
has_substring Wert enthält resource.labels.zone = has_substring("east")
one_of Eine von resource.labels.zone = one_of("asia-east1-b", "europe-north1-a")
!starts_with Wert beginnt nicht mit resource.labels.zone != starts_with("us")
!ends_with Wert endet nicht mit resource.labels.zone != ends_with("b")
!has_substring Wert enthält nicht resource.labels.zone != has_substring("east")
!one_of Wert ist keiner der folgenden Werte resource.labels.zone != one_of("asia-east1-b", "europe-north1-a")

Daten transformieren

Nach der Auswahl der Zeitachse müssen Sie als Nächstes angeben, wie jede Zeitachse verarbeitet wird (auch als Ausrichtung bezeichnet) und wie die ausgerichteten Zeitachsen kombiniert werden.

Nachstehend werden diese Optionen kurz beschrieben. Eine ausführliche Erläuterung finden Sie unter Zeitachsen bearbeiten.

Zeitreihe ausrichten

Bei der Ausrichtung wird eine von Monitoring erhaltene Zeitachse in eine neue Zeitachse mit Datenpunkten umgewandelt, die über einen festen Zeitraum verteilt sind. Der Ausrichtungsprozess umfasst die folgenden Schritte:

  1. Eine Zeitachse wird in eine Reihe von Intervallen mit fester Länge aufgeteilt.
  2. Alle Datenpunkte in jedem Intervall erfassen und eine Funktion anwenden, um diese Datenpunkte zu kombinieren. Sie können diese Funktion beispielsweise auswählen, um den Durchschnitt aller Stichproben zu berechnen.
  3. Verknüpfen eines Zeitstempels mit dem im vorherigen Schritt berechneten Wert und Hinzufügen des Paars zu den ausgerichteten Zeitachsen.

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, werden Standardwerte für diese Parameter angegeben:

  • Rollierendes Fenster: Dieses Feld enthält ein Rückschau-Intervall ab einem bestimmten Zeitpunkt. Wenn dieser Wert 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 ausgerichtet, die zwischen 12:56 Uhr und 13:01 Uhr empfangen werden. Bei Benachrichtigungsrichtlinien kann der Ausrichtungszeitraum als gleitendes Fenster betrachtet werden, das in der Vergangenheit liegt. Weitere Diskussionen zu diesem Feld finden Sie unter Ausrichtungszeitraum und Dauer.

  • Funktion für rollierendes Zeitfenster: Das Feld gibt die Funktion an, mit der alle Datenpunkte im Rückschau-Intervall kombiniert werden. In der Cloud Monitoring API wird dieses Feld als Aligner bezeichnet. Weitere Informationen zu den verfügbaren Funktionen finden Sie unter Aligner in der API-Referenz. Mit einigen Aligner-Funktionen werden die Daten sowohl ausgerichtet also auch von einer Messwertart oder einem Messwerttyp 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 Zeitreihendaten innerhalb einer Gruppe zu einer neuen Zeitachse kombiniert werden.

Klicken Sie auf Mehr anzeigen im Abschnitt Über Zeitachsen hinweg, um auf die Optionen zum Kombinieren von Zeitachsen zuzugreifen.

Wenn Sie Zeitachsen nach Labelwert kombinieren möchten, klicken Sie auf den Text Zeitachsen gruppieren nach und treffen Sie eine Auswahl im Menü. Das Menü wird dynamisch anhand der ausgewählten Zeitachse erstellt.

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

  • Ein Fehler wird angezeigt, da das Feld Zeitachsenaggregation auf Keine gesetzt ist. Wählen Sie eine Funktion aus, mit der die Zeitachse mit demselben Labelwert kombiniert wird, um den Fehler zu beheben.

  • Im Diagramm wird für jeden Wert des Labels im Feld Zeitachsengruppe nach eine Zeitachse angezeigt.

Wenn Sie keine Gruppierungsoption angeben, aber eine Aggregationsfunktion angeben, wird diese Funktion auf die ausgewählte Zeitachse angewendet.

Sie können nach mehreren Labels gruppieren. Wenn Sie mehrere Gruppierungsoptionen haben, wird der Aggregator auf den Satz von Zeitachsen angewendet, die für die ausgewählten Labels dieselben Werte haben.

Im resultierenden Diagramm wird für jede Kombination von Labelwerten eine Zeitachse angezeigt. 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 beim Gruppieren 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 auf einfache Weise mehr Daten erstellt werden können, als Sie für ein einzelnes Diagramm sinnvoll einsetzen 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 nach der primären Datentransformation mehrere Zeitachsen anzeigen lassen und die Benachrichtigungsrichtlinie eine einzelne Zeitachse überwachen soll, verwenden Sie die Felder der sekundären Datentransformation.

Verhalten, wenn Daten fehlen

Google Cloud Console

Sie können konfigurieren, wie Monitoring eine Bedingung für Messwertschwellen auswertet, wenn keine Daten mehr eingehen. Soll beispielsweise ein Vorfall offen bleiben oder sofort geschlossen werden, wenn ein Vorfall offen ist und eine erwartete Messung nicht eintritt? Wenn Daten nicht mehr eingehen und kein Vorfall offen ist, soll dann ein Vorfall geöffnet werden? Wie lange sollte ein Vorfall geöffnet bleiben, nachdem die Daten nicht mehr ankommen?

Es gibt zwei konfigurierbare Felder, die festlegen, wie Monitoring Bedingungen von Messwertschwellen bei Eingang von Daten auswertet:

  • Verwenden Sie das Feld Evaluierung fehlender Daten, das Sie im Schritt Bedingungstrigger festgelegt haben, um zu konfigurieren, wie Monitoring den Ersatzwert für fehlende Daten ermittelt. Dieses Feld ist deaktiviert, wenn das Fenster für den erneuten Test auf Kein neuer Test festgelegt ist.

  • Mit dem Feld Dauer für das automatische Schließen von Vorfällen können Sie festlegen, wie lange Monitoring wartet, bevor ein offener Vorfall geschlossen wird, nachdem keine Daten mehr eingegangen sind. Die Dauer des automatischen Schließens legen Sie im Schritt Benachrichtigung fest. Die Standarddauer für das automatische Schließen beträgt sieben Tage.

Im Folgenden werden die verschiedenen Optionen für das fehlende Datenfeld beschrieben:

Google Cloud Console
Feld „Evaluierung fehlender Daten“
Fazit Details
Fehlende Daten Offene Vorfälle bleiben offen.
Neue Vorfälle werden nicht geöffnet.

Für erfüllte Bedingungen ist die Bedingung auch weiterhin erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, bleibt er offen. Wenn ein Vorfall geöffnet ist und keine Daten eingehen, startet der Timer für das automatische Schließen nach einer Verzögerung von mindestens 15 Minuten. Wenn der Timer abläuft, wird der Vorfall geschlossen.

Für Bedingungen, die nicht erfüllt sind, ist die Bedingung weiterhin nicht erfüllt, wenn keine Daten mehr eingehen.

Fehlende Datenpunkte, die als Werte betrachtet werden, die gegen die Richtlinienbedingung verstoßen Offene Vorfälle bleiben offen.
Neue Vorfälle können erstellt werden.

Für erfüllte Bedingungen ist die Bedingung auch weiterhin erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, bleibt er offen. Wenn ein Vorfall geöffnet ist und für die Dauer des automatischen Schließens plus 24 Stunden keine Daten eingehen, wird der Vorfall geschlossen.

Bei Bedingungen, die nicht erfüllt sind, verhält sich diese Einstellung dazu, dass sich die Messwertschwellenbedingung wie ein metric-absence condition verhält. Wenn die Daten nicht innerhalb des im Retestfenster angegebenen Zeitraums eingehen, wird die Bedingung als erfüllt ausgewertet. Bei einer Benachrichtigungsrichtlinie mit einer einzigen Bedingung führt das Erfüllen der Bedingung dazu, dass ein Vorfall geöffnet wird.

Fehlende Datenpunkte, die als Werte angesehen werden, die nicht gegen die Richtlinienbedingung verstoßen Offene Vorfälle sind geschlossen.
Neue Vorfälle werden nicht geöffnet.

Wenn Bedingungen erfüllt sind, wird die Bedingung nicht mehr erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, wird er geschlossen.

Für Bedingungen, die nicht erfüllt sind, ist die Bedingung weiterhin nicht erfüllt, wenn keine Daten mehr eingehen.

API

Sie können konfigurieren, wie Monitoring eine Bedingung für Messwertschwellen auswertet, wenn keine Daten mehr eingehen. Soll beispielsweise ein Vorfall offen bleiben oder sofort geschlossen werden, wenn ein Vorfall offen ist und eine erwartete Messung nicht eintritt? Wenn Daten nicht mehr eingehen und kein Vorfall offen ist, soll dann ein Vorfall geöffnet werden? Wie lange sollte ein Vorfall geöffnet bleiben, nachdem die Daten nicht mehr ankommen?

Es gibt zwei konfigurierbare Felder, die festlegen, wie Monitoring Bedingungen von Messwertschwellen bei Eingang von Daten auswertet:

  • Verwenden Sie das Feld evaluationMissingData der MetricThreshold-Struktur, um zu konfigurieren, wie Monitoring den Ersatzwert für fehlende Daten ermittelt. Dieses Feld wird ignoriert, wenn das Feld duration null ist.

  • Mit dem Feld autoClose in der Struktur AlertStrategy können Sie konfigurieren, wie lange Monitoring wartet, bevor ein offener Vorfall geschlossen wird, nachdem keine Daten mehr eingegangen sind.

Im Folgenden werden die verschiedenen Optionen für das fehlende Datenfeld beschrieben:

Feld „API“
evaluationMissingData
Fazit Details
EVALUATION_MISSING_DATA_UNSPECIFIED Offene Vorfälle bleiben offen.
Neue Vorfälle werden nicht geöffnet.

Für erfüllte Bedingungen ist die Bedingung auch weiterhin erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, bleibt er offen. Wenn ein Vorfall geöffnet ist und keine Daten eingehen, startet der Timer für das automatische Schließen nach einer Verzögerung von mindestens 15 Minuten. Wenn der Timer abläuft, wird der Vorfall geschlossen.

Für Bedingungen, die nicht erfüllt sind, ist die Bedingung weiterhin nicht erfüllt, wenn keine Daten mehr eingehen.

EVALUATION_MISSING_DATA_ACTIVE Offene Vorfälle bleiben offen.
Neue Vorfälle können erstellt werden.

Für erfüllte Bedingungen ist die Bedingung auch weiterhin erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, bleibt er offen. Wenn ein Vorfall geöffnet ist und für die Dauer des automatischen Schließens keine Daten eingehen, plus 24 Stunden, wird der Vorfall geschlossen.

Bei Bedingungen, die nicht erfüllt sind, verhält sich diese Einstellung dazu, dass sich die Messwertschwellenbedingung wie ein metric-absence condition verhält. Wenn Daten nicht innerhalb der im Feld „duration“ angegebenen Zeit eintreffen, wird die Bedingung als erfüllt ausgewertet. Bei einer Benachrichtigungsrichtlinie mit einer einzigen Bedingung führt das Erfüllen der Bedingung dazu, dass ein Vorfall geöffnet wird.

EVALUATION_MISSING_DATA_INACTIVE Offene Vorfälle sind geschlossen.
Neue Vorfälle werden nicht geöffnet.

Wenn Bedingungen erfüllt sind, wird die Bedingung nicht mehr erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, wird er geschlossen.

Für Bedingungen, die nicht erfüllt sind, ist die Bedingung weiterhin nicht erfüllt, wenn keine Daten mehr eingehen.