Administra políticas de alertas con Terraform

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

Terraform es una herramienta para crear, cambiar y controlar las versiones de la infraestructura. Usa archivos de configuración para 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:

Esta función solo es compatible con Google Cloud proyectos. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

Antes de comenzar

Para obtener los permisos que necesitas para modificar las políticas de alertas con Terraform, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles 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 Google Cloud proyecto, haz lo siguiente:

  1. Instala y configura Terraform para tu proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

  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 desde 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 tu configuración de Terraform.

Para exportar tu política de alertas, haz lo siguiente:

  1. Instala y configura Terraform para tu proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

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

  3. Agrega un import bloque a un archivo en tu configuración de Terraform. El bloque de importación tiene los siguientes argumentos:

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

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

    Por ejemplo, deseas exportar una política de alertas que supervise el uso de CPU, por lo que estableces RESOURCE_NAME en cpu_usage_threshold. Luego, estableces 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

    El comando anterior crea un archivo llamado generated.tf, que te permite revisar la definición de tu política de alertas antes de agregarla a tu 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 tu política de alertas a tu configuración de Terraform.

Para obtener más información sobre cómo generar definiciones para recursos que no forman parte de tu configuración de Terraform, consulta Genera la configuración.

¿Qué sigue?

  • Obtén más información sobre Terraform.
  • Prueba muestras de código que usan el Google Cloud proveedor de Terraform con Cloud Monitoring.
  • Visualiza el Google Cloud proveedor de Terraform repositorio en GitHub.
  • Presenta un problema en GitHub para informar un error o hacer una pregunta sobre Terraform.