Administra políticas de alertas con Terraform

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

Terraform es una herramienta para crear, cambiar y controlar las versiones de la infraestructura. 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 para proyectos de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

Antes de comenzar

Para obtener los permisos que necesitas para modificar 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 mediante 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 proyecto de Google Cloud , haz lo siguiente:

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

  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 de tu política de alertas y, luego, modifica o borra ese recurso.

  4. En Cloud Shell, ingresa terraform apply.

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

Puedes exportar una configuración de política de alertas desde Google Clouda una definición de Terraform en tu configuración de Terraform. Este proceso es útil si creaste una política de alertas en Google Clouddespué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 de App Hub o el proyecto de administración de la carpeta habilitada para apps.

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

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

    • to: Es 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 un valor que eliges. Te recomendamos que elijas un nombre de recurso que describa claramente 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 la CPU, debes establecer RESOURCE_NAME en cpu_usage_threshold. Luego, establece 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 otro archivo 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 Cómo generar configuración.

¿Qué sigue?

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