Configurar um alerta baseado em consultas usando o MQL

Criar uma instância do Compute Engine

Para ter um recurso do Google Cloud do qual coletar métricas, crie uma instância do Compute Engine concluindo as seguintes etapas:

1. No menu do console do Google Cloud, selecione Compute Engine.

   

2. Selecione Criar instância e clique em Criar.

Navegar até o editor de código

Para começar a usar MQL, faça o seguinte:

1. No Console do Google Cloud, acesse a página do leaderboard Metrics Explorer:

   Acesse o Metrics explorer

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

2. Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
3. Verifique se MQL 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.

Usar o editor de código para criar, testar e executar consultas MQL.

Executar uma consulta e criar um gráfico

Crie uma consulta que gere um gráfico do uso da CPU da instância:

1. Cole a seguinte consulta no editor de código:

   fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
   | {
       top 1, max(val())
     ;
       bottom 1, min(val())
     }
   | union
   

   Esta consulta seleciona a série temporal com a utilização máxima e mínima da CPU para gráficos. Para mais informações sobre essa consulta, consulte Como combinar seleções com union.

2. Clique em Run. O gráfico exibe duas linhas mostrando a utilização máxima e mínima da CPU da instância:

   

3. Para salvar o gráfico, clique em Salvar gráfico. Dê um nome ao gráfico e adicione-o a um painel existente ou novo. Em seguida, clique em Salvar.

O gráfico pode ser acessado na página Visão geral do Monitoring ou, se você o salvou em um painel, na página desse painel.

Configurar um alerta baseado em consulta

É possível criar uma política de alertas que monitore os resultados de uma consulta. Para criar essa política de alertas, conclua as etapas a seguir:

1. No console do Google Cloud, acesse a página notifications 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 Editar Canais de Notificação. Nesta etapa, você configura um endereço de e-mail para receber notificações com alertas.

   1. Na página Canais de notificação, acesse E-mail e Clique em Adicionar novo.

   2. Digite o endereço de e-mail para o qual você quer que as notificações de alerta sejam enviadas no campo Endereço de e-mail.

   3. Digite uma breve descrição desse canal, como "Alerta em serviço", no campo Nome de exibição.

   4. Clique em Save.

   5. Volte à página Alerta clicando em Voltar arrow_back no cabeçalho da página.

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

   Esta página mostra as etapas para criar uma política de alertas:

   1. Descrevendo o que você quer alertar.
   2. Fornece informações sobre como resolver esse problema.
   3. Especificando um canal de notificação para o alerta.

4. Para descrever sobre o que você quer alertar, clique em Nova condição. Esta ação exibe o editor de condições baseado em formulário.

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

   2. Verifique se MQL 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.

   3. Insira a consulta que seleciona os dados que você deseja monitorar no editor de código. A consulta a seguir aciona um alerta quando o estado O tempo de uso da CPU permanece maior que 20 segundos:

      fetch gce_instance::compute.googleapis.com/instance/cpu/usage_time
      | window 1m
      | condition val() > 20 's'
      

      A operação condition estabelece o limite de desempenho desejado para receber alertas. Para mais informações sobre condition e outras operações de alerta, consulte Alertas na referência do MQL.

      Se a opção Executar automaticamente estiver ativada, o gráfico MQL mostra os dados selecionados e uma linha de limite:

      

   4. Para configurar o gatilho de alertas, clique em Próxima:

      1. No menu Acionador de alerta, selecione o número de série temporal que precisam satisfazer a operação de alerta antes que o política pode ser acionada. Você pode escolher entre os seguintes critérios:

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

      2. Opcional: expanda o menu Opções avançadas e, no Acionar quando a condição for atendida para este período de tempo, digite ou selecione um valor.

         Esse campo define por quanto tempo a condição precisa ser satisfeita antes que a política de alertas seja acionada. O A janela de novo teste não é igual. como a janela de alinhamento usada na consulta MQL. Para mais informações sobre o relacionamento entre esses valores, consulte O período de alinhamento e a duração.

      3. Insira um nome para sua condição, como "Condição básica de MQL".

5. Para configurar notificações, documentação e política de alertas nome, clique em Próxima.

   1. Selecione o canal de notificação que você criou anteriormente.

   2. Escolha um nível de gravidade.

   3. Insira algum texto a ser enviado com qualquer notificação de alerta no campo Documentação. Esse texto geralmente fornece aos responsáveis informações para ajudá-los a resolver o problema. Para este exercício, insira "Seu uso da CPU excedeu 20 segundos".

   4. Digite um nome para a política de alertas no campo Nome da política de alertas. Esse valor permite distinguir entre notificações de diferentes políticas de alertas.

6. Para salvar a política, clique em Criar política.