Diese Seite wurde von der Cloud Translation API übersetzt.

Benachrichtigungskanäle erstellen und verwalten

In diesem Dokument wird beschrieben, wie Sie Benachrichtigungskanäle mithilfe der Google Cloud Console konfigurieren. Cloud Monitoring verwendet diese Kanäle, um Sie zu benachrichtigen, oder Ihr Bereitschaftsteam, wenn eine Benachrichtigungsrichtlinie ausgelöst wird. Wenn Sie eine Benachrichtigungsrichtlinie festlegen, wer benachrichtigt werden soll, indem Sie in der Liste der konfigurierten Benachrichtigungskanäle. Sie können beispielsweise Benachrichtigungsrichtlinien konfigurieren, die Compute Engine-Instanzen überwachen, um ein Pub/Sub-Thema zu veröffentlichen und den Slack-Kanal für das Bereitschaftsteam zu benachrichtigen.

Weitere Informationen finden Sie unter Benachrichtigungslatenz und Benachrichtigungen pro Vorfall.

In diesem Dokument wird die Verwendung der Google Cloud Console beschrieben. Wenn Sie das Cloud Monitoring API, dann sehen Sie unter Benachrichtigungskanäle nach API erstellen und verwalten

Hinweis

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.editor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen und Konfigurieren von Benachrichtigungskanälen in der Google Cloud Console benötigen. 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 finden Sie unter Zugriff mit Identity and Access Management steuern.

Benachrichtigungskanal erstellen

Wenn Sie eine Benachrichtigungsrichtlinie erstellen, können Sie einen beliebigen konfigurierten Benachrichtigungskanal auswählen und der Richtlinie hinzufügen. Sie können Ihre Benachrichtigungskanäle vorkonfigurieren oder im Rahmen der Erstellung einer Benachrichtigungsrichtlinie konfigurieren. Weitere Informationen Weitere Informationen

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:

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.
Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).
Klicken Sie im Bereich E-Mail auf Neue hinzufügen.
Geben Sie eine E-Mail-Adresse und eine Beschreibung ein.
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 alerting-noreply@google.com akzeptiert werden.

Sie können E-Mail-Channels während der Erstellung einer Benachrichtigungsrichtlinie erstellen. Weitere Informationen finden Sie unter Kanal on demand erstellen

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 werden entweder an ein bestimmtes Gerät oder an einen bestimmten Nutzer gesendet:

Liste der Benachrichtigungskanäle der Google Cloud Console Mobile App.

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:

Installieren Sie die Google Cloud Console Mobile App über den App Store Ihres Mobilgeräts.
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.

Logo: PagerDuty

PagerDuty unterstützt die Zwei-Wege-Synchronisierung mit Monitoring. Daher gilt Folgendes:

Wenn in Cloud Monitoring ein Vorfall erstellt wird, wird ein Vorfall in PagerDuty geöffnet.
Sie können PagerDuty nicht verwenden, um einen Vorfall in Monitoring zu schließen.
Wenn Sie einen Vorfall in PagerDuty lösen und der Vorfall in Monitoring geöffnet ist, wird der Vorfall auch in PagerDuty wieder geöffnet.

So richten Sie PagerDuty-Benachrichtigungen ein: Gehen Sie so vor:

Konfigurieren Sie die Integration in Ihrem PagerDuty-Konto in einem neuen Dienst oder fügen Sie sie einem vorhandenen Dienst hinzu.
1. Erstelle ein Konto oder melde dich in einem bestehenden Konto an.
2. Rufen Sie die Seite Dienste auf.
3. Suchen Sie im Bereich Integrationen Ihres Dienstes nach dem Eintrag Ihres neue Integration, maximieren Sie das Menü und kopieren Sie dann den Integrationsschlüssel.
Fügen Sie in Cloud Monitoring den PagerDuty-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 PagerDuty auf Add new (Neue hinzufügen).
4. Geben Sie den Anzeigenamen ein. Dieser Name sollte mit dem Namen des PagerDuty-Dienstes übereinstimmen, in dem Sie in Schritt 1 Ihre neue Integration konfiguriert haben.
5. Fügen Sie den Integrationsschlüssel, den Sie in Schritt 1 kopiert haben, in das Service Key (Dienstschlüssel) ein.
6. Klicken Sie auf Speichern.

Wenn Sie eine Benachrichtigungsrichtlinie erstellen, wählen Sie PagerDuty im Abschnitt Benachrichtigungen und Ihre PagerDuty-Konfiguration aus.

Das JSON-Paket für PagerDuty hat folgendes Format:

 {
     "description": A string of various fields in the incident,
     "details": JSON payload with schema version 1.2.
 }

Wenn Sie sich ein Beispiel und das Schema für das Feld details ansehen möchten, maximieren Sie die folgenden Abschnitte.

JSON-Beispiele

Standardmäßig versucht das Benachrichtigungs-Backend, ein JSON-Paket mit der Formatierung der Version 1.2 zu erstellen. Weitere Informationen zu dieser Formatierung finden Sie im nächsten Abschnitt.

Hier ist ein Beispiel für ein solches Paket:


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity"
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

Schemastruktur, Version 1.2

In diesem Abschnitt wird Version 1.2 des Nutzlastschemas beschrieben. Einige Felder werden möglicherweise nicht in allen zurückgegebenen Paketen angezeigt oder haben leere Werte, je nach Konfiguration der Benachrichtigungsrichtlinie, dem Status des Vorfalls oder der überwachten Ressource. Einige Felder verwenden eingebettete Strukturen als Werte. Diese Strukturen werden durch Referenz beschrieben, da ihre Inhalte auch variieren können.

In einem zurückgegebenen Paket können die Felder in beliebiger Reihenfolge vorkommen. In der folgenden Beschreibung sind sie in verwandte Gruppen unterteilt.

{
  "version": "1.2",
  "incident": {

    Informationen zum Vorfall.

    "incident_id": String, generierte ID für diesen Vorfall.
    "scoping_project_id": String, die Projekt-ID, auf der der Messwertbereich gehostet wird.
    "scoping_project_number": number ist die Projektnummer des den Umfang festlegenden Projekts.
    "url": String, Google Cloud Console-URL für diesen Vorfall.
    "started_at": Zahl und Uhrzeit (in Unix-Epochensekunden), als der Vorfall geöffnet wurde.
    "ended_at": Nummer und Zeit (in Unix-Epochen-Sekunden), zu der der Vorfall geschlossen wurde. Wird nur gefüllt, wenn state closed ist.
    "state": String, Status des Vorfalls: open oder closed. Wenn open, dann ist ended_at null.
    "summary": String, generierte Textzusammenfassung des Vorfalls.
    "apigee_url": String, Apigee-URL für diesen Vorfall, nur für Apigee Ressourcentypen Environment und Proxy*.
    "observed_value": String, beobachteter Wert, der die Benachrichtigung ausgelöst/geklärt hat, können leer sein, wenn die Bedingung abgelaufen ist.

    Informationen zur überwachten Ressource, für die der Vorfall geöffnet wurde.

    "resource": {
      "type": String, Kennung des Typs von überwachter Ressource, für den die Benachrichtigung ausgegeben wird, z. B. gce_instance; Siehe Liste der überwachten Ressourcen.
      "labels": und Schlüssel/Wert-Paare für Labels, die der überwachten Ressource zugeordnet sind.
    },
    "resource_type_display_name": String, Anzeigename des Typs der überwachten Ressource.
    "resource_id": String, Instanz-ID der überwachten Ressource, derselbe Wert wie resource.labels.instance_id
    "resource_display_name": String, Anzeigename der überwachten Ressource.
    "resource_name": String, generierter Name dieser überwachten Ressource; aus Werten aus anderen Feldern.

    Informationen zum Messwerttyp der Zeitreihendaten.

    "metric": {
      "type": String, Kennung des Messwerttyps, für den Benachrichtigungen ausgegeben werden sollen, z. B. compute.googleapis.com/instance/cpu/utilization; siehe Liste der Messwerte.
      "displayName": String, Anzeigename des Messwerttyps.
      "labels": Objekt, Schlüssel/Wert-Paare für Labels, die mit dem Messwert verknüpft sind.
    },
    "metadata": {
      "system_labels": und Schlüssel/Wert-Paare für Labels der Systemmetadaten.
      "user_labels": und Schlüssel/Wert-Paare für Nutzermetadatenlabels.
    },

    Informationen zur Benachrichtigungsrichtlinie und Bedingung, die den Vorfall ausgelöst bzw. gelöst haben.
    Die Werte werden aus dem entsprechenden AlertPolicy-Objekt abgerufen.

    "policy_name": String, Anzeigename für die Benachrichtigungsrichtlinie.
    "policy_user_labels": und Schlüssel/Wert-Paare für alle mit der Richtlinie verknüpften Nutzerlabels.
    "documentation": -Objekt, eine eingebettete Struktur des Formulars Documentation.
    "condition": -Objekt, eine eingebettete Struktur des Formulars Condition.
    "condition_name": String, Anzeigename der Bedingung, derselbe Wert wie condition.displayName.
    "severity": String, Schweregrad der Vorfälle. Wenn dieses Feld beim Erstellen der Benachrichtigungsrichtlinie nicht definiert wird, legt Cloud Monitoring den Schweregrad der Benachrichtigungsrichtlinie auf no severity fest.
    "threshold_value": String, der Schwellenwert dieser Bedingung. Er kann leer sein, wenn es sich nicht um eine Schwellenbedingung handelt.
  },
}

Einstellungsrichtlinie

Das Nutzlastschema unterliegt der Einstellungsrichtlinie für Google Cloud, die in Abschnitt 1.4(d) der Nutzungsbedingungen der Google Cloud Platform beschrieben ist. Beachten Sie, dass das Schema nicht die Formate von generierten Feldwerten steuert. Diese Formate können ohne Vorankündigung geändert werden. Beispiel: incident.summary, incident.documentation.content und incident.url sollen Daten enthalten, die sich auf ihre Felder beziehen. Das Schema hat jedoch keine Einschränkungen, um ein genaues Parsen dieser Felder zu garantieren. Sie können den Wert als Ganzes verwenden und erwarten, dass er der Richtlinie zur Einstellung von Produkten und Diensten entspricht, sich aber nicht auf das Parsen der generierten Felder verlassen.

SMS

So konfigurieren Sie SMS-Benachrichtigungen:

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.
Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).
Klicken Sie im Bereich SMS auf Add new (Neue hinzufügen).
Schließen Sie das Dialogfeld ab und klicken Sie auf Speichern.

Wählen Sie, wenn Sie Ihre Benachrichtigungsrichtlinie einrichten, den Benachrichtigungstyp SMS und eine bestätigte Telefonnummer aus der Liste aus.

Slack

Durch die Integration von Monitoring in Slack können Ihre Benachrichtigungsrichtlinien bei der Erstellung eines neuen Vorfalls Informationen an einen Slack-Kanal posten. So richten Sie Slack-Benachrichtigungen ein:

In Slack: Erstellen Sie auf der Slack-Website einen Slack-Arbeitsbereich und einen Slack-Kanal. Zeichnen Sie die Kanal-URL auf.
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.
Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).
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 in das Feld Slack-Kanalname den Namen des Slack-Kanals ein, den Sie für Benachrichtigungen verwenden möchten.
4. Geben Sie im Feld Cloud-Benachrichtigung – Anzeigename eine kurze aussagekräftige Beschreibung ein. In Monitoring wird der Wert dieses Felds auf der Seite Benachrichtigungskanal angezeigt.
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.
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.
Wenn Sie eine Benachrichtigungsrichtlinie erstellen, wählen Sie Slack im Abschnitt Benachrichtigungen sowie Ihre Slack-Konfiguration aus.

Webhooks

So konfigurieren Sie Webhooks-Benachrichtigungen:

Im Webhook-Handler: Geben Sie die URL des öffentlichen Endpunkts an, um Webhook-Daten von Monitoring zu erhalten.
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.
Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).
Klicken Sie im Bereich Webhook auf Add new (Neue hinzufügen).
Schließen Sie das Dialogfeld ab.
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.
Klicken Sie auf Speichern.

Wenn Sie eine Benachrichtigungsrichtlinie erstellen, wählen Sie Webhook im Abschnitt Notifications (Benachrichtigungen) und Ihre Webhook-Konfiguration aus. Die von Error Reporting gesendeten Benachrichtigungen folgen dem 1.0-Schema, während die von Monitoring gesendeten Benachrichtigungen dem 1.2-Schema folgen:

JSON-Beispiele

Hier ist ein Beispiel für ein solches Paket:


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity"
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

Schemastruktur, Version 1.2

In einem zurückgegebenen Paket können die Felder in beliebiger Reihenfolge vorkommen. In der folgenden Beschreibung sind sie in verwandte Gruppen unterteilt.

{
  "version": "1.2",
  "incident": {

    Informationen zum Vorfall.

    "incident_id": String, generierte ID für diesen Vorfall.
    "scoping_project_id": String, die Projekt-ID, die den Messwertbereich hostet.
    "scoping_project_number": Zahl, die Projektnummer des Projekts zur Festlegung des Umfangs.
    "url": String, Google Cloud Console-URL für diesen Vorfall.
    "started_at": Zahl und Uhrzeit (in Unix-Epochensekunden), als der Vorfall geöffnet wurde.
    "ended_at": Zahl, Zeitpunkt (in Unix-Epochensekunden), wann der Vorfall geschlossen wurde. Wird nur gefüllt, wenn state closed ist.
    "state": String, Status des Vorfalls: open oder closed. Wenn open, ist ended_at null.
    "summary": String, generierte Textzusammenfassung des Vorfalls.
    "apigee_url": String, Apigee-URL für diesen Vorfall, nur für die Apigee-Ressourcentypen Environment und Proxy*.
    "observed_value": String, der Wert, der die Benachrichtigung ausgelöst oder beendet hat. Kann leer sein, wenn die Bedingung abgelaufen ist.

    Informationen zur überwachten Ressource, für die der Vorfall geöffnet wurde.

    "resource": {
      "type": String, Kennung des Typs der überwachten Ressource, für den Benachrichtigungen ausgegeben werden sollen, z. B. gce_instance; siehe Liste der überwachten Ressourcen.
      "labels": Objekt, Schlüssel/Wert-Paare für Labels, die mit der überwachten Ressource verknüpft sind.
    },
    "resource_type_display_name": String, Anzeigename des Typs der überwachten Ressource.
    "resource_id": String, Instanz-ID der überwachten Ressource, derselbe Wert wie resource.labels.instance_id
    "resource_display_name": String, Anzeigename der überwachten Ressource.
    "resource_name": String, generierter Name dieser überwachten Ressource; aus Werten aus anderen Feldern.

    Informationen zum Messwerttyp der Zeitreihendaten.

    "metric": {
      "type": String, Kennung des Messwerttyps, für den die Benachrichtigung ausgegeben wird, z. B. compute.googleapis.com/instance/cpu/utilization; Siehe Liste der Messwerte.
      "displayName": String, Anzeigename des Messwerttyps.
      "labels": und Schlüssel/Wert-Paare für Labels, die dem Messwert zugeordnet sind.
    },
    "metadata": {
      "system_labels": und Schlüssel/Wert-Paare für Labels der Systemmetadaten.
      "user_labels": und Schlüssel/Wert-Paare für Nutzermetadatenlabels.
    },

    Informationen zur Benachrichtigungsrichtlinie und -bedingung, durch die der Vorfall geöffnet/behoben wurde.
    Die Werte basieren auf den relevanten AlertPolicy-Objekt.

    "policy_name": String, Anzeigename für die Benachrichtigungsrichtlinie.
    "policy_user_labels": und Schlüssel/Wert-Paare für alle mit der Richtlinie verknüpften Nutzerlabels.
    "documentation": Objekt, eine eingebettete Struktur vom Typ Documentation.
    "condition": Objekt, eine eingebettete Struktur vom Typ Condition.
    "condition_name": String, Anzeigename der Bedingung, derselbe Wert wie condition.displayName.
    "severity": String, Schweregrad von Vorfällen. Wenn dieses Feld beim Erstellen der Benachrichtigungsrichtlinie nicht definiert wird, legt Cloud Monitoring den Schweregrad der Benachrichtigungsrichtlinie auf no severity fest.
    "threshold_value": String, der Schwellenwert dieser Bedingung. Er kann leer sein, wenn es sich nicht um eine Schwellenbedingung handelt.
  },
}

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:

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.

Einstellungsrichtlinie

Pub/Sub

In diesem Abschnitt wird beschrieben, wie Sie Pub/Sub-Benachrichtigungskanäle konfigurieren. Zur Redundanz empfehlen wir, mehrere Benachrichtigungskanäle zu erstellen. Es wird empfohlen, Pub/Sub mit der Mobile Console der Google Cloud Console, PagerDuty, Webhooks oder Slack zu kombinieren, da Pub/Sub einen anderen Bereitstellungsmechanismus verwendet.

So konfigurieren Sie einen Pub/Sub-Benachrichtigungskanal:

Erforderliche APIs aktivieren und Thema erstellen
Benachrichtigungskanal für ein Thema konfigurieren
Dienstkonto autorisieren
Benachrichtigungskanal in einer Benachrichtigungsrichtlinie festlegen

Informationen zum Datenschema finden Sie unter Schemabeispiel.

Damit Sie Benachrichtigungen erhalten, müssen Sie außerdem eines der folgenden Abos erstellen: Pull, Push oder BigQuery.

Wenn sich das Abo in einem anderen Projekt als das Thema befindet, erstellen Sie ein Dienstkonto im Projekt des Abonnenten und weisen Sie ihm die Rolle roles/pubsub.subscriber zu.

Hinweis

Wenn Sie einem Google Cloud-Projekt den ersten Pub/Sub-Benachrichtigungskanal hinzufügen, erstellt Cloud Monitoring ein Dienstkonto für dieses Projekt. Außerdem wird dem Dienstkonto die IAM-Rolle Dienst-Agent für Monitoring-Benachrichtigungen zugewiesen. Mit diesem Dienstkonto kann Monitoring Benachrichtigungen an Pub/Sub-basierte Benachrichtigungskanäle in diesem Projekt senden.

Das Dienstkonto hat die folgenden Rollen:

service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

Der Name des Benachrichtigungsdienstkontos enthält Eindeutige Nummer des Google Cloud-Projekts. Sie finden den Projektnamen, die Projekt-ID und die Projektnummer auf das Projekt-Dashboard in der Google Cloud Console können Sie sie mit folgendem Befehl abrufen:

gcloud projects describe PROJECT_ID --format="value(project_number)"

Sie können das Dienstkonto mit der Google Cloud Console oder der Google Cloud CLI aufrufen und bearbeiten.

Erforderliche APIs aktivieren und Thema erstellen

Im Google Cloud-Projekt, in dem Sie den Benachrichtigungskanal erstellen möchten und Pub/Sub-Thema:

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Pub/Sub and Cloud Monitoring APIs.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Pub/Sub and Cloud Monitoring APIs.

Enable the APIs

Pub/Sub-Thema erstellen Weitere Informationen zum Erstellen eines Themas finden Sie unter Thema erstellen. Führen Sie beispielsweise den folgenden Befehl aus, um mithilfe der Google Cloud CLI ein Thema namens notificationTopic zu erstellen:
```
gcloud pubsub topics create notificationTopic
```

Konfigurieren Sie als Nächstes Ihre Pub/Sub-Benachrichtigungskanäle.

Benachrichtigungen für ein Thema konfigurieren

Zum Erstellen eines Pub/Sub-Benachrichtigungskanals können Sie die Monitoring API, die Google Cloud CLI oder die Google Cloud Console verwenden. Nachdem Sie den Benachrichtigungskanal erstellt haben, autorisieren Sie das Benachrichtigungsdienstkonto, um jedes Thema zu veröffentlichen, das Sie als Benachrichtigungskanal verwenden.

Informationen zur Verwendung der Monitoring API oder der Informationen zum Erstellen des Benachrichtigungskanals in der Google Cloud CLI finden Sie unter Erstellen von Channels:

So erstellen Sie den Benachrichtigungskanal mit der Google Cloud Console: Gehen Sie so vor:

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.
Wählen Sie das Google Cloud-Projekt aus, das das von Ihnen erstellte Pub/Sub-Thema enthält.
Klicken Sie auf Edit notification channels (Benachrichtigungskanäle bearbeiten).
Klicken Sie im Abschnitt Cloud Pub/Sub auf Add new (Neu hinzufügen).

Im Dialogfeld Created Pub/Sub Channel (Erstellter Pub/Sub-Kanal) wird der Name des Dienstkontos angezeigt, das von Monitoring erstellt wurde.
Dienstkonto autorisieren Ihr Dienstkonto kann alle Themen oder bestimmte Themen veröffentlichen:
- Wählen Sie zum Veröffentlichen aller Themen die Option Rollen verwalten aus und fügen Sie die Rolle Pub/Sub-Publisher hinzu.
  
  Nachdem Sie diese Schritte zum Konfigurieren des Benachrichtigungskanals ausgeführt haben, überspringen Sie den nächsten Abschnitt mit der Bezeichnung Dienstkonto autorisieren und fahren Sie mit Benachrichtigungskanal in einer Benachrichtigungsrichtlinie festlegen.
- Wenn Sie bestimmte Themen veröffentlichen möchten, fahren Sie mit dem nächsten Schritt fort und autorisieren Sie das Dienstkonto, bestimmte Themen zu veröffentlichen, nachdem Sie den Benachrichtigungskanal konfiguriert haben. Eine Anleitung zum Autorisieren des Dienstkontos finden Sie unter Dienstkonto autorisieren.
Geben Sie einen Anzeigenamen für Ihren Kanal und den Namen des Pub/Sub-Themas ein.
(Optional) Klicken Sie auf Testbenachrichtigung, um zu prüfen, ob der Kanal richtig konfiguriert ist.
Wählen Sie Kanal hinzufügen aus.

Autorisieren Sie als Nächstes das Dienstkonto.

Dienstkonto autorisieren

Mit der Autorisierung kann das Benachrichtigungsdienstkonto jedes Pub/Sub-Thema, das Sie als Benachrichtigungskanal verwenden, veröffentlichen. In diesem Abschnitt wird Folgendes beschrieben:

Autorisieren Sie ein Dienstkonto für ein bestimmtes Thema.
Autorisieren Sie ein Dienstkonto für alle Themen.

Dienstkonto für ein bestimmtes Thema autorisieren

Sie können ein Dienstkonto mithilfe der Google Cloud Console und der Google Cloud CLI autorisieren, um ein bestimmtes Thema zu veröffentlichen. In diesem Abschnitt werden beide Ansätze beschrieben.

So autorisieren Sie Ihr Dienstkonto für ein bestimmtes Thema mithilfe von in der Google Cloud Console:

Rufen Sie in der Google Cloud Console die Seite Themen auf:
Gehen Sie zu Topics.

Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Pub/Sub lautet.
Wählen Sie das Thema aus.
Wählen Sie auf dem Tab Berechtigungen die Option Hauptkonto hinzufügen aus.
Geben Sie im Feld Neues Hauptkonto den Namen des Benachrichtigungsdienstkontos ein. Das Dienstkonto hat die folgende Namenskonvention:
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
Wählen Sie die Rolle Pub/Sub-Publisher und dann Speichern aus.

So autorisieren Sie Ihr Dienstkonto für ein bestimmtes Thema mithilfe von über die Google Cloud CLI, Gewähren Sie die pubsub.publisher IAM-Rolle für das Thema zum Dienstkonto. Mit dem folgenden Befehl wird beispielsweise die IAM-Rolle für das Thema notificationTopic:

gcloud pubsub topics add-iam-policy-binding \
projects/PROJECT_NUMBER/topics/notificationTopic --role=roles/pubsub.publisher \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

Eine Antwort auf eine erfolgreiche Ausführung des Befehls add-iam-policy-binding sieht in etwa so aus:

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1

Weitere Informationen finden Sie auf der Referenzseite zu pubsub topics add-iam-policy-binding.

Dienstkonto für alle Themen autorisieren

So autorisieren Sie Ihr Dienstkonto für alle Themen:

Öffnen Sie in der Google Cloud Console die Seite IAM:
Rufen Sie IAM auf.

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift IAM und Verwaltung ist.
Wählen Sie Von Google bereitgestellte Rollenzuweisungen einschließen aus, wie in der folgenden Abbildung dargestellt:
Suchen Sie nach dem Dienstkonto im folgenden Format:
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
Laden Sie die Seite neu, wenn das Dienstkonto nicht aufgeführt ist.
Wählen Sie Bearbeiten für das Benachrichtigungsdienstkonto und Weitere Rolle hinzufügen aus und fügen Sie dann die Rolle Pub/Sub-Publisher hinzu.

Legen Sie als Nächstes den Benachrichtigungskanal in einer Benachrichtigungsrichtlinie fest.

Benachrichtigungskanal in einer Benachrichtigungsrichtlinie festlegen

Wählen Sie Pub/Sub als Kanaltyp aus und wählen Sie dann das Thema aus, um einen Pub/Sub-Benachrichtigungskanal in einer Benachrichtigungsrichtlinie zu verwenden.

Beispiel für Schema

Wenn Sie ein Beispiel für ein JSON-Paket und das Schema aufrufen möchten, maximieren Sie die folgenden Abschnitte.

JSON-Beispiele

Hier ist ein Beispiel für ein solches Paket:


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity"
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

Schemastruktur, Version 1.2

In einem zurückgegebenen Paket können die Felder in beliebiger Reihenfolge vorkommen. In der folgenden Beschreibung sind sie in verwandte Gruppen unterteilt.

{
  "version": "1.2",
  "incident": {

    Informationen zum Vorfall.

    "incident_id": String, generierte ID für diesen Vorfall.
    "scoping_project_id": String, die Projekt-ID, auf der der Messwertbereich gehostet wird.
    "scoping_project_number": Zahl, die Projektnummer des Projekts zur Festlegung des Umfangs.
    "url": String, Google Cloud Console-URL für diesen Vorfall.
    "started_at": Nummer und Zeit (in Unix-Epoch-Sekunden), zu der der Vorfall geöffnet wurde.
    "ended_at": Nummer und Zeit (in Unix-Epochen-Sekunden), zu der der Vorfall geschlossen wurde. Wird nur gefüllt, wenn state closed ist.
    "state": String, Status des Vorfalls: open oder closed. Wenn open, dann ist ended_at null.
    "summary": String, generierte Zusammenfassung des Vorfalls in Textform.
    "apigee_url": String, Apigee-URL für diesen Vorfall, nur für die Apigee-Ressourcentypen Environment und Proxy*.
    "observed_value": String, beobachteter Wert, der die Benachrichtigung ausgelöst/geklärt hat, können leer sein, wenn die Bedingung abgelaufen ist.

    Informationen zur überwachten Ressource, für die der Vorfall geöffnet wurde.

    "resource": {
      "type": String, Kennung des Typs der überwachten Ressource, für den Benachrichtigungen ausgegeben werden sollen, z. B. gce_instance; siehe Liste der überwachten Ressourcen.
      "labels": und Schlüssel/Wert-Paare für Labels, die der überwachten Ressource zugeordnet sind.
    },
    "resource_type_display_name": String, Anzeigename des Typs der überwachten Ressource.
    "resource_id": String, Instanz-ID der überwachten Ressource, entspricht dem Wert von resource.labels.instance_id.
    "resource_display_name": String, Anzeigename der überwachten Ressource.
    "resource_name": String, generierter Name dieser überwachten Ressource; besteht aus Werten aus anderen Feldern.

    Informationen zum Messwerttyp der Zeitreihendaten.

    "metric": {
      "type": String, Kennung des Messwerttyps, für den Benachrichtigungen ausgegeben werden sollen, z. B. compute.googleapis.com/instance/cpu/utilization; siehe Liste der Messwerte.
      "displayName": String, Anzeigename des Messwerttyps.
      "labels": und Schlüssel/Wert-Paare für Labels, die dem Messwert zugeordnet sind.
    },
    "metadata": {
      "system_labels": Objekt, Schlüssel/Wert-Paare für Systemmetadatenlabels.
      "user_labels": und Schlüssel/Wert-Paare für Nutzermetadatenlabels.
    },

    Informationen zur Benachrichtigungsrichtlinie und -bedingung, durch die der Vorfall geöffnet/behoben wurde.
    Die Werte werden aus dem entsprechenden AlertPolicy-Objekt abgerufen.

    "policy_name": String, Anzeigename für die Benachrichtigungsrichtlinie.
    "policy_user_labels": Objekt, Schlüssel/Wert-Paare für alle Nutzerlabels, die mit der Richtlinie verknüpft sind.
    "documentation": -Objekt, eine eingebettete Struktur des Formulars Documentation.
    "condition": Objekt, eine eingebettete Struktur vom Typ Condition.
    "condition_name": String, Anzeigename der Bedingung, derselbe Wert wie condition.displayName.
    "severity": String, Schweregrad der Vorfälle. Wenn dieses Feld beim Erstellen der Benachrichtigungsrichtlinie nicht definiert wird, legt Cloud Monitoring den Schweregrad der Benachrichtigungsrichtlinie auf no severity fest.
    "threshold_value": String, der Schwellenwert dieser Bedingung. Er kann leer sein, wenn es sich nicht um eine Schwellenbedingung handelt.
  },
}

Einstellungsrichtlinie

Google Chat

Mit der Google Cloud Monitoring App können Ihre Google Chat-Bereiche folgende Aktionen ausführen: Benachrichtigungen erhalten.

Hinweis

Wenn Sie zu einer Organisation gehören, benötigen Sie Zugriff auf die Google Cloud Monitoring App, um sie zu installieren. Wenn Sie keinen Zugriff haben, bitten Sie einen Google Workspace-Administrator, Folgendes zu tun:

Google Cloud Monitoring App installieren

Gehen Sie bei der Installation des Google Cloud Monitoring-Anwendung Installation über die Google Workspace Marketplace-Eintrag wird nicht unterstützt.

Um die App zu installieren und einen Gruppenbereich als Benachrichtigungskanal:

Öffnen oder erstellen Sie in Google Chat den Gruppenbereich, in dem Sie Benachrichtigungen erhalten möchten.
Installieren Sie die Google Cloud Monitoring-Anwendung:
1. Wählen Sie den Namen Ihres Gruppenbereichs und dann Apps und Integrationen aus.
2. Wenn die Google Cloud Monitoring App nicht in der Liste der Apps angezeigt wird, Kehren Sie dann zu Ihrem Gruppenbereich zurück, geben Sie @Google Cloud Monitoring ein und dann drücken Sie die Eingabetaste.
3. Klicken Sie auf Zu Gruppenbereich hinzufügen.
Kopieren Sie die ID des Gruppenbereichs in die Zwischenablage.

Wenn Sie die Google Cloud Monitoring App installiert haben, ist die Chatbereich-ID in der Installationsbestätigung enthalten. Andernfalls finden Sie die Chatbereichs-ID als Zahlen- und Buchstabenfolge nach space/ am Ende der URL des Chatbereichs.
Öffnen Sie einen neuen Browsertab und konfigurieren Sie den Benachrichtigungskanal:
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 Google Chat auf Neu hinzufügen.
4. Geben Sie die ID des Chatbereichs in das Feld Chatbereich-ID ein und klicken Sie dann auf Speichern.

Kanal on demand erstellen

Wenn Sie einer Benachrichtigungsrichtlinie einen Benachrichtigungskanal hinzufügen, müssen Sie einen Kanal aus einer Liste auswählen. So aktualisieren Sie die Liste der Optionen beim Erstellen einer Benachrichtigungsrichtlinie:

Klicken Sie im Benachrichtigungsdialogfeld auf Benachrichtigungskanäle verwalten. Sie werden in einem neuen Browsertab zum Fenster Benachrichtigungskanäle weitergeleitet.
Um einen neuen Benachrichtigungskanal hinzuzufügen, suchen Sie den Kanaltyp, klicken Sie auf Neu hinzufügen und folgen Sie dann der kanalspezifischen Anleitung in der vorherigen Tabelle.
Kehren Sie zum ursprünglichen Tab zurück und klicken Sie im Benachrichtigungsdialogfeld auf Aktualisieren.
Wählen Sie den Benachrichtigungskanal aus der aktualisierten Liste aus.

Benachrichtigungen auf einem nicht unterstützten Kanal erhalten

Wenn Ihr bevorzugter Benachrichtigungskanal nicht unterstützt wird, können Sie eine Pipeline erstellen, über die Ihre Benachrichtigungen an Pub/Sub gesendet werden. Ein Python-Beispiel, das Flask verwendet, finden Sie unter Benutzerdefinierte Benachrichtigungen mit Cloud Monitoring und Cloud Run erstellen Weitere Beispiele finden Sie in der cloud-alerting-notification-forwarding Git-Repository.

Benachrichtigungskanal testen

Cloud Monitoring unterstützt keine Testoption für Benachrichtigungskanäle. Sie können jedoch prüfen, ob ein Benachrichtigungskanal richtig konfiguriert ist, indem Sie eine Benachrichtigungsrichtlinie erstellen und die Bedingung konfigurieren, die erfüllt sein muss.

Wenn Sie Ihre Benachrichtigungskanäle manuell testen möchten, können Sie eine Benachrichtigungsrichtlinie erstellen, mit der die CPU-Auslastung einer Ihrer VM-Instanzen überwacht wird:

Optional: Wenn Sie in Ihrem Google Cloud-Projekt noch keine VM haben oder um eine andere VM zum Testen zu verwenden, und erstellen Sie dann eine VM:
1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf:
  Zu Seite VM-Instanzen
  
  Wenn Sie diese Seite über die Suchleiste finden, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Compute Engine lautet.
2. Wählen Sie Instanz erstellen aus und konfigurieren Sie dann Ihre VM. Weitere Informationen zum Erstellen von VMs finden Sie unter VM-Instanz aus einem öffentlichen Image erstellen.
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.
Wählen Sie Richtlinie erstellen aus.
Wählen Sie im Menü Messwert auswählen den Messwert CPU-Auslastung aus. für eine VM-Instanz.
Klicken Sie auf Filter hinzufügen und fügen Sie einen Filter für Ihre VM hinzu.
Aktualisieren Sie die Felder Trigger konfigurieren so:
1. Wählen Sie für das Feld Grenzwert die Option Unter Grenzwert aus.
2. Wählen Sie einen Wert aus, der über der CPU-Auslastung Ihrer Instanz liegt. Wenn die CPU-Auslastung im Diagramm beispielsweise etwa 5 % beträgt, legen Sie den Grenzwert auf 10 % fest.
  
  Mit diesen Einstellungen wird die Bedingung erfüllt, wenn die CPU-Auslastung einer VM-Instanz unter dem angegebenen Grenzwert liegt. Da Sie den Grenzwert so festgelegt haben, dass er über der CPU-Auslastung Ihrer VM-Instanz liegt, ist die Bedingung der Benachrichtigungsrichtlinie erfüllt.
Fügen Sie Ihrer Richtlinie die Benachrichtigungskanäle hinzu.
Maximieren Sie Dauer bis zur automatischen Schließung von Vorfällen und wählen Sie 30 Min. aus.
Geben Sie einen Richtliniennamen ein und klicken Sie auf Richtlinie erstellen.
Sobald die Bedingung erfüllt ist, prüfen Sie, ob Sie eine Benachrichtigung für jeden Benachrichtigungskanal.
Löschen Sie die Benachrichtigungsrichtlinie. Der Vorfall wird automatisch geschlossen, wenn die Dauer bis zur automatischen Schließung abgelaufen ist.
Wenn Sie eine VM-Instanz für diesen Test erstellt haben, löschen Sie sie.

Wenn Sie nicht die erwarteten Benachrichtigungen erhalten, können Sie Suchen Sie im Log-Explorer nach Logeinträgen mit Informationen zu den fehlenden Benachrichtigungen. Weitere Informationen finden Sie unter Benachrichtigungen werden nicht empfangen.

Benachrichtigungskanäle bearbeiten und löschen

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

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.
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).

Logs zu Benachrichtigungskanälen ansehen

Sie können den Log-Explorer verwenden, um Fehler von Benachrichtigungskanälen anzusehen:

Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.
Zum Log-Explorer

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Geben Sie die Abfrage ein und führen Sie sie aus. Informationen zu Abfragen, die sich speziell auf Fehler bei Benachrichtigungskanälen beziehen, finden Sie unter Cloud Monitoring-Abfragen.

Nächste Schritte

Informationen zu Vorfällen finden Sie in den folgenden Dokumenten: