Criar políticas de alerta com o Terraform

Este documento descreve como usar o Google Cloud provedor do Terraform para criar políticas de alertas no seu projeto Google Cloud . O Google Cloud provedor do Terraform fornece os seguintes recursos para políticas de alerta e canais de notificação:

O Terraform é uma ferramenta para criar, alterar e controlar versões de infraestrutura. Ele usa arquivos de configuração para descrever os componentes necessários para executar um único aplicativo ou toda a infraestrutura. Para mais informações sobre como usar o Terraform, consulte os seguintes documentos:

Antes de começar

Para receber as permissões necessárias para criar políticas de alertas usando o Terraform, peça ao administrador para conceder a você o papel do IAM de Editor do Monitoring (roles/monitoring.editor) no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Para mais informações sobre os papéis do Cloud Monitoring, consulte Controlar o acesso com o Identity and Access Management.

Crie uma política de alertas

Para criar uma política de alertas no seu projeto Google Cloud , faça o seguinte:

  1. Instale e configure o Terraform.

  2. No Cloud Shell, acesse o diretório que contém sua configuração do Terraform.

  3. Edite o arquivo de configuração e adicione sua política de alertas.

    Por exemplo, a configuração a seguir define uma política de alertas que envia uma notificação quando a utilização da CPU de uma instância de VM é maior que 50% por mais de um minuto, com notificações repetidas enviadas a 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 = "50"
        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"
  }
}

    No exemplo anterior, o campo notification_channels define o canal de notificação da política de alertas. O campo notification_channel_names configura esse canal de notificação para enviar notificações repetidas. Ambos os campos fazem referência a um canal de notificação com um display_name de email, que é definido em outro lugar na configuração do Terraform. Para mais informações, consulte Criar e gerenciar canais de notificação com o Terraform.

    É possível usar rótulos para associar uma política de alertas a um aplicativo do App Hub. Para mais informações, consulte Como associar uma política de alertas a um aplicativo do App Hub.

  4. No Cloud Shell, insira terraform apply.

Para modificar a política de alertas, faça as edições e reaplique a configuração do Terraform. Para mais informações, consulte Gerenciar políticas de alertas com o Terraform.

A seguir