Crea políticas de alertas con Terraform

En este documento, se describe cómo usar el proveedor de Terraform de Google Cloud para crear políticas de alertas en tu proyecto de Google Cloud. El proveedor de Terraform de Google Cloud proporciona los siguientes recursos para las políticas de alertas y los canales de notificaciones:

Terraform es una herramienta para compilar, cambiar y controlar versiones de infraestructuras. Usa archivos de configuración con el fin de describir los componentes necesarios para ejecutar una sola aplicación o toda tu infraestructura. Para obtener más información sobre el uso de Terraform, consulta los siguientes documentos:

Antes de comenzar

Si quieres obtener los permisos que necesitas para crear políticas de alertas con Terraform, pídele a tu administrador que te otorgue el rol de IAM de Editor de Monitoring (roles/monitoring.editor) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

Para obtener más información sobre las funciones de Cloud Monitoring, consulta Controla el acceso con Identity and Access Management.

Crea una política de alertas

Para crear una política de alertas en tu proyecto de Google Cloud, haz lo siguiente:

  1. Asegúrate de que Terraform esté instalado en Cloud Shell.

  2. En Cloud Shell, ve al directorio que contiene tu configuración de Terraform.

  3. Edita el archivo de configuración y agrega tu política de alertas.

    Por ejemplo, la siguiente configuración define una política de alertas que envía una notificación cuando el uso de CPU de una instancia de VM es superior al 50% durante más de un minuto, con notificaciones repetidas que se envían cada 30 minutos.

    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"
  }
}

    En el ejemplo anterior, el campo notification_channels define el canal de notificaciones para la política de alertas. El campo notification_channel_names configura ese canal de notificaciones para enviar notificaciones repetidas. Ambos campos hacen referencia a un canal de notificaciones con un display_name de email, que se define en otra parte de la configuración de Terraform. Para obtener más información, consulta Crea y administra canales de notificaciones con Terraform.

  4. En Cloud Shell, ingresa terraform apply.

Para modificar tu política de alertas, realiza las ediciones y, luego, vuelve a aplicar la configuración de Terraform. Para obtener más información, consulta Administra las políticas de alertas con Terraform.

¿Qué sigue?