Benachrichtigungen konfigurieren und verwalten

Sie können Error Reporting so konfigurieren, dass Fehlerbenachrichtigungen an ausgewählte Cloud Monitoring-Benachrichtigungskanäle gesendet werden.

Error Reporting sendet in folgenden Fällen Benachrichtigungen:

• Wenn ein Fehler zum ersten Mal in einem Google Cloud-Projekt auftritt und nicht mit vorherigen Fehlern gruppiert werden kann.

• Wenn ein Fehler, der als Behoben markiert wurde, wieder auftritt

Benachrichtigungskanäle verwalten

Sie erstellen, bearbeiten und löschen Benachrichtigungskanäle in Monitoring. Nachdem Sie Benachrichtigungskanäle erstellt haben, können Sie Error Reporting für die Verwendung dieser Kanäle konfigurieren.

Mit Error Reporting können Sie zwischen vier Arten von Benachrichtigungskanälen auswählen: E-Mail, mobile Daten, Slack und Webhooks.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring-Bearbeiter (roles/monitoring.editor) für Ihr Projekt zu gewähren, um die erforderlichen Berechtigungen zum Ansehen und Konfigurieren von Benachrichtigungskanälen mithilfe der Google Cloud Console zu erhalten. 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.

Benachrichtigungskanal erstellen

Folgen Sie der kanalspezifischen Anleitung in der folgenden Tabelle, um einen Benachrichtigungskanal mithilfe der Google Cloud Console zu erstellen:

E-Mail

So fügen Sie einen E-Mail-Benachrichtigungskanal hinzu:

1. Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend  Benachrichtigungen aus:

   Zu Benachrichtigungen

2. Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).
3. Klicken Sie im Bereich E-Mail auf Neue hinzufügen.
4. Geben Sie eine E-Mail-Adresse und eine Beschreibung ein.
5. Klicken Sie auf Speichern.

Wenn Sie eine Gruppen-E-Mail-Adresse als Benachrichtigungskanal für eine Benachrichtigungsrichtlinie verwenden, konfigurieren Sie die Gruppe so, dass E-Mails von [e-mail] akzeptiert werden.

Mobile App

Mit der Google Cloud Console Mobile App können Sie Ihre Google Cloud Console-Ressourcen und Monitoring-Informationen von überall aus überwachen. Benachrichtigungen der Google Cloud Console Mobile App werden entweder an ein bestimmtes Gerät oder an einen bestimmten Nutzer gesendet:

• Gerät gibt an, dass Benachrichtigungen nur an das Gerät gesendet werden, das den Benachrichtigungskanal erstellt hat. Bei gerätebezogenen Benachrichtigungskanälen enthält das Feld Anzeigename Geräteinformationen.
• Nutzer gibt an, dass die Benachrichtigungen an alle Geräte gesendet werden, auf denen die Google Cloud Console Mobile App installiert ist.

Cloud Monitoring bestimmt den Bereich der Benachrichtigung, wenn der Kanal erstellt wird. Sie können den Bereich nicht auswählen oder ändern.

So konfigurieren Sie einen Benachrichtigungskanal der Google Cloud Console Mobile App für ein bestimmtes Google Cloud-Projekt:

1. Installieren Sie die Google Cloud Console Mobile App aus dem App-Shop Ihres Mobilgeräts.

2. Wählen Sie ein Projekt zum Ansehen in der mobilen App der Google Cloud Console aus.

   Nachdem Sie ein Projekt ausgewählt haben, wird ein Datenaustausch zwischen der Anwendung und dem ausgewählten Google Cloud-Projekt durchgeführt. Ein Benachrichtigungskanal wird erstellt, wenn kein Kanal vorhanden ist. Nach einigen Minuten wird dieser Kanal unter Mobilgeräte-Abschnitt der Benachrichtigungskanäle-Seite aufgeführt.

Wenn Sie Ihr Mobilgerät als Benachrichtigungskanal für eine Benachrichtigungsrichtlinie hinzufügen möchten, wählen Sie im Abschnitt Benachrichtigungen die Option Google Cloud Console (Mobilgerät) und dann Ihr Mobilgerät aus der Liste aus.

Slack

Hinweis: Zum Ausführen dieser Schritte müssen Sie Inhaber oder Administrator eines Slack-Arbeitsbereichs sein. Weitere Informationen findest du unter Einladungsanfragen verwalten.

So richten Sie Slack-Benachrichtigungen ein:

1. In Slack: Erstellen Sie auf der Slack-Website einen Slack-Arbeitsbereich und einen Slack-Kanal. Zeichnen Sie die Kanal-URL auf.

2. Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend  Benachrichtigungen aus:

   Zu Benachrichtigungen

3. Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).

4. Klicken Sie im Abschnitt Slack auf Add new (Neue hinzufügen), um die Slack-Anmeldeseite zu öffnen:

   1. Wählen Sie den Slack-Arbeitsbereich aus.
   2. Klicken Sie auf Allow (Zulassen), um Cloud Monitoring Zugriff auf Ihren Slack-Arbeitsbereich zu gewähren. Dadurch gelangen Sie zurück zur Monitoring-Konfigurationsseite für Ihren Benachrichtigungskanal.
   3. Geben Sie im Feld Slack-Kanalname den Namen des Slack-Kanals ein, den Sie für Benachrichtigungen verwenden möchten.
   4. Geben Sie im Feld Anzeigename für Cloud-Benachrichtigungen eine kurze beschreibende Anweisung ein. Monitoring zeigt den Wert dieses Feldes auf der Seite Benachrichtigungskanal an.
   5. (Optional) Klicken Sie auf Testbenachrichtigung senden, um die Verbindung zwischen Cloud Monitoring und Ihrem Slack-Arbeitsbereich zu testen. Wenn die Verbindung erfolgreich ist, wird im von Slack angegebenen Slack-Benachrichtigungskanal die Meldung This is a test alert notification... angezeigt. Prüfen Sie den Benachrichtigungskanal, um den Empfang zu bestätigen.

5. Wenn der Slack-Kanal, den Sie für Benachrichtigungen verwenden möchten, ein privater Kanal ist, müssen Sie die Monitoring-Anwendung manuell in den Kanal einladen:

   1. Öffnen Sie Slack.

   2. Rufen Sie den Kanal auf, den Sie als Ihren Monitoring-Benachrichtigungskanal angegeben haben.

   3. Laden Sie die Monitoring-Anwendung in den Kanal ein, indem Sie die folgende Nachricht im Kanal eingeben und senden:

      /invite @Google Cloud Monitoring

      Laden Sie die Monitoring-Anwendung in den privaten Kanal ein, den Sie beim Erstellen des Benachrichtigungskanals in Monitoring angegeben haben. Das Einladen der Monitoring-Anwendung in öffentliche Kanäle ist optional.

Webhooks

Hinweis: Webhooks unterstützen nur öffentliche Endpunkte.

Hinweis: Wenn eine Cloud Functions-Funktion als Webhook-Endpunkt für einen Benachrichtigungskanal konfiguriert ist, muss der Nutzer, der die Funktion aufruft, die erforderliche Authentifizierungsberechtigung haben. Weitere Informationen finden Sie unter Funktion für Funktionsaufrufe authentifizieren und Zugriff auf eine Funktion aktivieren.

So konfigurieren Sie Webhooks-Benachrichtigungen:

1. Im Webhook-Handler: Geben Sie die URL des öffentlichen Endpunkts an, um Webhook-Daten von Monitoring zu erhalten.

2. Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend  Benachrichtigungen aus:

   Zu Benachrichtigungen

3. Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).
4. Klicken Sie im Bereich Webhook auf Add new (Neue hinzufügen).
5. Schließen Sie das Dialogfeld ab.
6. Klicken Sie auf Test Connection (Testverbindung), um eine Testnutzlast an den Webhook-Endpunkt zu senden. Gehen Sie zum empfangenden Endpunkt, um die Zustellung zu prüfen.
7. Klicken Sie auf Speichern.

Webhook-Schema

Klicken Sie auf Folgendes, um die Webhook-Schemastruktur für Error Reporting aufzurufen:

Schemastruktur Version 1.0

{
  "version": "1.0",
  "subject": String, Beschreibung der neuen oder wieder geöffneten Fehlergruppe.
  "group_info": {
    "project_id": String, Projekt, zu dem die Fehlergruppe gehört.
    "detail_link": String, Link zur Seite Error Reporting-Details für die Fehlergruppe.
  },
  "exception_info": {
    "type": String, Typ der im Ereignis protokollierten Ausnahme.
    "message": String, Ausnahmemeldung für das Ereignis
  },
  "event_info": {
    "log_message": String
    "request_method": String
    "request_url": String
    "referrer": String
    "user_agent": String
    "service": String
    "version": String
    "response_status": String
  },
}

Basisauthentifizierung

Neben der von Cloud Monitoring gesendeten Webhook-Anfrage verwendet die Basisauthentifizierung die HTTP-Spezifikation für den Nutzernamen und das Passwort. Für Cloud Monitoring muss Ihr Server eine 401-Antwort mit dem richtigen WWW-Authenticate-Header zurückgeben. Weitere Informationen zur Basisauthentifizierung finden Sie hier:

• RFC-Spezifikation
• Basisauthentifizierung

Tokenauthentifizierung

Die Tokenauthentifizierung erfordert einen Abfragestring-Parameter in der Endpunkt-URL und einen Schlüssel, der vom Server als geheim zwischen ihm und Monitoring erwartet wird. Die folgende Beispiel-URL enthält ein Token:

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Wenn Monitoring einen Vorfall an die Endpunkt-URL sendet, kann Ihr Server den angehängten Token überprüfen. Diese Authentifizierungsmethode ist am effektivsten, wenn sie in Verbindung mit SSL/TLS verwendet wird, um die HTTP-Anfrage zu verschlüsseln und zu verhindern, dass Schnüffler das Token lernen.

Einen Beispielserver in Python finden Sie hier.

Benachrichtigungskanäle bearbeiten und löschen

So bearbeiten oder löschen Sie einen Benachrichtigungskanal mit der Google Cloud Console:

1. Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend  Benachrichtigungen aus:

   Zu Benachrichtigungen

2. Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).

   Das Dashboard Benachrichtigungskanäle enthält einen Bereich für jede Art von Benachrichtigungskanal. In jedem Abschnitt werden alle Konfigurationen für den jeweiligen Typ aufgelistet:

   • Wenn Sie einen Eintrag ändern möchten, klicken Sie auf Bearbeiten. Klicken Sie auf Save (Speichern), nachdem Ihre Änderungen abgeschlossen sind.
   • Um einen Eintrag zu löschen, klicken Sie auf Löschen. Klicken Sie im Bestätigungsdialogfeld auf Delete (Löschen).

Hinweis: Sie können einen Benachrichtigungskanal nicht über die Google Cloud Console löschen, wenn der Kanal mit einer Benachrichtigungsrichtlinie verknüpft ist. Sie können den Kanal jedoch mit der Google Cloud CLI oder der Cloud Monitoring API löschen. Weitere Informationen finden Sie unter Benachrichtigungskanäle über API erstellen und verwalten.

Benachrichtigungskanäle über die Google Cloud Console auswählen

Zum Auswählen eines vorhandenen Benachrichtigungskanals benötigen Sie eine der folgenden Rollen:

• Error Reporting-Nutzer
• Error Reporting-Administrator
• Projekt-Editor
• Projektinhaber

Führen Sie die folgenden Schritte aus, um auszuwählen, wohin Sie Benachrichtigungen senden möchten, wenn neue Fehlergruppen auftreten.

1. Wählen Sie im Navigationsbereich der Google Cloud Console Error Reporting und dann Ihr Google Cloud-Projekt aus:

   Gehen Sie zu Error Reporting.

2. Klicken Sie auf Benachrichtigungen konfigurieren, um die Seite Fehlerbenachrichtigungen zu öffnen.

3. Wählen Sie im Drop-down-Menü Benachrichtigungskanäle die Kanäle aus, an die Sie die Benachrichtigungen senden möchten.

   Wenn der benötigte Kanal nicht angezeigt wird, klicken Sie auf Benachrichtigungskanäle verwalten, um einen neuen Kanal zu erstellen. Zum Erstellen eines Benachrichtigungskanals muss Ihre Rolle eine unter Kanäle erstellen aufgeführte Rolle sein.

4. Nachdem Sie die Kanäle ausgewählt haben, klicken Sie auf Speichern.

Weitere Informationen

Die folgenden Informationen gelten beim Erstellen und Verwalten von Benachrichtigungen in Error Reporting.

Wann werden Benachrichtigungen gesendet?

Error Reporting sendet in zwei Fällen eine Benachrichtigung:

• Wenn die Fehlergruppe noch nie von Error Reporting erkannt wurde.
• Wenn für eine vorhandene Fehlergruppe ein Fehler auftritt und der Status der Fehlergruppe auf Resolved gesetzt wird.

Damit Sie zukünftige Benachrichtigungen für die Fehlergruppe erhalten, müssen Sie den Status der Fehlergruppe auf Resolved setzen. Andere Aktionen wie das Löschen der Fehlergruppe mit der API oder das Warten auf das Alter der Daten führen nicht zu einer Benachrichtigung, wenn ein weiterer Fehler auftritt.

Ratenbegrenzung für Benachrichtigungen

Error Reporting verwendet die folgenden Regeln, um die Anzahl der Benachrichtigungen zu begrenzen, die Sie möglicherweise aufgrund von Fehlern erhalten:

• Innerhalb von 60 Minuten können aufgrund eines Fehlers maximal fünf Benachrichtigungen gesendet werden.

• Wenn in einem 60-Minuten-Zeitfenster mehr als 5 Fehler auftreten, geschieht Folgendes:

  • Sie erhalten eine Benachrichtigung, dass weitere Benachrichtigungen für die nächsten sechs Stunden stummgeschaltet werden.

  • Es wird ein Logeintrag mit der Wichtigkeitsstufe der Warnung geschrieben.

• Wenn Sie eine Fehlergruppe beheben, werden Benachrichtigungen für diese Fehlergruppe fünf Minuten lang ausgesetzt.

Lösungsstatus

Wenn ein Fehler mit dem Lösungsstatus Behoben wiederholt auftritt, selbst wenn er zuvor gelöscht wurde, ändert sich dessen Lösungsstatus wieder in Offen und Error Reporting sendet eine Benachrichtigung.

Error Reporting sendet keine Benachrichtigung, wenn ein Fehler mit dem Status Ausgeblendet wiederholt auftritt.

Informationen zum Verwalten des Lösungsstatus Ihrer Fehler finden Sie unter Fehler verwalten.

Mobile Benachrichtigungen

Error Reporting sendet mobile Benachrichtigungen an die Google Cloud-App unter Android und iOS. Bevor Sie mobile Benachrichtigungen aktivieren können, müssen Sie die App auf Ihrem Mobilgerät installieren:

Google Cloud App herunterladen