In diesem Dokument wird beschrieben, wie Sie Schlummerfunktionen erstellen und verwalten. Eine Schlummerfunktion verhindert, dass Cloud Monitoring während eines bestimmten Zeitraums Vorfälle erstellt und Benachrichtigungen sendet. Jede Schlummerfunktion gibt die Ressourcen an, für die sie gilt.
Eine konzeptionelle Übersicht finden Sie unter Benachrichtigungen und Benachrichtigungen pausieren.
Zum Erstellen und Verwalten von Schlummern können Sie die Google Cloud Console oder die Cloud Monitoring API verwenden.
Hinweise
Prüfen Sie, ob Sie die erforderlichen Berechtigungen haben:
-
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (
roles/monitoring.editor
) für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Ansehen und Bearbeiten von Schlummerfunktionen über die Google Cloud Console benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
-
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Bearbeiter von Monitoring-Schlummerfunktionen (
roles/monitoring.snoozeEditor
) für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Ansehen und Bearbeiten von Schlummerfunktionen mithilfe der Cloud Monitoring API benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Weitere Informationen zu Cloud Monitoring-Rollen finden Sie unter Zugriff mit Identity and Access Management steuern.
-
Wenn Sie die Cloud Monitoring API-Beispiele in diesem Dokument verwenden möchten, gehen Sie so vor:
Erstellen Sie die Umgebungsvariable
PROJECT_ID
für die ID Ihres Google Cloud-Projekts:PROJECT_ID=PROJECT_ID
Authentifizieren Sie sich bei der Google Cloud CLI:
gcloud auth login
Legen Sie das Google Cloud-Standardprojekt fest:
gcloud config set project ${PROJECT_ID}
Erstellen Sie ein Autorisierungstoken:
ACCESS_TOKEN=`gcloud auth print-access-token`
Sie müssen das Zugriffstoken regelmäßig aktualisieren. Wenn vorher funktionierende Befehle plötzlich melden, dass Sie nicht authentifiziert sind, geben Sie diesen Befehl noch einmal ein.
Schlummerfunktion erstellen
Wenn Sie verhindern möchten, dass durch Benachrichtigungsrichtlinien Vorfälle erstellt und Benachrichtigungen gesendet werden, erstellen Sie eine Schlummerfunktion.
Sie können eine Schlummerfunktion mit der Google Cloud Console, der gcloud CLI oder der Cloud Monitoring API erstellen.
Console
-
Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend notifications Benachrichtigungen aus:
- So erstellen Sie eine Schlummerfunktion aus einem offenen Vorfall:
- Suchen Sie auf der Seite "Benachrichtigungen" im Bereich Vorfälle nach dem Vorfall und klicken Sie auf die Zusammenfassung des Vorfalls.
- Klicken Sie auf der Seite Vorfalldetails auf Schlummern und wählen Sie die Dauer der Schlummerfunktion aus. Andere Felder können nicht konfiguriert werden.
Gehen Sie andernfalls so vor:
- Klicken Sie auf der Seite Benachrichtigungen auf Schlummerfunktion erstellen.
- Geben Sie einen aussagekräftigen Namen für die Schlummerfunktion ein. Dieser Name wird auf der Seite Benachrichtigungen angezeigt.
- Wählen Sie eine Beginn aus. Sie können eine bestimmte Zeit eingeben oder die Schlummerfunktion beim Erstellen der Schlummerfunktion starten.
- Geben Sie die Dauer ein. Der Wert dieses Feldes bestimmt, wie lange die Schlummerfunktion dauert.
Füllen Sie den Abschnitt Kriterien für die Zurückstellung aus. Im Menü Benachrichtigungsrichtlinien können Sie die Benachrichtigungsrichtlinien auswählen, für die die Schlummerfunktion gilt.
Sie können einer Schlummerfunktion bis zu 16 Benachrichtigungsrichtlinien hinzufügen.
Nachdem Sie den Abschnitt Kriterien für Schlummerfunktion abgeschlossen haben, werden im Bereich Schlummerfunktion erstellen frühere Vorfälle aufgelistet, die den Kriterien entsprechen.
Klicken Sie auf Erstellen.
Cloud Monitoring API
Rufen Sie zum Erstellen einer Schlummerfunktion die Methode snoozes.create
auf. Senden Sie dazu eine POST
-Anfrage an den Endpunkt Snooze
.
Sie müssen ein snooze
-Objekt angeben:
curl -d @my-snooze.json -H "Authorization: Bearer $ACCESS_TOKEN" \ -H 'Content-Type: application/json' \ -X POST https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes
Die Methode gibt ein snooze
-Objekt zurück. Das Feld "name"
, das die von Monitoring generierte Schlummer-ID enthält, ist der einzige Unterschied zwischen dem zurückgegebenen Objekt und dem Inhalt von my-snooze.json
:
{
"name": "projects/my-project/snoozes/2986666341878464512",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/787884840895011889"
]
},
"interval": {
"startTime": "2022-11-12T19:00:20Z",
"endTime": "2022-11-12T19:05:20Z"
},
"displayName": "Snooze2"
}
gcloud-CLI
Führen Sie zum Erstellen einer Schlummerfunktion den Befehl gcloud monitoring snoozes create
aus:
gcloud monitoring snoozes create --criteria-policies=LIST_OF_POLICIES --display-name=DISPLAY_NAME --start-time=START_TIME --end-time=END_TIME
Im vorherigen Befehl muss der end-time
mindestens eine Minute später als der start-time
liegen. Sie müssen sich an die Formatierungsregeln nach ISO 8601 halten, können aber auch absolute oder relative Zeiten angeben. Im folgenden Beispiel werden absolute Zeiten angegeben. Verwenden Sie --start-time="+PTM30M"
, um eine Schlummerfunktion in einem Zeitraum von 30 Minuten ab der aktuellen Uhrzeit zu starten.
Wenn Sie mehrere Projekte angeben, trennen Sie diese durch Kommas.
Der folgende Befehl erstellt beispielsweise eine Schlummerfunktion mit dem Anzeigenamen „Wartungswoche“. Die Schlummerfunktion gilt für zwei Benachrichtigungsrichtlinien und umfasst das Zeitintervall vom 1. März bis zum 7. März:
gcloud monitoring snoozes create --display-name="Maintenance Week" \ --criteria-policies="projects/my-project/alertPolicies/12345,projects/my-project/alertPolicies/23451" \ --start-time="2023-03-01T03:00:00.0-0500" \ --end-time="2023-03-07T23:59:59.5-0500"
Im vorherigen Beispiel wird die folgende Schlummerfunktion in my-project
erstellt:
{ "name": "projects/my-project/snoozes/98765", "displayName": "Maintenance Week", "interval": { "startTime": "2023-03-01T08:00:00Z", "endTime": "2023-03-08T04:59:59Z" }, "criteria": { "policies": [ "projects/my-project/alertPolicies/12345", "projects/my-project/alertPolicies/23451", ] } }
Wenn der Befehl erfolgreich ausgeführt wurde, sieht die Antwort in etwa so aus:
Created snooze [projects/my-project/snoozes/98765]
Der Name einer Benachrichtigungsrichtlinie wird in der Google Cloud Console nicht angezeigt. Führen Sie einen der folgenden Schritte aus, um den Namen einer Benachrichtigungsrichtlinie zu ermitteln:
- Führen Sie den Befehl
gcloud alpha monitoring policies list
aus: Die Antwortdaten dieses Befehls enthalten den Namen der Benachrichtigungsrichtlinien. - Sehen Sie sich die JSON-Darstellung einer Benachrichtigungsrichtlinie an. Sie können die JSON-Darstellung mithilfe einer Option auf der Seite Richtliniendetails auf Ihr lokales System herunterladen.
Wiederkehrende Schlummerfunktionen erstellen
Zum Erstellen von Schlummerfunktionen, die über wiederkehrende Intervalle erfolgen, können Sie ein Skript schreiben, das eine Schlummerfunktion für eine Benachrichtigungsrichtlinie erstellt. Verwenden Sie dann einen Job-Planer wie cron
oder Cloud Scheduler, um das Skript nach dem erforderlichen Zeitplan auszuführen.
Schlummerfunktionen auflisten
Wenn Sie eine Schlummerfunktion erstellen, wird sie dem Verlauf der Schlummerfunktionen für Ihr Projekt hinzugefügt. Dieser Eintrag zeigt die abgelaufenen, aktiven und anstehenden Schlummerfunktionen. Sie können keine Einträge aus diesem Eintrag entfernen, d. h. eine Schlummerfunktion nicht löschen. In dieser Ansicht können Sie jedoch die Details einer Schlummerfunktion anzeigen und Aktionen wie das Bearbeiten oder Kopieren der Schlummerfunktion ausführen.
Console
So rufen Sie eine Liste der Schlummerfunktionen auf:
-
Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend notifications Benachrichtigungen aus:
Klicken Sie im Bereich Schlummern auf Alle Schlummerfunktionen anzeigen.
Auf der Seite Schlummerfunktion werden eine Liste der Schlummerfunktion und eine Zeitachse mit vergangenen, anstehenden und aktiven Schlummern angezeigt.
- Wenn Sie eine Schlummerfunktion bearbeiten, kopieren, abbrechen oder beenden möchten, verwenden Sie das Menü more_vert Weitere Optionen für die Schlummerfunktion. Der Schlummerstatus bestimmt, welche Optionen verfügbar sind.
- Wenn alle Schlummerfunktionen angezeigt werden sollen, aktivieren Sie Frühere Schlummerfunktionen anzeigen. Standardmäßig werden nur aktive und anstehende Schlummerfunktionen aufgeführt.
- Über das Menü Zeitraum können Sie den Anzeigezeitraum für die Tabelle Zeitachse ändern. Standardmäßig werden in der Tabelle Daten für die nächste Stunde angezeigt. Sie können dieses Feld jedoch ändern, um vergangene oder zukünftige Zeiträume anzugeben. Abgelaufene Schlummerfunktionen werden 13 Monate lang aufbewahrt.
- Wenn Sie sich Details zu einer bestimmten Schlummerfunktion ansehen möchten, klicken Sie auf Details ansehen.
- Bewegen Sie den Mauszeiger in der Tabelle Zeitachse auf den schattierten Bereich der Zeile Aktiv, um eine Zusammenfassung der aktiven Schlummerfunktionen aufzurufen. Die Kurzinfo enthält die zusammenfassenden Informationen.
- Maximieren Sie in der Tabelle Zeitachse die Zeile Aktiv, um eine grafische Darstellung aktiver Schlummerfunktionen zu sehen.
Cloud Monitoring API
Rufen Sie die Methode snoozes.list
auf, um alle Schlummerfunktionen aufzulisten, die zu einem Google Cloud-Projekt gehören:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes
Die Methode gibt eine Liste von snooze
-Objekten zurück. Wenn ein Projekt beispielsweise eine Schlummerfunktion hat, sieht die Antwort auf den Befehl snoozes.list
in etwa so aus:
{
"snoozes": [
{
"name": "projects/my-project/snoozes/2986663705844383744",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/787884840895011889"
]
},
"interval": {
"startTime": "2022-11-08T19:00:20Z",
"endTime": "2022-11-08T19:05:20Z"
},
"displayName": "Snooze1"
}
]
}
Wenn Sie Informationen zu einer bestimmten Schlummerfunktion abrufen möchten, rufen Sie die Methode snoozes.get
auf und geben Sie die Projekt-ID sowie die ID für die Schlummerfunktion an. In der vorherigen Antwort lautet die Schlummer-ID 2986663705844383744
:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}
Die Methode gibt ein einzelnes snooze
-Objekt zurück:
{
"name": "projects/my-project/snoozes/2986663705844383744",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/787884840895011889"
]
},
"interval": {
"startTime": "2022-11-08T19:00:20Z",
"endTime": "2022-11-08T19:05:20Z"
},
"displayName": "Snooze1"
}
gcloud-CLI
Führen Sie den Befehl gcloud monitoring snoozes list
aus, um die Schlummerfunktionen in Ihrem aktuellen Projekt aufzulisten:
gcloud monitoring snoozes list OPTIONAL_FLAGS
Informationen zu den optionalen Flags finden Sie auf der Referenzseite zu gcloud monitoring snoozes list
.
Die Antwort auf diesen Befehl ist eine im YAML-Format formatierte Liste von Namen von Schlummern im Projekt. Die Antwort auf diesen Befehl für das Google Cloud-Projekt mit der ID my-project
ist beispielsweise ein einzelner Eintrag:
criteria: policies: - projects/my-project/alertPolicies/12345 - projects/my-project/alertPolicies/23451 displayName: Maintenance Week interval: endTime: '2023-03-08T04:59:59Z' startTime: '2023-03-01T08:00:00Z' name: projects/my-project/snoozes/98765
Führen Sie den Befehl gcloud monitoring snoozes describe
aus, um Details zu einer bestimmten Schlummerfunktion aufzulisten:
gcloud monitoring snoozes describe NAME
Wenn Sie beispielsweise die Details zur Schlummerfunktion mit dem Namen projects/my-project/snoozes/98765
aufrufen möchten, führen Sie den folgenden Befehl aus:
gcloud monitoring snoozes describe projects/my-project/snoozes/98765
Wenn Sie einen ungültigen NAME-Befehl für einen describe
-Befehl angeben, enthält die Antwort den Fehlercode 500
und die folgende Nachricht:
Internal error encountered. Please retry after a few seconds. If internal errors persist, contact support at https://cloud.google.com/support/docs.
Schlummerfunktion bearbeiten
Sie können den Namen und den Zeitraum einer anstehenden Schlummerfunktion sowie den Namen und die Endzeit einer aktiven Schlummerfunktion bearbeiten. Wenn beispielsweise ein Wartungsfenster verschoben wird, müssen Sie möglicherweise eine Schlummerfunktion bearbeiten.
Sie können eine frühere Schlummerfunktion oder die Kriterien einer Schlummerfunktion nicht bearbeiten. Wenn Sie jedoch eine vergangene Schlummerfunktion für einen zukünftigen Zeitraum planen möchten, kopieren Sie sie und wenden Sie die Änderungen an der Kopie an, bevor Sie auf Erstellen klicken.
Console
So bearbeiten Sie eine Schlummerfunktion:
-
Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend notifications Benachrichtigungen aus:
- Klicken Sie im Bereich Schlummern auf Alle Schlummerfunktionen anzeigen.
- Suchen Sie in der Liste der Schlummerfunktionen nach der zu bearbeitenden Schlummerfunktion und wählen Sie dann im Menü Weitere Optionen more_vert die Option Schlummerfunktion bearbeiten aus.
- Klicken Sie auf Speichern, wenn Sie die Änderungen vorgenommen haben.
Cloud Monitoring API
Rufen Sie die Methode snoozes.patch
auf, indem Sie eine PATCH
-Anfrage an den Endpunkt Snooze
senden, um eine vorhandene Schlummerfunktion zu ändern.
Sie müssen das überarbeitete snooze
-Objekt angeben und Abfrageparameter angeben, die angeben, welche Felder geändert werden. Bei der Verwendung von curl müssen Abfrageparameter URL-codiert sein.
Für anstehende Schlummerfunktionen können Sie den Namen und den Zeitraum ändern. Bei aktiven Schlummern können Sie den Namen und die Endzeit ändern. Frühere Schlummerfunktionen können nicht mehr geändert werden.
Zum Aktualisieren des displayName
einer Schlummerfunktion erstellen Sie die JSON-Datei my-updated-snooze.json
, die das Objekt für die Schlummerfunktion beschreibt und den Anzeigenamen aktualisiert. Führen Sie dann den folgenden Befehl aus:
curl -d @my-updated-snooze.json -H "Authorization: Bearer $ACCESS_TOKEN" \ -H 'Content-Type: application/json' \ -X PATCH https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}?updateMask=displayName
Die Methode gibt ein snooze
-Objekt zurück, das mit dem Inhalt der Datei my-updated-snooze.json
identisch ist:
{
"name": "projects/my-project/snoozes/2986665388391530496",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/7164333552684403347"
]
},
"interval": {
"startTime": "2022-11-08T22:26:05Z",
"endTime": "2022-11-08T22:31:05Z"
},
"displayName": "Updated snooze name"
}
gcloud-CLI
Führen Sie den Befehl gcloud monitoring snoozes update
aus, um eine Schlummerfunktion zu bearbeiten. Sie können den Anzeigenamen sowie die Start- und Endzeit aktualisieren:
gcloud monitoring snoozes update NAME OPTIONAL_FLAGS
Eine Liste der Optionen für den Befehl update
finden Sie auf der Referenzseite zu gcloud monitoring snoozes update
.
Wenn Sie beispielsweise den Anzeigenamen der Schlummerfunktion auf den Namen projects/my-project/snoozes/98765
ändern möchten, führen Sie den folgenden Befehl aus:
gcloud monitoring snoozes update projects/my-project/snoozes/98765 --display-name="March Maintenance"
Schlummerfunktion beenden oder abbrechen
Wenn Sie Benachrichtigungen für Ressourcen erhalten möchten, die die in einer aktiven Schlummerfunktion angegebenen Kriterien erfüllen, beenden Sie die Schlummerfunktion. Wenn beispielsweise geplante Wartungsarbeiten schneller als erwartet abgeschlossen werden, können Sie eine Schlummerfunktion beenden.
Wenn eine Schlummerfunktion für Sie nicht mehr relevant ist, können Sie sie abbrechen. Der Abbruchvorgang setzt die Dauer auf null und führt dazu, dass die Schlummerfunktion in den Status Past übergeht.
Console
So beenden Sie eine aktive Schlummerfunktion oder brechen eine anstehende Schlummerfunktion ab:
-
Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend notifications Benachrichtigungen aus:
- Klicken Sie im Bereich Schlummern auf Alle Schlummerfunktionen anzeigen.
Suchen Sie in der Liste der Schlummerfunktionen, die Sie beenden oder abbrechen möchten, und führen Sie dann einen der folgenden Schritte aus:
- Wenn Sie eine aktive Schlummerfunktion beenden möchten, wählen Sie im Menü more_vert Weitere Optionen die Option Jetzt beenden aus.
- Wenn Sie eine anstehende Schlummerfunktion abbrechen möchten, wählen Sie im Menü more_vert Weitere Optionen die Option Schlummerfunktion abbrechen aus.
Cloud Monitoring API
Wenn Sie eine aktive Schlummerfunktion beenden möchten, bearbeiten Sie sie und legen Sie das Ende auf die aktuelle Zeit fest. Weitere Informationen finden Sie unter Schlummerfunktion bearbeiten.
Wenn Sie eine anstehende Schlummerfunktion abbrechen möchten, bearbeiten Sie sie und legen Sie das Ende auf den Beginn der Schlummerfunktion fest. Der Beginn muss in der Zukunft liegen. Weitere Informationen finden Sie unter Schlummerfunktion bearbeiten.
gcloud-CLI
Führen Sie den Befehl gcloud monitoring snoozes cancel
aus, um eine aktive Schlummerfunktion zu beenden oder eine anstehende Schlummerfunktion abzubrechen:
gcloud monitoring snoozes cancel NAME
Wenn Sie beispielsweise die Schlummerfunktion mit dem Namen projects/my-project/snoozes/98765
abbrechen möchten, führen Sie den folgenden Befehl aus:
gcloud monitoring snoozes cancel projects/my-project/snoozes/98765
Schlummerfunktion kopieren
Wenn Sie eine vorhandene Schlummerfunktion als Vorlage für eine weitere Schlummerfunktion verwenden möchten, erstellen Sie eine Kopie. Wenn Sie eine Schlummerfunktion kopieren, wird der Schlummereditor mit allen Feldern außer der Startzeit geöffnet, die auf die Werte der ursprünglichen Schlummerfunktion festgelegt ist. Sie können alle Felder ändern, bevor Sie auf Erstellen klicken.
So kopieren Sie eine Schlummerfunktion über die Console:
-
Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend notifications Benachrichtigungen aus:
- Klicken Sie im Bereich Schlummern auf Alle Schlummerfunktionen anzeigen.
- Suchen Sie in der Liste der Schlummerfunktion nach der Schlummerfunktion, die Sie bearbeiten möchten, und wählen Sie dann im Menü Weitere Optionen more_vert die Option Schlummerfunktion kopieren aus.
- Wenden Sie Ihre Änderungen auf die Kopie an und klicken Sie dann auf Erstellen.
Nächste Schritte
Einen Überblick über Benachrichtigungen finden Sie unter Benachrichtigungen – Übersicht.
Informationen zur Benachrichtigungslatenz und dazu, wie sich die Auswahl der Parameter einer Benachrichtigungsrichtlinie auf das Senden von Benachrichtigungen auswirkt, finden Sie unter Verhalten von messwertbasierten Benachrichtigungsrichtlinien.
Informationen zu Vorfällen finden Sie in den folgenden Dokumenten: