Benachrichtigungskanäle für Benachrichtigungen konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Benachrichtigungskanäle konfigurieren, um Benachrichtigungen zu erhalten.

Benachrichtigungskanäle sind die Zustellungsmechanismen für Ihre konfigurierten Benachrichtigungen. Das System benachrichtigt die angegebenen Empfänger über diese Kanäle, wenn ein Ereignis eine Benachrichtigung auslöst. So wird sichergestellt, dass wichtige Warnungen die entsprechenden Mitarbeiter über ihre bevorzugten Kommunikationsmethoden erreichen.

In GDC-Umgebungen (Google Distributed Cloud) mit Air Gap sind vordefinierte Benachrichtigungskanäle wie Slack oder E-Mail nicht verfügbar. Wenn Sie Benachrichtigungen erhalten möchten, müssen Sie mindestens einen benutzerdefinierten Benachrichtigungskanal konfigurieren. Sie bearbeiten benutzerdefinierte ObservabilityPipeline-Ressourcen in Ihrem Projekt-Namespace, um Kanalkonfigurationen anzuwenden.

Durch das Anpassen von Benachrichtigungskanälen können Administratoren Folgendes erreichen:

  • Bestimmte Empfänger ansprechen: Leiten Sie Benachrichtigungen an Einzelpersonen, Teams oder Bereitschaftsdienste weiter, die für die Behebung von Problemen verantwortlich sind.
  • Bevorzugte Kommunikationsmethoden verwenden: Benachrichtigungen können über Kanäle wie SMS, PagerDuty, Webhooks oder benutzerdefinierte Integrationen gesendet werden, um individuellen Präferenzen und betrieblichen Workflows gerecht zu werden.
  • Benachrichtigungsmüdigkeit verhindern: Reduzieren Sie die Anzahl der Benachrichtigungen und sorgen Sie dafür, dass Benachrichtigungen von den Personen empfangen werden, die Maßnahmen ergreifen müssen.

Für die Implementierung von Benachrichtigungskanälen in GDC müssen Administratoren die Kanalkonfiguration im System definieren. Dazu müssen in der Regel Parameter wie die folgenden angegeben werden:

  • Kanaltyp: der verwendete Kanaltyp.
  • Ziel: der Endpunkt, an den das System Benachrichtigungen senden soll.
  • Authentifizierung: alle erforderlichen Anmeldedaten für den Zugriff auf das Ziel.

Durch die Konfiguration von Benachrichtigungskanälen können Administratoren dafür sorgen, dass die Monitoring-Plattform wichtige Warnungen effektiv sendet. So können sie schnell auf potenzielle Probleme reagieren und die Stabilität und Leistung von GDC-Umgebungen aufrechterhalten.

Hinweis

Zum Verwalten von benutzerdefinierten ObservabilityPipeline-Ressourcen benötigen Sie die erforderlichen Berechtigungen.

IAM-Organisationsrollen anfordern

Wenden Sie sich an Ihren IAM-Organisationsadministrator, um die folgenden Rollen anzufordern:

  • ObservabilityPipeline PA Creator (observabilitypipeline-pa-creator): Erstellt benutzerdefinierte ObservabilityPipeline-Ressourcen.
  • ObservabilityPipeline PA Editor (observabilitypipeline-pa-editor): Bearbeiten oder ändern Sie benutzerdefinierte ObservabilityPipeline-Ressourcen.
  • ObservabilityPipeline PA Viewer (observabilitypipeline-pa-viewer): Zum Aufrufen von benutzerdefinierten ObservabilityPipeline-Ressourcen.
  • ConfigMap-Editor (observabilitypipeline-configmap-editor): Erstellen von ConfigMap-Objekten im Plattform-Namespace.

IAM-Projektrollen anfordern

Wenden Sie sich an Ihren IAM-Projektadministrator, um die folgenden Rollen anzufordern:

  • ObservabilityPipeline Editor (observabilitypipeline-editor): Bearbeiten oder ändern Sie benutzerdefinierte ObservabilityPipeline-Ressourcen im Projekt-Namespace.
  • ObservabilityPipeline Viewer (observabilitypipeline-viewer): Zum Aufrufen von benutzerdefinierten ObservabilityPipeline-Ressourcen im Projekt-Namespace.

Benachrichtigungskanäle konfigurieren

Konfigurieren Sie Benachrichtigungskanäle für Benachrichtigungen in Ihrem Projekt-Namespace:

  1. Definieren Sie Ihre benutzerdefinierte Konfiguration für Benachrichtigungskanäle in einer YAML-Datei mit dem Namen alertmanager.yml. Sie müssen dieselbe Syntax wie in der Alertmanager-Spezifikation verwenden:

    https://prometheus.io/docs/alerting/latest/configuration/.

  2. Erstellen Sie ein ConfigMap-Objekt und fügen Sie Ihre benutzerdefinierte Konfiguration aus der alertmanager.yml-Datei in das Feld data ein.

    Das folgende Beispiel zeigt, wie das ConfigMap-Objekt mit der alertmanager.yml-Datei aussehen muss:

    apiVersion: v1
kind: ConfigMap
metadata:
  name: CONFIGMAP_NAME
  # The namespace must match your project namespace.
  namespace: PROJECT_NAMESPACE
data:
  # The file name must be alertmanager.yml
  alertmanager.yml: |
    # Define your notification channels.
    # Add the custom configuration in the following lines of this file.
    # Follow the same syntax as in https://prometheus.io/docs/alerting/latest/configuration

  [...]

    Ersetzen Sie Folgendes:

    • CONFIGMAP_NAME: der Name der ConfigMap-Definitionsdatei. Sie verwenden diesen Namen später in der benutzerdefinierten Ressource ObservabilityPipeline.
    • PROJECT_NAMESPACE: Ihr Projekt-Namespace.

  3. Wenden Sie das ConfigMap-Objekt auf den Management API-Server im selben Namespace wie Ihre konfigurierten Benachrichtigungen an:

    kubectl --kubeconfig KUBECONFIG_PATH apply -f CONFIGMAP_NAME.yaml

    Ersetzen Sie Folgendes:

    • KUBECONFIG_PATH: der Pfad zur kubeconfig-Datei für den Management API-Server.
    • CONFIGMAP_NAME: der Name der ConfigMap-Definitionsdatei.

  4. Bearbeiten Sie die Spezifikation der benutzerdefinierten Ressource ObservabilityPipeline, um Ihre Konfiguration in das Feld alertmanagerConfig zu importieren:

     # Configure the observability pipeline.
apiVersion: observability.gdc.goog/v1
kind: ObservabilityPipeline
metadata:
  # The namespace must match your project namespace.
  namespace: PROJECT_NAMESPACE
  name: OBSERVABILITY_PIPELINE_NAME
spec:
  # Configure alerts.
  alerting:
    # The alerting configuration must be in the ConfigMap.
    # The value must match the ConfigMap name exactly.
    alertmanagerConfig: CONFIGMAP_NAME

  [...]

    Ersetzen Sie Folgendes:

    • PROJECT_NAMESPACE: Ihr Projekt-Namespace.
    • OBSERVABILITY_PIPELINE_NAME: der Name der benutzerdefinierten Ressource ObservabilityPipeline.
    • CONFIGMAP_NAME: der Name, den Sie für die ConfigMap-Definitionsdatei verwendet haben. Der Name muss genau übereinstimmen.

  5. Speichern Sie die Datei.

  6. Wenden Sie die Änderungen der benutzerdefinierten Ressource ObservabilityPipeline auf den Management API-Server im selben Namespace wie Ihre konfigurierten Benachrichtigungen an:

    kubectl --kubeconfig KUBECONFIG_PATH apply -f OBSERVABILITY_PIPELINE_NAME.yaml

    Ersetzen Sie Folgendes:

    • KUBECONFIG_PATH: der Pfad zur kubeconfig-Datei für den Management API-Server.
    • OBSERVABILITY_PIPELINE_NAME: der Name der ObservabilityPipeline-Definitionsdatei.