Criar políticas de alertas baseadas em PromQL (console)

Esta página descreve como criar políticas de alertas baseadas em PromQL usando o Google Cloud console.

Antes de começar

1. Para receber as permissões necessárias para criar políticas de alertas baseadas em PromQL no Google Cloud console, peça ao administrador para conceder a você o papel Editor do Monitoring (roles/monitoring.editor) do IAM 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 usando personalizados papéis ou outros predefinidos papéis.

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

2. Familiarize-se com os conceitos gerais das políticas de alertas e do PromQL no Cloud Monitoring. Para mais informações, consulte os tópicos a seguir:

   • Informações gerais sobre 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 PromQL na política de alertas fizer referência a métricas, elas já precisarão existir no Monitoring quando você criar a política de alertas.

Criar políticas de alertas do PromQL

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

1. No Google Cloud console do, 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 Monitoring.

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 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 é maior que 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 faça o seguinte:

   1. 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 segundos. 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 do alinhamento.

   2. Para selecionar a frequência com que o alerta avalia a consulta PromQL, escolha um valor para o intervalo de avaliação.

      **Observação** os incidentes criados por uma política de alertas baseada em PromQL não seguem a duração do fechamento automático da política de alertas. Em vez disso, o incidente é fechado automaticamente quando atinge um tempo definido após a última vez em que a condição foi atendida. Esse tempo é o maior de 270 segundos e duas vezes o intervalo de avaliação da condição.

   3. Insira um nome para a condição e clique em Próxima.

7. Clique em Próxima e faça o seguinte:

   1. Adicionar canais de notificação.

   2. Escolha um nível de gravidade para incidentes.

   3. Opcional: adicione rótulos da política de alertas e documentação.

   4. Insira um nome para a política de alertas.

8. Clique em Criar política.

Para conferir as etapas completas, consulte Gerenciar políticas de alertas.