Gerenciar políticas de alerta com o Terraform

O provedor do Google Cloud Terraform permite editar, excluir e exportar políticas de alertas no seu Google Cloud projeto. Você configura políticas de alertas e canais de notificação usando os google_monitoring_alert_policy e google_monitoring_notification_channel recursos.

O Terraform usa arquivos de configuração para criar, alterar e versionar os componentes necessários para executar um único aplicativo ou toda a infraestrutura. Para mais informações sobre como usar o Terraform, consulte a documentação do Terraform Google Cloud , a Google Cloud referência do provedor do Terraform e o artigo Introdução ao Google Cloud.

Antes de começar

Para receber as permissões necessárias para modificar políticas de alertas usando o Terraform, peça que o administrador conceda a você os seguintes papéis do IAM no 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 com papéis personalizados ou 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.

Editar ou excluir políticas de alertas

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

  1. Instale e configure o Terraform para seu projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.

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

  3. Edite o arquivo de configuração, localize o recurso google_monitoring_alert_policy da política de alertas e modifique ou exclua esse recurso.

  4. No Cloud Shell, digite terraform apply.

Exportar uma configuração de política de alertas para uma configuração do Terraform

É possível exportar uma configuração de política de alertas do Google Cloud para uma definição do Terraform na configuração do Terraform. Esse processo é útil se você criou uma política de alertas no Google Cloud depois de criar a configuração do Terraform.

Para exportar a política de alertas, faça o seguinte:

  1. Instale e configure o Terraform para seu projeto. Para App Hub configurações, selecione o projeto host do App Hub ou o projeto de gerenciamento.

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

  3. Adicione um import bloco a um arquivo na sua configuração do Terraform. O bloco de importação tem os seguintes argumentos:

    • to: o endereço do recurso conforme especificado pela sua configuração do Terraform. Esse campo tem o formato de google_monitoring_alert_policy.RESOURCE_NAME, em que RESOURCE_NAME é um valor escolhido por você. Recomendamos escolher um nome de recurso que descreva claramente a política de alertas.

    • id: o nome da política de alertas. Esse campo tem o formato de project/PROJECT_ID/alertPolicies/ALERT_POLICY_ID.

    Por exemplo, você quer exportar uma política de alertas que monitora o uso da CPU. Portanto, defina RESOURCE_NAME como cpu_usage_threshold. Em seguida, defina id como o nome da política de alertas:

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

  4. No Cloud Shell, execute este comando:

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

    O comando anterior cria um arquivo chamado generated.tf, que permite revisar a definição da política de alertas antes de adicioná-la à configuração do Terraform. Você pode editar a definição, movê-la para um arquivo diferente ou deixá-la inalterada.

  5. No Cloud Shell, digite terraform apply para importar a definição da política de alertas para a configuração do Terraform.

Para mais informações sobre como gerar definições de recursos que não fazem parte da configuração do Terraform, consulte Gerar configuração.

A seguir

  • Saiba mais sobre o Terraform (em inglês).
  • Teste exemplos de código que usam o Google Cloud provedor do Terraform com o Cloud Monitoring.
  • Acesse o Google Cloud repositório do provedor do Terraform no GitHub (link em inglês).
  • Registre um problema no GitHub para relatar um bug ou fazer uma pergunta sobre o Terraform.