Administra las políticas de alertas con Terraform

En este documento, se describe cómo usar el proveedor de Terraform de Google Cloud para editar y borrar 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 modificar las políticas de alertas con Terraform, pídele a tu administrador que te otorgue el rol de IAM Editor de Monitoring (roles/monitoring.alertPolicyEditor) 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.

Edita o borra políticas de alertas

Para editar o borrar 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, ubica el recurso google_monitoring_alert_policy para tu política de alertas y, luego, modifica o borra ese recurso.

  4. En Cloud Shell, ingresa terraform apply.

Exporta una configuración de política de alertas a una configuración de Terraform

Puedes exportar una configuración de política de alertas de Google Cloud a una definición de Terraform en tu configuración de Terraform. Este proceso es útil si creaste una política de alertas en Google Cloud después de crear la configuración de Terraform.

Para exportar tu política de alertas, 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. Agrega un bloque import a un archivo en la configuración de Terraform. El bloque de importación tiene los siguientes argumentos:

    • to: Es la dirección del recurso según lo especificado en tu configuración de Terraform. Este campo tiene el formato google_monitoring_alert_policy.RESOURCE_NAME, en el que RESOURCE_NAME es un valor que eliges. Recomendamos elegir un nombre de recurso que describa con claridad tu política de alertas.

    • id: Es el nombre de la política de alertas. Este campo tiene el formato project/PROJECT_ID/alertPolicies/ALERT_POLICY_ID.

    Por ejemplo, si deseas exportar una política de alertas que supervise el uso de CPU, configura RESOURCE_NAME como cpu_usage_threshold. Luego, configura id como el nombre de la política de alertas:

    import {
to = google_monitoring_alert_policy.cpu_usage_threshold
id = "projects/my-alerting-project/alertPolicies/7160801095019277297"
}

  4. En Cloud Shell, ejecuta el siguiente comando:

    terraform plan -generate-config-out=generated.tf

    Con el comando anterior, se crea un archivo llamado generated.tf, que te permite revisar la definición de la política de alertas antes de agregarla a la configuración de Terraform. Puedes editar la definición, moverla a un archivo diferente o dejarla sin cambios.

  5. En Cloud Shell, ingresa terraform apply para importar la definición de la política de alertas a la configuración de Terraform.

Si quieres obtener más información para generar definiciones de recursos que no son parte de tu configuración de Terraform, consulta Genera la configuración.

¿Qué sigue?