Guia de início rápido para usar a linguagem de consulta do Monitoring

Neste guia de início rápido, mostramos como usar a linguagem de consulta do Monitoring (MQL) para explorar métricas, criar gráficos e configurar um alerta baseado em consulta. Neste guia de início rápido, você fará as ações a seguir:

  1. Crie uma instância do Compute Engine.

  2. Navegue até o editor de consultas.

  3. Execute uma consulta e crie um gráfico.

  4. Configure um alerta baseado em consulta.

Antes de começar

Para usar o MQL, você precisa criar um projeto do Google Cloud e ativar o faturamento.

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  5. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

Crie 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 Cloud, selecione Compute Engine.

    Interface do usuário para selecionar uma instância do compute.

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

Navegar até o Editor de consultas

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

  1. No menu do Console do Cloud, selecione Monitoring.

  2. No menu do Monitoring, selecione Metrics Explorer.

  3. Selecione a guia MQL.

    A interface muda para o editor de consultas do MQL:

    Interface do usuário do editor de consultas.

Use o editor de consultas para criar, testar e executar consultas MQL.

Executar uma consulta simples e criar um gráfico

Crie uma consulta simples que gere um gráfico da utilização da CPU da instância:

  1. Cole a consulta a seguir no "Editor de consultas".

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

    Interface do usuário para inserir uma consulta no editor de consultas.

    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:

    O gráfico mostra a utilização máxima e mínima da CPU.

  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.

    Interface do usuário para salvar um gráfico.

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 menu do Console do Cloud, selecione Monitoramento e selecione Alerta.

  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, role para baixo até E-mail e clique em Adicionar.

    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 no cabeçalho da página.

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

    Interface para criar uma política de alertas.

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

    1. Descrevendo o que você quer alertar.
    2. Especificando um canal de notificação para o alerta.
    3. Fornece informações sobre como resolver esse problema.
  4. Para descrever o que você quer alertar, clique em Adicionar condição. Esta ação exibe o editor de condensação com base em formulários.

    1. Acesse a visualização do Editor de consultas do editor de condições clicando em Editor de consultas . Esta versão do editor de condições inclui o Editor de consultas e um painel Configuração:

      O editor de condições para políticas de alertas baseadas em MQL.

    2. Insira um nome para sua condição, como "Condição de guia de início rápido do MQL".

    3. Para receber um alerta quando o tempo de uso de CPU da instância permanecer acima de dois segundos, insira a seguinte consulta:

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

      A operação condition estabelece o limite de desempenho que você quer alertar. No exemplo, a política de alertas rastreia o tempo de uso da CPU acima de 2 segundos.

    4. Clique em Executar consulta para ver os dados selecionados e uma linha de limite:

      Gráfico para uma consulta de condição de alerta.

    5. Para receber um alerta quando o uso de CPU da instância exceder o limite e permanecer lá por cinco minutos, use o painel Condição da seguinte forma:

      1. Altere o valor do campo For para 5 minutes.
      2. Não altere o valor do campo Acionadores de condição.
    6. Para salvar sua condição na política de alertas, clique em Adicionar.

    7. Continue clicando em Salvar. Essa ação retorna à página Criar política de alertas.

  5. Clique em Próxima para ir para a próxima etapa, configurando as notificações.

  6. Selecione o canal de notificação que você criou anteriormente e clique em OK.

  7. Clique em Próxima e passe para a próxima etapa, fornecendo etapas para corrigir o problema.

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

    2. 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, digite "Seu uso de CPU excedeu dois segundos".

  8. Salve sua política clicando em Salvar.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas:

  1. Acesse a página "Gerenciamento de identidade e acesso" no Console do Google Cloud:

    Acessar as configurações do projeto

  2. Clique em Encerrar e siga as instruções.

A seguir