Benachrichtigungen 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 aus zwei Arten von Benachrichtigungskanälen auswählen: E-Mail und Mobil.

Hinweis

Zum Konfigurieren eines Benachrichtigungskanals benötigen Sie eine der folgenden IAM-Rollen (Identity and Access Management) für das den Umfang festlegende Projekt eines Messwertbereichs:

• Bearbeiter von Monitoring-Benachrichtigungskanälen
• Monitoring-Editor
• Monitoring-Administrator
• Projekt-Editor
• Projektinhaber

Weitere Informationen zu diesen Rollen finden Sie unter Zugriffssteuerung.

Benachrichtigungskanal erstellen

Folgen Sie der 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 in der Google Cloud Console Monitoring aus.
   

   Zu Monitoring

2. Klicken Sie auf Alerting (Benachrichtigungen) und dann auf Edit notification channels (Benachrichtigungskanäle bearbeiten).
3. Klicken Sie im Bereich E-Mail auf Neue hinzufügen.
4. Schließen Sie das Dialogfeld ab und 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 mobile Google Cloud Console App aus dem App-Shop Ihres Mobilgeräts.

2. Wählen Sie ein Projekt zum Ansehen in der Google Cloud Console Mobile App 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 ein Slack-Workspace-Inhaber oder -Administrator 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 in der Google Cloud Console Monitoring aus:

   Zu Monitoring

3. Klicken Sie auf Alerting (Benachrichtigungen) und dann 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 den Namen des Slack-Kanals ein, den Sie für Benachrichtigungen verwenden möchten.
   4. Geben Sie einen Anzeigenamen für den Slack-Benachrichtigungskanal ein.
   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.

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 in der Google Cloud Console Monitoring aus.
   

   Zu Monitoring

3. Klicken Sie auf Alerting (Benachrichtigungen) und dann 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 die folgende Schaltfläche, um die Webhook-Schemastruktur für Error Reporting aufzurufen:

Schemastruktur, Version 1.0

{
  "version": "1.0",
  "subject": String, Beschreibung der neuen oder neu 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, der Typ der im Ereignis protokollierten Ausnahme.
    "message": String, Ausnahmenachricht 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 über die Google Cloud Console:

1. Wählen Sie in der Google Cloud Console Monitoring aus oder klicken Sie auf die folgende Schaltfläche:

   Zu Monitoring

2. Klicken Sie im Navigationsbereich "Monitoring" auf Benachrichtigungen.

3. 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.
   • Wenn Sie einen Eintrag löschen möchten, 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 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. Rufen Sie Error Reporting auf:

   Zur Seite „Fehlerberichte“

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.

Benachrichtigungslimit

Wenn mehr als fünf Fehler innerhalb einer Stunde in einem Google Cloud-Projekt wiederholt auftreten, sendet Error Reporting eine letzte Benachrichtigung mit der Information, dass innerhalb der nächsten sechs Stunden keine Benachrichtigungen mehr gesendet werden. Damit wird der Posteingang von Nutzern nicht überlastet.

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 Android- und iOS-Apps an die Google Cloud App. Bevor Sie mobile Benachrichtigungen aktivieren können, müssen Sie die App auf Ihrem Mobilgerät installieren:

Google Cloud App herunterladen