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.

Bei Error Reporting können Sie zwischen vier Arten von Benachrichtigungen wählen. Channels: E-Mail, Mobil, Slack und Webhooks.

Hinweise

So erhalten Sie die Berechtigungen, die Sie zum Aufrufen und Konfigurieren von Benachrichtigungskanälen über die Google Cloud Console benötigen: bitten Sie Ihren Administrator, Ihnen IAM-Rolle Monitoring-Bearbeiter (roles/monitoring.editor) für Ihr Projekt. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Weitere Informationen zu Cloud Monitoring-Rollen Siehe Zugriff mit Identity and Access Management steuern

Benachrichtigungskanal erstellen

So erstellen Sie einen Benachrichtigungskanal mit der Google Cloud Console: folgen Sie den kanalspezifischen Anweisungen in der folgenden Tabelle:

E-Mail

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

1. Rufen Sie in der Google Cloud Console die Seite  Benachrichtigungen auf:

   Zu Benachrichtigungen

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

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 mobilen Google Cloud Console App können Sie Ihre Google Cloud Console-Ressourcen und Monitoring von überall aus. Benachrichtigungen der Google Cloud Console Mobile App sind entweder an ein bestimmtes Gerät oder einen bestimmten Nutzer gesendet werden:

• 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.
• User gibt an, dass die Benachrichtigungen an alle Ihren Geräten, 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 einen bestimmten Google Cloud-Projekt:

1. Installieren Sie die Google Cloud Console Mobile App über den App Store Ihres Mobilgeräts.

2. Wählen Sie ein Projekt aus, das Sie in der mobilen App der Google Cloud Console ansehen möchten.

   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.

So fügen Sie Ihr Mobilgerät als Benachrichtigungskanal für eine Benachrichtigung hinzu: im Abschnitt Benachrichtigungen die Option Google Cloud Console (Mobilgerät) und wählen Sie dann auf der Liste.

Slack

Hinweis: Für diese Schritte müssen Sie ein Slack-Workspace-Inhaber oder ‐Administrator. Weitere Informationen finden Sie 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. Rufen Sie in der Google Cloud Console die Seite  Benachrichtigungen auf:

   Zu Benachrichtigungen

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

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. Slack-Kanal, den Sie für Benachrichtigungen verwenden möchten.
   4. Geben Sie im Feld Anzeigename für Cloud-Benachrichtigungen eine kurze beschreibende Aussage. Monitoring zeigt den Wert an auf der Seite Benachrichtigungskanal.
   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 Run-Funktion als Webhook-Endpunkt für einen Benachrichtigungskanal konfiguriert, Stellen Sie dann sicher, dass der Nutzer, der die Funktion aufruft, über die erforderliche Authentifizierung verfügt, Berechtigung. Weitere Informationen finden Sie unter Authentifizierung für Funktionsaufrufe 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. Rufen Sie in der Google Cloud Console die Seite  Benachrichtigungen auf:

   Zu Benachrichtigungen

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

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

So rufen Sie die Webhook-Schemastruktur für Error Reporting auf: klicken Sie auf Folgendes:

Schemastruktur, Version 1.0

{
  "version": "1.0",
  "subject": String, Beschreibung der neuen oder wieder geöffneten Fehlergruppe.
  "group_info": {
    "project_id": String, zu dem die Fehlergruppe gehört.
    "detail_link": String, der zur Seite Error Reporting-Details für den Fehler führt Gruppe.
  },
  "exception_info": {
    "type": string, Typ der im Ereignis protokollierten Ausnahme.
    "message": Zeichenfolge, 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 mithilfe der Google Cloud Console: Gehen Sie so vor:

1. Rufen Sie in der Google Cloud Console die Seite  Benachrichtigungen auf:

   Zu Benachrichtigungen

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

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.
   • Wenn Sie einen Eintrag löschen möchten, klicken Sie auf Löschen. Klicken Sie im Bestätigungsdialogfeld auf Delete (Löschen).

Hinweis :Benachrichtigungskanäle können nicht über die Google Cloud Console gelöscht werden. Der Kanal ist mit einer Benachrichtigungsrichtlinie verknüpft. Sie können den Kanal jedoch mithilfe der Google Cloud CLI oder der Cloud Monitoring API Weitere Informationen finden Sie unter Benachrichtigungskanäle nach 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. Rufen Sie in der Google Cloud Console die Seite Error Reporting auf:

   Error Reporting aufrufen

   Sie können diese Seite auch über die Suchleiste finden.

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.

Benachrichtigungsinhalt

Benachrichtigungen für Fehlergruppen enthalten Informationen zu den Logeinträgen in der Gruppe. Die enthaltenen Informationen hängen von der Art der überwachten Ressource, in der der Fehler aufgetreten ist. Einige Benachrichtigungen kann den Namen und die Version der überwachten Ressource enthalten.

Die Fehlermeldung wird nur dann in der Benachrichtigung angezeigt, wenn die Fehlergruppe die durch die Logeinträge in einem Log-Bucket mit der Region global identifiziert werden.

Wann werden Benachrichtigungen gesendet?

Error Reporting sendet in zwei Fällen eine Benachrichtigung:

• Wenn die Fehlergruppe noch nie von Error Reporting erkannt wurde
• Wenn ein Fehler für eine vorhandene Fehlergruppe und den Fehlergruppenstatus auftritt ist auf Resolved festgelegt.

Damit Sie zukünftige Benachrichtigungen für die Fehlergruppe erhalten, müssen Sie den Parameter Fehlergruppe Status in Resolved ändern. Keine anderen Aktionen wie das Verwenden der API zum Löschen des oder das Warten auf das Alter der Daten führt zu einer Benachrichtigung wenn ein anderer Fehler auftritt.

Ratenbegrenzung für Benachrichtigungen

Error Reporting verwendet die folgenden Regeln, um die Anzahl der von Benachrichtigungen, die Sie aufgrund von Fehlern erhalten können:

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

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

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

  • Es wird ein Logeintrag mit dem Schweregrad der Warnung geschrieben.

• Wenn Sie eine Fehlergruppe auflösen, werden Benachrichtigungen für diese Gruppe für fünf Minuten gesperrt.

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

Google Cloud App herunterladen