Benachrichtigungsrichtlinien mit Terraform erstellen

In diesem Dokument wird beschrieben, wie Sie mit dem Google Cloud Terraform-Anbieter Benachrichtigungsrichtlinien in Ihrem Google Cloud-Projekt erstellen. Der Google Cloud Terraform-Anbieter stellt die folgenden Ressourcen für Benachrichtigungsrichtlinien und Benachrichtigungskanäle bereit:

Terraform ist ein Tool zum Erstellen, Ändern und zur Versionsverwaltung von Infrastruktur. Terraform verwendet Konfigurationsdateien, um die Komponenten zu beschreiben, die zum Ausführen einer einzelnen Anwendung oder Ihrer gesamten Infrastruktur erforderlich sind. Weitere Informationen zur Verwendung von Terraform finden Sie in den folgenden Dokumenten:

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.editor) für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Erstellen von Benachrichtigungsrichtlinien mithilfe von Terraform benötigen. 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.

Benachrichtigungsrichtlinie erstellen

So erstellen Sie eine Benachrichtigungsrichtlinie in Ihrem Google Cloud-Projekt:

  1. Prüfen Sie, ob Terraform in Cloud Shell installiert ist.

  2. Wechseln Sie in Cloud Shell zu dem Verzeichnis, das Ihre Terraform-Konfiguration enthält.

  3. Bearbeiten Sie die Konfigurationsdatei und fügen Sie Ihre Benachrichtigungsrichtlinie hinzu.

    Die folgende Konfiguration definiert beispielsweise eine Benachrichtigungsrichtlinie, die eine Benachrichtigung sendet, wenn die CPU-Auslastung einer VM-Instanz über eine Minute lang über 50% liegt, wobei wiederholte Benachrichtigungen alle 30 Minuten gesendet werden.

    resource "google_monitoring_alert_policy" "alert_policy" {
      display_name = "CPU Utilization > 50%"
      documentation {
        content = "The $${metric.display_name} of the $${resource.type} $${resource.label.instance_id} in $${resource.project} has exceeded 50% for over 1 minute."
      }
      combiner     = "OR"
      conditions {
        display_name = "Condition 1"
        condition_threshold {
            comparison = "COMPARISON_GT"
            duration = "60s"
            filter = "resource.type = \"gce_instance\" AND metric.type = \"compute.googleapis.com/instance/cpu/utilization\""
            threshold_value = "0.5"
            trigger {
              count = "1"
            }
        }
      }
    
      alert_strategy {
        notification_channel_strategy {
            renotify_interval = "1800s"
            notification_channel_names = [google_monitoring_notification_channel.email.name]
        }
      }
    
      notification_channels = [google_monitoring_notification_channel.email.name]
    
      user_labels = {
        severity = "warning"
      }
    }
    

    Im vorherigen Beispiel definiert das Feld notification_channels den Benachrichtigungskanal für die Benachrichtigungsrichtlinie. Mit dem Feld notification_channel_names wird dieser Benachrichtigungskanal so konfiguriert, dass wiederholte Benachrichtigungen gesendet werden. Beide Felder verweisen auf einen Benachrichtigungskanal mit einem display_name von email, der an anderer Stelle in der Terraform-Konfiguration definiert ist. Weitere Informationen finden Sie unter Benachrichtigungskanäle mit Terraform erstellen und verwalten.

  4. Geben Sie in Cloud Shell terraform apply ein.

Wenn Sie die Benachrichtigungsrichtlinie ändern möchten, nehmen Sie die gewünschten Änderungen vor und wenden Sie die Terraform-Konfiguration dann noch einmal an. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien mit Terraform verwalten.

Nächste Schritte