Criar políticas de alertas com uma condição baseada em PromQL (Console)

Nesta página, descrevemos como criar uma política de alertas com uma condição baseada em PromQL usando o console do Google Cloud.

Antes de começar

1. Para ter as permissões necessárias para criar políticas de alertas com uma condição baseada em PromQL no console do Google Cloud, peça ao administrador para conceder a você o papel de IAM de Editor do Monitoring (roles/monitoring.editor) no seu projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

   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.

2. Verifique se você conhece os conceitos gerais de políticas de alertas e do PromQL no Cloud Monitoring. Para mais informações, consulte os tópicos a seguir:

   • Visão geral de alertas
   • PromQL no Cloud Monitoring

3. Configure os canais de notificação que você quer usar para receber alertas. Para fins de redundância, recomendamos que você crie vários tipos de canais de notificação. Para saber mais, consulte Criar e gerenciar canais de notificação.

4. Se a consulta do PromQL na sua política de alertas usa uma métrica personalizada, é necessário que a métrica já exista.

Criar políticas de alertas do PromQL

Para criar uma política de alertas com uma condição baseada em PromQL no Console do Google Cloud, faça o seguinte:

1. No console do Google Cloud, acesse a página  Alertas:

   Acessar Alertas

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

2. Na página Alertas, clique em Criar política.

3. Em Modo de configuração da política, selecione Editor de código (MQL ou PromQL).

4. Verifique se PromQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.

5. Insira a consulta do PromQL que seleciona os dados que você quer monitorar. Se a Execução automática não estiver ativada, clique em Executar consulta.

   Por exemplo, a consulta a seguir resume a taxa de dados de registro de faturamento ingeridos em um intervalo de 60 segundos e determina se a taxa resumida tem mais de 300 bytes:

   sum(rate(logging_googleapis_com:billing_bytes_ingested{monitored_resource="global"}[60s]))>300
   

   Depois de executar a consulta, você verá um gráfico. Para um projeto, esta consulta produziu o resultado seguinte:

   

6. Clique em Próxima e configure o acionador do alerta.

   1. Selecione um valor para o Acionador de alerta. Esse valor especifica quantas série temporal retornadas pela consulta precisam atender à operação de alerta antes que a política de alertas possa ser acionada. Você pode selecionar entre os seguintes critérios:

      • Qualquer série temporal.
      • Uma porcentagem da série temporal.
      • Um número específico de séries temporais.
      • Todas as séries temporais.

   2. Selecione uma Janela de novo teste. Esse campo define por quanto tempo a condição precisa ser atendida antes que a política de alertas seja acionada.

      O valor padrão é 0 s. Com essa configuração, uma única medição pode resultar em uma notificação. Para mais informações e um exemplo, consulte Configurações de período e duração de alinhamento.

   3. Para selecionar a frequência com que os alertas avaliam a consulta do PromQL, escolha um valor para o Intervalo de avaliação.

   4. Digite um nome para a condição e clique em Próxima.

7. Adicionar canais de notificação.

8. Opcional: adicione rótulos de políticas de alertas e documentação.

9. Clique em Nome e digite um nome para a política de alertas.

10. Clique em Criar política.

Para ver todas as etapas, consulte Como gerenciar políticas de alertas.