Gestionar políticas de alertas con Terraform

En este documento se describe cómo usar el proveedor deGoogle Cloud Terraform para editar y eliminar políticas de alertas en tu proyecto de Google Cloud . 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 versionar infraestructuras. Utiliza 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 se admite en proyectos de Google Cloud . En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

Antes de empezar

Para obtener los permisos que necesitas para modificar políticas de alertas con Terraform, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu proyecto:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Para obtener más información sobre los roles de Cloud Monitoring, consulta Controlar el acceso con Gestión de Identidades y Accesos.

Editar o eliminar políticas de alertas

Para editar o eliminar una política de alertas de tu Google Cloud proyecto, haz lo siguiente:

  1. Instala y configura Terraform para tu proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

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

  3. Edita el archivo de configuración, busca el google_monitoring_alert_policy recurso de tu política de alertas y, a continuación, modifícalo o elimínalo.

  4. En Cloud Shell, escribe terraform apply.

Exportar la configuración de una política de alertas a una configuración de Terraform

Puede exportar una configuración de política de alertas de Google Cloud a una definición de Terraform en su configuración de Terraform. Este proceso es útil si has creado una política de alertas en Google Clouddespués de crear tu configuración de Terraform.

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

  1. Instala y configura Terraform para tu proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

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

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

    • to: la dirección del recurso tal como se especifica en la configuración de Terraform. Este campo tiene el formato google_monitoring_alert_policy.RESOURCE_NAME, donde RESOURCE_NAME es el valor que elijas. Te recomendamos que elijas un nombre de recurso que describa claramente tu política de alertas.

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

    Por ejemplo, quieres exportar una política de alertas que monitorice el uso de la CPU, por lo que asignas el valor RESOURCE_NAME a cpu_usage_threshold. A continuación, define id como 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 la política de alertas antes de añadirla a tu configuración de Terraform. Puedes editar la definición, moverla a otro archivo o dejarla como está.

  5. En Cloud Shell, introduce 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 de recursos que no forman parte de tu configuración de Terraform, consulta Generar configuración.

Siguientes pasos