Einführung in Benachrichtigungen

Durch Benachrichtigungen werden Sie rechtzeitig über Probleme in Ihren Cloudanwendungen informiert und können sie dann umgehend beheben.

In Cloud Monitoring wird in einer Benachrichtigungsrichtlinie beschrieben, unter welchen Umständen und wie Sie benachrichtigt werden möchten. Auf dieser Seite erhalten Sie eine Übersicht über Benachrichtigungsrichtlinien.

Benachrichtigungsrichtlinien, mit denen von Cloud Monitoring erfasste Messwertdaten verfolgt werden, werden als messwertbasierte Benachrichtigungsrichtlinien bezeichnet. Der Großteil der Cloud Monitoring-Dokumentation zu Benachrichtigungsrichtlinien setzt voraus, dass Sie messwertbasierte Benachrichtigungsrichtlinien verwenden. Informationen zum Einrichten einer messwertbasierten Benachrichtigungsrichtlinie finden Sie in der Kurzanleitung für Compute Engine.

Sie können auch logbasierte Benachrichtigungsrichtlinien erstellen, die Sie benachrichtigen, wenn eine bestimmte Nachricht in Ihren Logs angezeigt wird. Diese Richtlinien basieren nicht auf Messwerten. Dieser Inhalt gilt nicht für logbasierte Benachrichtigungsrichtlinien. Informationen zu logbasierten Benachrichtigungsrichtlinien finden Sie unter Logs überwachen.

Funktionsweise von Benachrichtigungen

Jede Benachrichtigungsrichtlinie gibt Folgendes an:

  • Bedingungen, die beschreiben, wann eine Ressource oder eine Gruppe von Ressourcen in einem Status ist, den Sie beantworten müssen. Eine Benachrichtigungsrichtlinie muss mindestens eine Bedingung haben. Sie können eine Richtlinie jedoch so konfigurieren, dass sie mehrere Bedingungen enthält.

    Sie können zum Beispiel eine Bedingung so konfigurieren:

    The HTTP response latency is higher than two seconds for at least five minutes.
    

    In diesem Beispiel beobachtet die Bedingung die HTTP-Antwortlatenz und gibt an, wann die Werte des Messwerts antworten müssen. Die Bedingung ist erfüllt, wenn sich die Ressource oder die Ressourcengruppe in einem Zustand befindet, in dem Sie antworten müssen.

  • Benachrichtigungskanäle, die beschreiben, wer benachrichtigt werden soll, wenn eine Aktion erforderlich ist. Sie können mehrere Benachrichtigungskanäle in eine Benachrichtigungsrichtlinie aufnehmen. Cloud Monitoring unterstützt Cloud Mobile App und Pub/Sub zusätzlich zu gängigen Benachrichtigungskanälen. Eine vollständige Liste der unterstützten Kanäle und Informationen zum Konfigurieren dieser Kanäle finden Sie unter Benachrichtigungsoptionen.

    Sie können beispielsweise eine Benachrichtigungsrichtlinie konfigurieren, um eine E-Mail an my-support-team@example.com zu senden und eine Slack-Nachricht im Kanal #my-support-team zu posten.

  • Dokumentation, die in einer Benachrichtigung enthalten sein soll. Im Dokumentationsfeld werden nur Text, Markdown und Variablen unterstützt.

    Sie können in die Benachrichtigungsrichtlinie beispielsweise die folgende Dokumentation einfügen:

    ## HTTP latency responses
    
    This alert originated from the project ${project}, using
    the variable $${project}.
    

Nachdem eine messwertbasierte Benachrichtigungsrichtlinie konfiguriert wurde, überwacht Monitoring kontinuierlich die Bedingungen dieser Richtlinie. Sie können die Bedingungen nicht so konfigurieren, dass sie nur für bestimmte Zeiträume überwacht werden.

Wenn die Bedingungen dieser Richtlinie erfüllt sind, erstellt Monitoring einen Vorfall und sendet eine Benachrichtigung über die Erstellung des Vorfalls. Diese Benachrichtigung enthält zusammenfassende Informationen zum Vorfall, einen Link zur Seite Richtliniendetails, damit Sie den Vorfall untersuchen können, sowie eine beliebige Dokumentation, die Sie angegeben haben.

Wenn ein Vorfall geöffnet ist und Monitoring feststellt, dass die Bedingungen der messwertbasierten Richtlinie nicht mehr erfüllt sind, schließt Monitoring den Vorfall automatisch und sendet eine Benachrichtigung über den Abschluss.

Beispiel

Sie stellen eine Webanwendung auf einer Compute Engine-VM-Instanz bereit, auf der eine Webanwendung ausgeführt wird. Während Sie davon ausgehen, dass die HTTP-Antwortlatenz schwankt, möchten Sie, dass Ihr Supportteam antwortet, wenn die Anwendung über einen erheblichen Zeitraum eine hohe Latenz aufweist.

Damit das Supportteam benachrichtigt wird, wenn Ihre Anwendung hohe Latenzen aufweist, erstellen Sie die folgende Benachrichtigungsrichtlinie:

  If the HTTP response latency is higher than two seconds for at least five
  minutes, then open an incident and send an email to your support team.

In dieser Benachrichtigungsrichtlinie überwacht die Bedingung die HTTP-Antwortlatenz. Wenn diese Latenz fünf Minuten lang kontinuierlich mehr als zwei Sekunden beträgt, ist die Bedingung erfüllt und ein Vorfall wird erstellt. Ein vorübergehender Anstieg der Latenz führt nicht dazu, dass die Bedingung erfüllt ist oder ein Vorfall erstellt wird.

Ihre Webanwendung erweist sich als beliebt und die Antwortlatenz nimmt über zwei Sekunden hinaus zu. So reagiert dann Ihre Benachrichtigungsrichtlinie:

  1. Das Monitoring startet einen Fünf-Minuten-Timer, wenn die HTTP-Latenz länger als zwei Sekunden gemessen wird.

  2. Wenn jede in den nächsten fünf Minuten empfangene Latenzmessung mehr als zwei Sekunden beträgt, läuft der Timer ab. Wenn der Timer abläuft, markiert Monitoring die Bedingung als erfüllt, erstellt einen Vorfall und sendet eine E-Mail an Ihr Supportteam.

  3. Ihr Supportteam erhält die E-Mail, meldet sich bei der Cloud Console an und bestätigt den Erhalt der Benachrichtigung.

  4. Anhand der Dokumentation in der Benachrichtigungs-E-Mail kann Ihr Supportteam die Ursache der Latenz ermitteln und beheben. Innerhalb weniger Minuten sinkt die HTTP-Antwortlatenz auf weniger als zwei Sekunden.

  5. Wenn in Monitoring eine HTTP-Latenzmessung von weniger als zwei Sekunden empfangen wird, wird der Vorfall geschlossen und Ihr Supportteam wird darüber benachrichtigt, dass der Vorfall geschlossen wurde.

Wenn die Latenz über zwei Sekunden steigt und diesen 5 Minuten lang höher als diese Schwelle überschreitet, wird ein neuer Vorfall geöffnet und eine Benachrichtigung gesendet.

Benachrichtigungsrichtlinie hinzufügen

Sie können Ihrem Google Cloud-Projekt eine messwertbasierte Benachrichtigungsrichtlinie mithilfe der Google Cloud Console, der Cloud Monitoring API oder des Cloud SDK hinzufügen:

  • Wenn Sie die Cloud Console verwenden, können Sie eine empfohlene Benachrichtigung aktivieren oder eine Benachrichtigung erstellen, indem Sie auf der Seite Benachrichtigungen von Cloud Monitoring beginnen.

    Empfohlene Benachrichtigungen sind für einige Google Cloud-Produkte verfügbar. Diese Benachrichtigungen erfordern eine minimale Konfiguration, z. B. das Hinzufügen von Benachrichtigungskanälen. Die Seite Themen von Pub/Sub Lite enthält beispielsweise Links zu Benachrichtigungen, die so konfiguriert sind, dass Sie informiert werden, wenn Sie ein Kontingentlimit erreichen. Die Seite VM-Instanzen in Monitoring enthält ebenfalls Links zu Benachrichtigungsrichtlinien, die zur Überwachung der Speicherauslastung und der Netzwerklatenz dieser Instanzen konfiguriert sind.

    Jede Richtlinie, die Sie mit der Cloud Console erstellen, können Sie auch mit der Cloud Console oder der Cloud Monitoring API ändern. Mit der Cloud Monitoring API können Sie Benachrichtigungsrichtlinien erstellen, die das Verhältnis von Messwerten überwachen. Wenn diese Richtlinien Monitoring-Filter verwenden, können Sie sie nicht in der Cloud Console ansehen oder ändern.

    Informationen zum Erstellen einer Benachrichtigungsrichtlinie auf der Seite Benachrichtigungen von Cloud Monitoring finden Sie unter Benachrichtigungsrichtlinien über die Cloud Console erstellen.

  • Wenn Sie die Cloud Monitoring API direkt oder bei Verwendung des Cloud SDK verwenden, können Sie Benachrichtigungsrichtlinien erstellen, aufrufen und ändern. Sie können mit der Cloud Monitoring API oder dem Cloud SDK Bedingungen erstellen, mit denen ein Verhältnis von Messwerten überwacht wird. Wenn Sie die Cloud Monitoring API verwenden, können Sie das Verhältnis mithilfe von Monitoring Query Language (MQL) oder mit Monitoring-Filtern angeben. Ein Beispiel für eine Richtlinie, die Monitoring-Filter verwendet, finden Sie unter Messwertverhältnis.

    Weitere Informationen zur Verwendung der Cloud Monitoring API und des Cloud SDK finden Sie unter Benachrichtigungsrichtlinien mit der Cloud Monitoring API oder dem Cloud SDK erstellen.

Cloud Monitoring unterstützt eine ausdrucksstarke, textbasierte Sprache, die mit der Google Cloud Console und mit der Cloud Monitoring API verwendet werden kann. Informationen zur Verwendung dieser Sprache mit Benachrichtigungen finden Sie unter Benachrichtigungsrichtlinien mit Monitoring Query Language (MQL) erstellen.

Sie können Ihrem Google Cloud-Projekt eine logbasierte Benachrichtigungsrichtlinie mithilfe des Log-Explorers in Cloud Logging oder mithilfe der Monitoring API hinzufügen. Dieser Inhalt gilt nicht für logbasierte Benachrichtigungsrichtlinien. Informationen zu logbasierten Benachrichtigungsrichtlinien finden Sie unter Logs überwachen.

Benachrichtigungsrichtlinien verwalten

Informationen zum Anzeigen einer Liste der messwertbasierten Benachrichtigungsrichtlinien Ihres Projekts und zum Ändern dieser Richtlinien finden Sie hier:

Weitere Informationen zum Verwalten von logbasierten Benachrichtigungsrichtlinien finden Sie unter Logbasierte Benachrichtigungen verwenden.

Zum Erstellen von Benachrichtigungsrichtlinien erforderliche Autorisierung

In diesem Abschnitt werden die Rollen oder Berechtigungen beschrieben, die zum Erstellen einer Benachrichtigungsrichtlinie erforderlich sind. Ausführliche Informationen zur Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM) für Cloud Monitoring finden Sie unter Zugriffssteuerung.

Jede IAM-Rolle hat eine ID und einen Namen. Rollen-IDs haben das Format roles/monitoring.editor und werden beim Konfigurieren der Zugriffssteuerung als Argumente an das Befehlszeilentool gcloud übergeben. Weitere Informationen finden Sie unter Zugriff gewähren, ändern und widerrufen. In der Cloud Console werden Rollennamen wie "Monitoring-Editor" angezeigt.

Erforderliche Cloud Console-Rollen

Der Name Ihrer IAM-Rolle für das Google Cloud-Projekt muss eine der folgenden sein, um eine Benachrichtigungsrichtlinie zu erstellen:

  • Monitoring-Editor
  • Monitoring-Administrator
  • Projektinhaber

Eine Liste der Rollen und der zugehörigen Berechtigungen finden Sie unter Rollen.

Erforderliche API-Berechtigungen

Damit Sie mit der Cloud Monitoring API eine Benachrichtigungsrichtlinie erstellen können, muss Ihre Cloud IAM-Rollen-ID für das Google Cloud-Projekt eine der folgenden sein:

  • roles/monitoring.alertPolicyEditor: Diese Rollen-ID gewährt die minimalen Berechtigungen, die zum Erstellen einer Benachrichtigungsrichtlinie erforderlich sind. Weitere Informationen zu dieser Rolle finden Sie unter Vordefinierte Benachrichtigungsrollen.
  • roles/monitoring.editor
  • roles/monitoring.admin
  • roles/owner

Informationen zu den Berechtigungen, die für eine bestimmte Cloud Monitoring API-Methode erforderlich sind, finden Sie unter Cloud Monitoring API-Berechtigungen. Eine Liste der Rollen und der zugehörigen Berechtigungen finden Sie unter Rollen.

Rolle bestimmen

So ermitteln Sie Ihre Rolle für ein Projekt mithilfe der Cloud Console:

  1. Öffnen Sie die Cloud Console und wählen Sie das Google Cloud-Projekt aus:

    Zur Cloud Console

  2. Klicken Sie auf IAM & Verwaltung, um Ihre Rolle aufzurufen. Ihre Rolle steht in der gleichen Zeile wie Ihr Nutzername.

Wenden Sie sich an den Administrator Ihrer Organisation, um die Berechtigungen auf Organisationsebene zu erfahren.

Kosten für Benachrichtigungsrichtlinien

Für die Verwendung von Benachrichtigungsrichtlinien oder Verfügbarkeitsdiagnosen fallen keine Kosten an, es gelten jedoch die folgenden Limits:

Kategorie Wert Richtlinientyp1
Benachrichtigungsrichtlinien (Summe des Messwerts und Logs) pro Messwertbereich 2 500 Messwert, Log
Bedingungen pro Benachrichtigungsrichtlinie 6 Messwert
Maximaler Zeitraum, in dem eine
Bedingung für fehlende Messwerte ausgewertet wird3
1 Tag Messwert
Maximaler Zeitraum, in dem eine
Messwertschwellenbedingung ausgewertet wird3
23 Stunden, 30 Minuten Messwert
Benachrichtigungskanäle pro Benachrichtigungsrichtlinie 16 Messwert, Log
Maximale Benachrichtigungsrate 1 Benachrichtigung alle 5 Minuten für jede logbasierte Benachrichtigung Log
Maximale Anzahl an Benachrichtigungen 20 Benachrichtigungen pro Tag für jede logbasierte Benachrichtigung Log
Maximale Anzahl gleichzeitig offener Vorfälle
pro Benachrichtigungsrichtlinie
5.000 Messwert
Zeitraum, nach dem ein Vorfall ohne neue Daten
automatisch geschlossen wird
7 Tage Messwert
Maximale Dauer eines Vorfalls, wenn er nicht manuell geschlossen wird 7 Tage Log
Aufbewahrung geschlossener Vorfälle 13 Monate Nicht zutreffend
Aufbewahrung offener Vorfälle Unbefristet Nicht zutreffend
Benachrichtigungskanäle pro Messwertbereich 4000 Nicht zutreffend
Verfügbarkeitsdiagnosen pro Messwertbereich 4 100 Nicht zutreffend
1 Messwert: eine Benachrichtigungsrichtlinie, die auf Messwertdaten basiert, Log: eine Benachrichtigungsrichtlinie, die auf Lognachrichten basiert (logbasierte Benachrichtigungen)
2Apigee und Apigee Hybrid sind stark in Cloud Monitoring eingebunden. Das Benachrichtigungslimit für alle Apigee-Aboebenen (Standard, Enterprise und Enterprise Plus) entspricht dem für Cloud Monitoring: 500 pro Messwertbereich.
3 Der maximale Zeitraum, der eine Bedingung auswertet, ist die Summe des Ausrichtungszeitraums und der Dauerfensterwerte. Wenn für den Ausrichtungszeitraum beispielsweise 15 Stunden festgelegt sind und das Dauerfenster 15 Stunden beträgt, sind 30 Stunden für die Bewertung der Bedingung erforderlich.
4Dieses Limit bezieht sich auf die Anzahl der Verfügbarkeitsdiagnosen-Konfigurationen. Jede Verfügbarkeitsdiagnosen-Konfiguration enthält das Zeitintervall für den Statustest der angegebenen Ressource. Weitere Informationen finden Sie unter Verfügbarkeitsdiagnosen verwalten.

Die vollständigen Preise finden Sie unter Preise für die Operations-Suite von Google Cloud.

Nächste Schritte