Nutzung von Reservierungen überwachen

In diesem Dokument wird erläutert, wie Sie die Nutzung von zonalen Compute Engine-Ressourcen mithilfe von Cloud Monitoring überwachen.

Monitoring erfasst und speichert Leistungsinformationen von Google Cloud-Diensten wie Compute Engine. Die Leistungsinformationen werden als Messwerte und Zeitreihen bezeichnet. Sie können auf die Messwerte und Zeitreihen Ihrer Compute Engine-Reservierungen zugreifen, um Folgendes zu tun:

Mithilfe von Monitoring-Dashboards ansehen, wie Ihre Reservierungen genutzt werden.
Zeitnahe Benachrichtigungen erhalten, wenn die Nutzung Ihrer Reservierungen einen bestimmten Zustand hat. Verwenden Sie dazu Monitoring-Benachrichtigungsrichtlinien.

Mit diesen Methoden können Sie beispielsweise prüfen, ob Ihre Reservierungen wie geplant genutzt werden, oder rechtzeitig reagieren, um unnötige Kosten durch nicht genutzte Ressourcen oder nicht verwendete Reservierungen zu vermeiden.

Hinweise

Informationen zu den Anforderungen und Einschränkungen für Reservierungen

Monitoring API aktivieren.
Aktivieren Sie die API

Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.

Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:
Console

Wenn Sie über die Google Cloud Console auf Google Cloud-Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
REST

Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Erstellen von Monitoring-Dashboards oder Benachrichtigungsrichtlinien benötigen, um die Nutzung von Reservierungen überwachen zu können, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Admin (roles/monitoring.admin) für das Projekt zuzuweisen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen von Monitoring-Dashboards oder Benachrichtigungsrichtlinien erforderlich sind, um die Nutzung von Reservierungen überwachen zu können. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Monitoring-Dashboards oder Benachrichtigungsrichtlinien zu erstellen, mit denen die Nutzung von Reservierungen überwacht werden kann:

Zum Erstellen von Dashboards: monitoring.dashboards.create für das Projekt
Zum Erstellen von Richtlinienbenachrichtigungen: monitoring.alertPolicies.create für das Projekt

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Einschränkungen

Wenn Sie mit Monitoring auf die Zeitreihen einer Reservierung zugreifen und diese aufrufen, gelten die folgenden Einschränkungen:

Nachdem Sie eine Reservierung erstellt haben, wird die Zeitreihe innerhalb von 30 Minuten verfügbar.
Sobald eine Zeitreihe verfügbar ist, wird sie von Monitoring mindestens alle 30 Minuten aktualisiert.
Wenn Sie eine Reservierung löschen, wird ihre Zeitreihe ebenfalls gelöscht und kann nicht wiederhergestellt werden.
Sie können die Zeitreihe einer Reservierung, die im aktuellen Projekt erstellt wurde, nur aufrufen und anzeigen.

Weitere Informationen zu den Monitoring-Einschränkungen finden Sie unter Kontingente und Limits für Cloud Monitoring.

Reservierungsmesswerte

Wenn Sie Monitoring-Dashboards oder Benachrichtigungsrichtlinien erstellen, müssen Sie zuerst den Google Cloud-Messwert auswählen, um die Leistung des Google Cloud-Dienstes zu messen. Für Reservierungen können Sie die folgenden Compute Engine-Messwerte auswählen:

Reserviert: Die Anzahl der reservierten VM-Instanzen in jeder Reservierung im aktuellen Projekt.
Verwendet: Die Anzahl der genutzten VMs in jeder Reservierung im aktuellen Projekt.

Nachdem Sie einen Messwert ausgewählt haben, können Sie die Messungen des Messwerts für Reservierungen weiter filtern oder gruppieren. Weitere Informationen zu den verfügbaren Filtern für Reservierungen finden Sie in diesem Dokument unter Reservierungsfilter.

Reservierungsfilter

Mit Monitoring-Filtern können Sie die Zeitreihendaten gruppieren oder filtern, die einer oder mehreren Reservierungen zugeordnet sind. Beim Erstellen von Monitoring-Dashboards oder Benachrichtigungsrichtlinien können Sie die von ihnen verwendeten Zeitreihendaten einschränken. Geben Sie dazu mindestens eines der folgenden Labels an:

Selector	Labelname	Beschreibung
`metadata.system`	`machine_type`	Der in den reservierten VMs für die Reservierung angegebene Maschinentyp.
`metadata.system`	`name`	Der Name einer Reservierung.
`metadata.system`	`state`	Der Status einer Reservierung. Sie können Reservierungen nur im Status `ACTIVE` überwachen. Dies ist der Fall, wenn eine Reservierung vorhanden ist.
`metric`	`reserved_resource_type`	Der Typ der durch eine Reservierung reservierten zonalen Ressourcen. Sie können nur den Typ `instance` beobachten, bei dem es sich um eine VM-Instanz handelt.
`resource`	`location`	Die Zone, in der sich eine Reservierung befindet.
`resource`	`reservation_id`	Die ID einer Reservierung.
`resource`	`resource_container`	Die Nummer des Projekts, in dem sich eine Reservierung befindet. Sie können nur die Reservierungen überwachen, die im aktuellen Projekt erstellt wurden.

Beim Erstellen eines Filters müssen Sie den Selektor und den Labelnamen angeben, gefolgt von einem Vergleichsoperator und dem Wert, den Sie filtern möchten. Wenn Sie beispielsweise mit Ihrer Abfrage Ihre Reservierungen nach der Zone us-central1-a filtern möchten, verwenden Sie den folgenden Filter:

resource.location = "us-central1-a"

Um sicherzustellen, dass der in einem Filter angegebene Wert mit dem Wert eines Felds einer Reservierung übereinstimmt, rufen Sie die Details der Reservierung auf.

Nutzung von Reservierungen überwachen

Wählen Sie eine der folgenden in diesem Dokument angegebenen Methoden aus, um die Nutzung Ihrer Reservierungen zu überwachen:

Dashboard erstellen: Erstellen Sie Monitoring-Dashboards und fügen Sie den Grafikbereichen Widgets hinzu, um die Zeitreihendaten anzuzeigen, die mit der Nutzung Ihrer Reservierungen verbunden sind.

Diese Methode ist beispielsweise nützlich, wenn Sie überprüfen möchten, ob eine VM eine Reservierung ordnungsgemäß nutzt, oder den Nutzungsverlauf mehrerer Reservierungen vergleichen möchten.
Benachrichtigungsrichtlinien erstellen: Erstellen Sie Benachrichtigungsrichtlinien, um Benachrichtigungen zu senden, wenn die Zeitreihendaten, die mit der Nutzung Ihrer Reservierungen verbunden sind, einen definierten Grenzwert erreichen.

Diese Methode ist beispielsweise nützlich, wenn Sie benachrichtigt werden möchten, wenn die Anzahl der im aktuellen Projekt verwendeten VMs unter einem bestimmten Verhältnis liegt oder wenn eine Reservierung für eine bestimmte Zeitdauer ungenutzt bleibt.

Dashboard erstellen

Mit der Google Cloud Console (empfohlen) und der Monitoring API können Sie Monitoring-Dashboards erstellen und die mit der Nutzung Ihrer Reservierungen verbundenen Zeitreihen aufrufen.

Wenn Sie festlegen, wie die Zeitreihendaten eines Monitoring-Filters angezeigt werden sollen, müssen Sie eine der folgenden Methoden verwenden:

Basic Query: Diese Methode ist nützlich, um die Zeitreihendaten für ein Dashboard-Widget schnell zu konfigurieren.

Sie können beispielsweise Basic Query verwenden, um schnell anzuzeigen, welche Ihrer Reservierungen in einer bestimmten Zone noch nicht vollständig genutzt wird.
MQL: Diese Methode ist zum Abrufen, Filtern und Bearbeiten von Zeitreihendaten nützlich, um komplexere Konfigurationen für ein Dashboard-Widget zu erstellen.

Beispielsweise können Sie mit Monitoring Query Language (MQL) das Verhältnis von genutzten VMs zu reservierten VMs in Ihren Reservierungen aufrufen.

Tipp: Weitere Methoden zum Konfigurieren der Zeitreihen Ihrer Reservierungen in einem Monitoring-Dashboard finden Sie unter PromQL in Cloud Monitoring.

Basic Query

Im folgenden Beispiel wird beschrieben, wie Sie ein Monitoring-Dashboard mit einem Liniendiagramm-Widget erstellen, um Ihre genutzten Reservierungen in der Zone us-central1-a anzuzeigen.

Console

So erstellen Sie ein Monitoring-Dashboard mit Basic Query:

Wechseln Sie in der Google Cloud Console zu Dashboards.

Dashboards aufrufen
Klicken Sie auf Dashboard erstellen.

Die Seite Neues Dashboard wird geöffnet.
Klicken Sie auf Widget hinzufügen.

Der Bereich Widget hinzufügen wird angezeigt.
Klicken Sie auf eines der verfügbaren Widgets. Klicken Sie beispielsweise auf das Linien-Widget.

Der Bereich Widget konfigurieren wird angezeigt.
Klicken Sie auf Messwert auswählen.
Führen Sie im Fenster Messwert auswählen die folgenden Schritte aus:
1. Geben Sie Reservation ein und wählen Sie Reservierung aus.
  
  Wichtig: Wenn Sie den Messwert Reservierung nicht sehen, sehen Sie sich Messwert nicht im Menü aufgeführt an.
2. Wählen Sie in der Liste Aktive Messwertkategorien noch einmal Reservierung aus.
3. Wählen Sie in der Liste Aktive Messwerte einen der verfügbaren Messwerte aus. Wählen Sie beispielsweise Verwendet aus.
4. Klicken Sie auf Anwenden.
So filtern Sie Ihre Reservierungen nach einer bestimmten Zone:
1. Wählen Sie in der Liste Filter hinzufügen einen der verfügbaren Filter für Reservierungen aus. Wählen Sie für dieses Beispiel Standort aus.
2. Wählen Sie in der Liste Comparator einen der verfügbaren Operatoren aus. Wählen Sie für dieses Beispiel = (gleich) (Standard) aus.
3. Wählen Sie in der Liste Wert die Zone aus, mit der Sie die Reservierungen filtern möchten. Wählen Sie für dieses Beispiel us-central1-a aus.
Klicken Sie auf Anwenden.

Weitere Optionen zum Anpassen von Monitoring-Dashboards mit der Google Cloud Console finden Sie unter Benutzerdefinierte Dashboards erstellen und verwalten.

REST

Senden Sie zum Erstellen eines Monitoring-Dashboards mit Basic Query eine POST-Anfrage an die Methode dashboards.create.

POST https://monitoring.googleapis.com/v1/projects/PROJECT_ID/dashboards

{
  "displayName": "Consumed reservations in zone us-central1-a",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      {
        "height": 4,
        "widget": {
          "title": "Reservation - Used for us-central1-a [MEAN]",
          "xyChart": {
            "chartOptions": {
              "mode": "COLOR"
            },
            "dataSets": [
              {
                "minAlignmentPeriod": "60s",
                "plotType": "LINE",
                "targetAxis": "Y1",
                "timeSeriesQuery": {
                  "timeSeriesFilter": {
                    "aggregation": {
                      "alignmentPeriod": "60s",
                      "perSeriesAligner": "ALIGN_MEAN"
                    },
                    "filter": "FILTER",
                    "secondaryAggregation": {
                      "alignmentPeriod": "60s",
                      "perSeriesAligner": "ALIGN_NONE"
                    }
                  }
                }
              }
            ],
            "timeshiftDuration": "0s",
            "yAxis": {
              "scale": "LINEAR"
            }
          }
        },
        "width": 6
      }
    ]
  }
}

Ersetzen Sie Folgendes:

PROJECT_ID: Die Projekt-ID des aktuellen Projekts.
FILTER: der Monitoring-Filter, der für das Dashboard verwendet werden soll. Geben Sie beispielsweise Folgendes an, um die verbrauchten Reservierungen in der Zone us-central1-a zu überwachen:
```
resource.type = 'compute.googleapis.com/Reservation' AND metric.type = 'compute.googleapis.com/reservation/used' AND resource.location = 'us-central1-a'
```

Weitere Optionen zum Anpassen von Monitoring-Dashboards mit der Monitoring API finden Sie unter Dashboards mithilfe der API erstellen und verwalten.

MQL

Im folgenden Beispiel wird beschrieben, wie Sie ein Monitoring-Dashboard mit einem Liniendiagramm-Widget erstellen, um das Verhältnis von verwendeten VMs zu reservierten VMs in Ihren Reservierungen aufzurufen.

Console

So erstellen Sie ein Monitoring-Dashboard mit MQL:

Wechseln Sie in der Google Cloud Console zu Dashboards.

Dashboards aufrufen
Klicken Sie auf Dashboard erstellen.

Die Seite Neues Dashboard wird geöffnet.
Klicken Sie auf Widget hinzufügen.

Der Bereich Widget hinzufügen wird angezeigt.
Klicken Sie auf eines der verfügbaren Widgets. Klicken Sie beispielsweise auf das Linien-Widget.

Der Bereich Widget konfigurieren wird angezeigt.
Klicken Sie auf MQL.

Geben Sie im Abfrageeditor eine MQL-Abfrage ein. Wenn Sie beispielsweise das Verhältnis von verwendeten VMs zu reservierten VMs in Ihren Reservierungen aufrufen möchten, geben Sie Folgendes an:

fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
    | group_by [metadata.system.name], sliding(1m), max(value.used)
  ; metric compute.googleapis.com/reservation/reserved
    | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio

Klicken Sie auf Abfrage ausführen.
Klicken Sie auf Anwenden.

Weitere Optionen zum Anpassen von Monitoring-Dashboards mit der Google Cloud Console finden Sie unter Benutzerdefinierte Dashboards erstellen und verwalten.

REST

Senden Sie zum Erstellen eines Monitoring-Dashboards mit MQL eine POST-Anfrage an die Methode dashboards.create.

POST https://monitoring.googleapis.com/v1/projects/PROJECT_ID/dashboards

{
  "displayName": "Consumed reservations in zone us-central1-a",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      {
        "height": 4,
        "widget": {
          "title": "Reservation - Used for us-central1-a [MEAN]",
          "xyChart": {
            "chartOptions": {
              "mode": "COLOR"
            },
            "dataSets": [
              {
                "plotType": "LINE",
                "targetAxis": "Y1",
                "timeSeriesQuery": {
                  "timeSeriesQueryLanguage": "MQL_QUERY"
                }
              }
            ],
            "timeshiftDuration": "0s",
            "yAxis": {
              "scale": "LINEAR"
            }
          }
        },
        "width": 6,
        "xPos": 6
      }
    ]
  }
}

Ersetzen Sie Folgendes:

PROJECT_ID: Die Projekt-ID des aktuellen Projekts.
MQL_QUERY: Die MQL-Abfrage, die für das Liniendiagramm-Widget verwendet werden soll. Geben Sie beispielsweise Folgendes an, um das Verhältnis von verwendeten VMs zu reservierten VMs in Ihren Reservierungen aufzurufen:
```
fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
 | group_by [metadata.system.name], sliding(1m), max(value.used)
; metric compute.googleapis.com/reservation/reserved
 | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio
```
Wichtig: Wenn Sie eine MQL-Abfrage angeben möchten, die sich über mehrere Zeilen im Feld timeSeriesQueryLanguage erstreckt, achten Sie darauf, das Zeichen \n am Ende jeder Zeile hinzuzufügen.

Weitere Optionen zum Anpassen von Monitoring-Dashboards mit der Monitoring API finden Sie unter Dashboards mithilfe der API erstellen und verwalten.

Benachrichtigungsrichtlinien erstellen

Sie können Monitoring-Benachrichtigungsrichtlinien erstellen, um mithilfe der Google Cloud Console und der Monitoring API Benachrichtigungen über die Reservierungsnutzung im aktuellen Projekt zu erhalten.

Wenn Sie eine Benachrichtigungsbedingung für eine Benachrichtigungsrichtlinie definieren, müssen Sie eine der folgenden Methoden verwenden:

Basic Query: Diese Methode ist nützlich, um einfache Benachrichtigungsbedingungen zu erstellen.

Sie können beispielsweise Basic Query verwenden, um eine Benachrichtigungsbedingung zu erstellen, die ausgelöst wird, wenn eine Reservierung zum ersten Mal genutzt wird.
MQL: Diese Methode ist zum Abrufen, Filtern und Bearbeiten von Zeitreihendaten nützlich, um komplexere Benachrichtigungsbedingungen zu erstellen.

Mit Monitoring Query Language (MQL) können Sie beispielsweise eine Benachrichtigungsbedingung erstellen, die ausgelöst wird, wenn das Verhältnis von reservierten VMs zu genutzten VMs einen bestimmten Grenzwert erreicht.

Basic Query

Im folgenden Beispiel wird eine Benachrichtigungsrichtlinie erstellt, die eine Benachrichtigung sendet, wenn eine Reservierung zum ersten Mal genutzt wird. Insbesondere wird die Benachrichtigung ausgelöst, wenn die Anzahl der genutzten VMs in einer Reservierung größer als 0 ist.

Console

So erstellen Sie eine Monitoring-Benachrichtigungsrichtlinie mit Basic Query:

Wechseln Sie in der Google Cloud Console zu Benachrichtigungen.

Zu Benachrichtigungen
Klicken Sie auf Richtlinie erstellen.

Die Seite Benachrichtigungsrichtlinie erstellen wird geöffnet.
Klicken Sie auf Messwert auswählen.

Das Fenster Messwert auswählen wird angezeigt.
Führen Sie im Fenster Messwert auswählen die folgenden Schritte aus:
1. Geben Sie im Feld Nach Ressourcen- oder Messwertname filtern den Wert Reservation ein.
2. Wenn der Messwert Reservierung in der Liste Aktive Ressourcen angezeigt wird, wählen Sie ihn aus. Gehen Sie andernfalls so vor:
  1. Heben Sie die Auswahl von Nur aktive Ressourcen und Messwerte anzeigen auf.
    
    Die Liste Inaktive Ressourcen wird angezeigt.
  2. Wählen Sie in der Liste Inaktive Ressourcen die Option Reservierung aus.
    
    Wichtig: Wenn Sie den Messwert Reservierung immer noch nicht sehen, sehen Sie sich Messwert nicht im Menü aufgeführt an.
3. Wählen Sie in der Liste Aktive Messwertkategorien noch einmal Reservierung aus.
  
  Die Liste Aktive Messwerte wird angezeigt.
4. Wählen Sie in der Liste Aktive Messwerte einen der verfügbaren Messwerte aus.
  
  Wählen Sie beispielsweise Verwendet aus.
5. Klicken Sie auf Anwenden.
Klicken Sie auf Filter hinzufügen.

Der Abschnitt Filter hinzufügen wird angezeigt.
Gehen Sie im Abschnitt Filter hinzufügen so vor:
1. Wählen Sie in der Liste Label einen der verfügbaren Filter für Reservierungen aus, die in diesem Dokument angegeben sind.
  
  Wenn Sie Ihre Reservierungen beispielsweise nach dem Namen filtern möchten, wählen Sie Name aus.
2. Wählen Sie in der Liste Vergleich einen der verfügbaren Operatoren aus.
  
  Wählen Sie beispielsweise = (gleich) (Standardeinstellung) aus.
3. Wählen Sie in der Liste Wert den Namen der Reservierung aus, die Sie überwachen möchten.
4. Klicken Sie auf Fertig.
Klicken Sie auf Next (Weiter).

Der Bereich Benachrichtigungstrigger konfigurieren wird angezeigt.
Wählen Sie im Bereich Bedingungstypen eine der folgenden Optionen aus:
1. Wenn die Bedingung ausgelöst werden soll, wenn eine Zeitreihe über oder unter einem bestimmten Wert liegt, wählen Sie Grenzwert aus.
2. Wenn die Bedingung ausgelöst werden soll, wenn eine Zeitreihe für einen bestimmten Zeitraum keine Daten enthält, wählen Sie Fehlende Messwerte aus.
3. Um die Bedingung auszulösen, wenn eine Zeitreihe den Grenzwert in naher Zukunft voraussichtlich überschreitet, wählen Sie Prognose aus.
Wählen Sie beispielsweise Grenzwert (Standardeinstellung) aus.
Wählen Sie in der Liste Benachrichtigungstrigger die Bedingung aus, die die Benachrichtigung auslöst.

Wählen Sie beispielsweise Beliebiger Zeitreihenverstoß (Standardeinstellung) aus.
Wählen Sie in der Liste Grenzwertposition aus, wann die Bedingung ausgelöst wird.

Wählen Sie beispielsweise Über Grenzwert aus.
Geben Sie im Feld Grenzwert einen Wert für die Bedingung ein.

Geben Sie beispielsweise 0 ein.
Geben Sie im Feld Bedingungsname einen Namen für die Bedingung ein.

Geben Sie beispielsweise Reservation RESERVATION_NAME consumed. ein.

Dabei ist RESERVATION_NAME der Name der Reservierung, die Sie in den vorherigen Schritten angegeben haben.
Klicken Sie auf Next (Weiter).

Der Bereich Benachrichtigungen konfigurieren und Benachrichtigung abschließen wird angezeigt.
Klicken Sie auf Benachrichtigungskanäle verwenden.
Wählen Sie im Feld Benachrichtigungskanäle die Kanäle aus, über die Sie über den Vorfall benachrichtigt werden möchten.

Wenn keine Benachrichtigungskanäle verfügbar sind, klicken Sie auf Benachrichtigungskanäle verwalten und folgen Sie den Schritten zum Erstellen von Benachrichtigungskanälen. Weitere Informationen finden Sie unter Benachrichtigungskanäle erstellen und verwalten.
Wählen Sie im Feld Dauer bis zur automatischen Schließung von Vorfällen eine Dauer aus, nach der ein Vorfall automatisch geschlossen wird.

Wählen Sie beispielsweise 3 Tage aus.
Geben Sie im Feld Name der Benachrichtigungsrichtlinie einen Namen für die Benachrichtigungsrichtlinie ein.

Geben Sie beispielsweise Alert: you started consuming reservation RESERVATION_NAME! ein.

Dabei ist RESERVATION_NAME der Name der Reservierung, die Sie in den vorherigen Schritten angegeben haben.
Klicken Sie auf Next (Weiter).

Die Überprüfungsseite der Benachrichtigungsbedingung wird geöffnet.
Klicken Sie auf Richtlinie erstellen.

Das Erstellen der Benachrichtigungsrichtlinie kann einige Sekunden dauern. Durch diese Aktion wird wieder die Seite Benachrichtigungsrichtlinie erstellen angezeigt.

Weitere Informationen zu den Optionen, die Sie beim Erstellen von Benachrichtigungsrichtlinien mit der Google Cloud Console und Basic Query haben, finden Sie unter Messwertbasierte Benachrichtigungsrichtlinien erstellen.

REST

Senden Sie zum Erstellen einer Monitoring-Benachrichtigungsrichtlinie mit Basic Query eine POST-Anfrage an die Methode projects.alertPolicies.create.

POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies

{
  "displayName": "Alert: you started consuming reservation RESERVATION_NAME!",
  "conditions": [
    {
      "displayName": "Reservation RESERVATION_NAME consumed.",
      "conditionThreshold": {
        "filter": "FILTER",
        "aggregations": [
          {
            "alignmentPeriod": "300s",
            "crossSeriesReducer": "REDUCE_NONE",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "duration": "0s",
        "trigger": {
          "count": 1
        },
        "thresholdValue": 0
      }
    }
  ],
  "alertStrategy": {
    "autoClose": "AUTO_CLOSE_TIME"
  },
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
  ]
}

Ersetzen Sie Folgendes:

PROJECT_ID: Die Projekt-ID des aktuellen Projekts.
RESERVATION_NAME: Der Name einer vorhandenen Reservierung, die sich im aktuellen Projekt befindet.
FILTER: der Monitoring-Filter, der für Benachrichtigungsrichtlinie verwendet werden soll. Geben Sie beispielsweise Folgendes an, um den Messwert used für die Reservierung RESERVATION_NAME zu überwachen:
```
resource.type = 'compute.googleapis.com/Reservation' AND metric.type = 'compute.googleapis.com/reservation/used' AND metadata.system.name = 'RESERVATION_NAME'
```
AUTO_CLOSE_TIME: Die Zeit in Sekunden, bis ein Vorfall automatisch geschlossen wird. Der Wert muss zwischen 0s und 604800s (7 Tage) liegen. Geben Sie beispielsweise 259200s (3 Tage) ein.
NOTIFICATION_CHANNEL: Der Name eines vorhandenen Benachrichtigungskanals. Informationen zum Einrichten eines Benachrichtigungskanals finden Sie unter Benachrichtigungskanäle erstellen und verwalten.

Weitere Informationen zu den Optionen, die Sie beim Erstellen von Benachrichtigungsrichtlinien mit der Monitoring API und mit Basic Query haben, finden Sie unter Benachrichtigungsrichtlinien mit der API erstellen.

MQL

Im folgenden Beispiel wird eine Benachrichtigungsrichtlinie erstellt, die eine Benachrichtigung sendet, wenn der Anteil der verwendeten VMs an den reservierten VMs in Ihren Reservierungen über 90 % liegt.

Console

So erstellen Sie eine Monitoring-Benachrichtigungsrichtlinie mit MQL:

Wechseln Sie in der Google Cloud Console zu Benachrichtigungen.

Zu Benachrichtigungen
Klicken Sie auf Richtlinie erstellen.

Die Seite Benachrichtigungsrichtlinie erstellen wird geöffnet.
Klicken Sie in der Symbolleiste auf MQL.

Der Bereich Abfrage bearbeiten wird angezeigt.
Geben Sie im Bereich Abfrage bearbeiten eine MQL-Abfrage ein.

Wenn Sie beispielsweise eine Abfrage erstellen möchten, die Ihre Reservierungen nach Namen gruppiert und eine Benachrichtigungsbedingung auslöst, wenn mehr als 90 % Ihrer Reservierungen genutzt werden, geben Sie die folgende Abfrage ein:
```
fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
    | group_by [metadata.system.name], sliding(1m), max(value.used)
  ; metric compute.googleapis.com/reservation/reserved
    | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio
| every 1m
| condition gt(val(), 0.9)
```
Wichtig: Zum Erstellen einer MQL-basierten Benachrichtigungsbedingung müssen Sie einen der folgenden Operatoren am Ende der Abfrage verwenden:
- Geben Sie für Grenzwertbenachrichtigungen condition an.
- Geben Sie für Abwesenheitsbenachrichtigungen absent_for an.
Wenn Sie eine Abfrage ohne einen dieser Operatoren ausführen, werden dadurch Fehler verursacht. Weitere Informationen finden Sie unter MQL-Benachrichtigungsvorgänge.
Klicken Sie auf Abfrage ausführen, um die soeben eingegebene Abfrage auszuführen.
Klicken Sie auf Next (Weiter).

Der Bereich Benachrichtigungstrigger konfigurieren wird angezeigt.
Geben Sie unter Bedingungsname einen Namen für die Bedingung ein.

Geben Sie beispielsweise Over 90% of your reservations are consumed. ein.
Klicken Sie noch einmal auf Weiter.

Der Bereich Benachrichtigungen konfigurieren und Benachrichtigung abschließen wird angezeigt.
Klicken Sie auf Benachrichtigungskanäle verwenden.
Wählen Sie im Feld Benachrichtigungskanäle die Kanäle aus, über die Sie über den Vorfall benachrichtigt werden möchten.

Wenn keine Benachrichtigungskanäle verfügbar sind, klicken Sie auf Benachrichtigungskanäle verwalten und folgen Sie den Schritten zum Erstellen von Benachrichtigungskanälen. Weitere Informationen finden Sie unter Benachrichtigungskanäle erstellen und verwalten.
Wählen Sie im Feld Dauer bis zur automatischen Schließung von Vorfällen eine Dauer aus, nach der ein Vorfall automatisch geschlossen wird.

Wählen Sie beispielsweise 3 Tage aus.
Geben Sie im Feld Name der Benachrichtigungsrichtlinie einen Namen für die Benachrichtigungsrichtlinie ein.

Geben Sie beispielsweise Alert: over 90% of your reservations are consumed. ein.
Klicken Sie auf Next (Weiter).

Die Überprüfungsseite der Benachrichtigungsbedingung wird geöffnet.
Klicken Sie auf Richtlinie erstellen.

Das Erstellen der Benachrichtigungsrichtlinie kann einige Sekunden dauern. Durch diese Aktion wird wieder die Seite Benachrichtigungsrichtlinie erstellen angezeigt.

Weitere Informationen zum Erstellen von Benachrichtigungsrichtlinien mit der Google Cloud Console und MQL finden Sie unter MQL-Benachrichtigungsrichtlinien erstellen (Console).

REST

Senden Sie zum Erstellen einer Monitoring-Benachrichtigungsrichtlinie mit MQL die Anfrage POST an die Methode projects.alertPolicies.create.

POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies

{
  "displayName": "Alert: over 90% of your reservations are consumed.",
  "conditions": [
    {
      "displayName": "Over 90% of your reservations are consumed.",
      "conditionMonitoringQueryLanguage": {
        "duration": "0s",
        "trigger": {
          "count": 1
        },
        "query": "MQL_QUERY"
      }
    }
  ],
  "alertStrategy": {
    "autoClose": "AUTO_CLOSE_TIME"
  },
  "combiner": "OR",
  "enabled": true,
  "notificationChannels": [
    "projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
  ]
}

Ersetzen Sie Folgendes:

PROJECT_ID: Die Projekt-ID des aktuellen Projekts.
MQL_QUERY: Eine MQL-Abfrage, die für die Benachrichtigungsrichtlinie verwendet werden soll. Wenn Sie beispielsweise eine Abfrage erstellen möchten, die verfolgt, wenn der Anteil der verwendeten VMs an den reservierten VMs in den Reservierungen des aktuellen Projekts über 90% liegt, geben Sie Folgendes an:
```
fetch compute.googleapis.com/Reservation
| { metric compute.googleapis.com/reservation/used
 | group_by [metadata.system.name], sliding(1m), max(value.used)
; metric compute.googleapis.com/reservation/reserved
 | group_by [metadata.system.name], sliding(1m), max(value.reserved) }
| ratio
| every 1m
| condition gt(val(), 0.9)
```
Wichtig: Achten Sie auf Folgendes:
- Wenn Sie eine MQL-Abfrage angeben möchten, die sich über mehrere Zeilen im Feld query erstreckt, fügen Sie das Zeichen \n am Ende jeder Zeile hinzu.
- Zum Erstellen einer Benachrichtigungsbedingung mit einer MQL-Abfrage müssen Sie einen der folgenden Operatoren am Ende der Abfrage verwenden:
  - Geben Sie für Grenzwertbenachrichtigungen condition an.
  - Geben Sie für Abwesenheitsbenachrichtigungen absent_for an.
  Wenn Sie eine Abfrage ohne einen dieser Operatoren ausführen, werden dadurch Fehler verursacht. Weitere Informationen finden Sie unter MQL-Benachrichtigungsvorgänge.
AUTO_CLOSE_TIME: Die Zeit in Sekunden, bis ein Vorfall automatisch geschlossen wird. Der Wert muss zwischen 0s und 604800s (7 Tage) liegen. Geben Sie beispielsweise 259200s (3 Tage) ein.
NOTIFICATION_CHANNEL: Der Name eines vorhandenen Benachrichtigungskanals. Informationen zum Einrichten eines Benachrichtigungskanals finden Sie unter Benachrichtigungskanäle erstellen und verwalten.

Weitere Informationen zum Erstellen von Benachrichtigungsrichtlinien mit der Monitoring API und MQL finden Sie unter MQL-Benachrichtigungsrichtlinien erstellen (API).

Fehlerbehebung

Probleme mit der Überwachung von Reservierungen beheben

Nutzung von Reservierungen überwachen

Hinweise

Console

REST

Erforderliche Rollen

Erforderliche Berechtigungen

Einschränkungen

Reservierungsmesswerte

Reservierungsfilter

Nutzung von Reservierungen überwachen

Dashboard erstellen

Basic Query

Console

REST

MQL

Console

REST

Benachrichtigungsrichtlinien erstellen

Basic Query

Console

REST

MQL

Console

REST

Fehlerbehebung

Nächste Schritte