Guia de início rápido sobre como monitorar uma instância do Compute Engine

Esta página mostra como monitorar uma instância de máquina virtual (VM, na sigla em inglês) do Compute Engine com o Cloud Monitoring. Se você quiser monitorar uma instância de VM do Amazon EC2, consulte o Guia de início rápido do Amazon EC2.

Neste guia de início rápido, você fará as ações a seguir:

  1. Criar uma instância de VM do Compute Engine.
  2. Instale o servidor HTTP Apache.
  3. Instale os agentes do Cloud Monitoring e do Logging.
  4. Crie uma verificação de tempo de atividade com uma política de alertas.
  5. Criar um painel e um gráfico personalizados.
  6. Ver seus registros.
  7. Fazer a limpeza.

Antes de começar

Para usar o Cloud Monitoring, você precisa criar um projeto do Google Cloud, ativar o faturamento para o projeto e associar o projeto a um espaço de trabalho.

Para criar um projeto e ativar o faturamento, faça o seguinte:

  1. No Console do Cloud, acesse Novo projeto:

    Crie um novo projeto

  2. No campo Nome do projeto, insira Quickstart e clique em Criar.

  3. Acesse o Faturamento:

    Acessar "Faturamento"

  4. Escolha o projeto Quickstart se ele ainda não estiver selecionado na parte superior da página.

  5. Você precisará escolher um perfil para pagamentos atual ou criar um novo.

Criar uma instância do Compute Engine

  1. No Console do Cloud, acesse Compute e selecione Compute Engine:

    Acessar o Compute Engine

  2. Para criar uma instância de VM, clique em Criar.

  3. Preencha os campos da instância da seguinte forma:

    • No campo Nome, insira lamp-1-vm.
    • Em Tipo de máquina, selecione Pequeno.
    • Verifique se o disco de inicialização está configurado para o Debian GNU/Linux.
    • Em Firewall, selecione Permitir tráfego HTTP e Permitir tráfego HTTPS.

    Não altere os valores padrão dos outros campos.

  4. Clique em Criar. Aguarde alguns minutos para que a instância seja iniciada na página "Instâncias de VM".

  5. Para abrir um terminal na instância, na coluna Conectar, clique em SSH.

  6. Atualize as listas de pacotes na instância.

    sudo apt-get update
    
  7. Configure o servidor HTTP Apache2.

    sudo apt-get install apache2 php7.0
    
  8. Abra o navegador e conecte-se ao servidor HTTP Apache2 usando o URL http://[External IP]. Substitua [External IP] pelo endereço IP externo da instância do Compute Engine. Você verá a página padrão do Apache2:

    Exibição da página padrão do Apache2.

Instalar agentes

As instruções nesta seção são específicas para o Debian. Consulte Como instalar o agente do Cloud Monitoring e Como instalar o agente do Cloud Logging para instruções de instalação para outros sistemas operacionais, links para guias de solução de problemas e etapas para verificar a instalação do agente.

Os agentes do Cloud Monitoramento e do Logging transmitem os registros e as métricas da instância da VM para o Monitoring e o Logging:

  1. Mude para o terminal conectado à instância de VM ou crie um novo.

  2. Instalar e iniciar o agente do Cloud Monitoring:

    • Adicionar o repositório de pacotes e atualizar a lista de pacotes:

      curl -sSO https://dl.google.com/cloudagents/add-monitoring-agent-repo.sh
      sudo bash add-monitoring-agent-repo.sh
      sudo apt-get update
      
    • Instale o agente:

      sudo apt-get install stackdriver-agent
      
    • Iniciar o agente:

      sudo service stackdriver-agent start
      
  3. Instalar, configurar e iniciar o agente do Cloud Logging:

    • Adicionar o repositório de pacotes e atualizar a lista de pacotes:

      curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
      sudo bash add-logging-agent-repo.sh
      sudo apt-get update
      
    • Instale o agente:

      sudo apt-get install google-fluentd
      
    • Instalar a configuração padrão do agente para ingerir dados estruturados no Cloud Logging:

      sudo apt-get install google-fluentd-catch-all-config-structured
      

      O agente do Cloud Logging precisa ser configurado para ingerir dados estruturados ou não estruturados. Essas são opções exclusivas. Se você configurar o agente para dados não estruturados, todas as entradas de registro conterão um campo textPayload. No entanto, se você configurar o agente para dados estruturados, como é feito neste guia de início rápido, determinados tipos de dados de registro conterão um campo jsonPayload. Para mais informações, consulte Operações de geração de registros estruturadas.

    • Iniciar o agente

      sudo service google-fluentd start
      

Crie uma verificação de tempo de atividade e uma política de alertas

Para criar uma verificação de tempo de atividade, faça o seguinte:

  1. No Console do Cloud, selecione Monitoramento:

    Acessar Monitoring

    Na primeira vez que você acessar o Monitoring para um projeto do Google Cloud, ele criará um espaço de trabalho e o associará ao projeto. Esse processo é automático, a menos que você tenha um espaço de trabalho com vários projetos. Nesse caso, é exibida uma caixa de diálogo solicitando que você selecione entre a criação de um espaço de trabalho e a adição do projeto a um espaço de trabalho atual. Selecione a opção para criar um espaço de trabalho.

  2. Clique em Uptime checks.

  3. Clique em Criar verificação de tempo de atividade.

    Crie uma caixa de diálogo da verificação de tempo de atividade.

  4. Para o título, digite My Uptime Check e clique em Avançar.

  5. Destino:

    1. Selecione HTTP como o protocolo.
    2. Selecione Instância como o Tipo de recurso.
    3. No campo Aplicável a, selecione Simples e, como nome da instância, selecione lamp-1-vm.
    4. Deixe todos os outros campos com os valores padrão e clique em Avançar.
  6. Validação de resposta: deixe esses campos com os valores padrão e clique em Avançar.

  7. Alerta e notificação:

    • Verifique se o rótulo do seletor é O alerta está ativado.
    • Deixe os campos de nome e duração nos valores padrão.
    • Para adicionar um canal de notificação à política de alertas, na caixa de texto Canais de notificação, clique em Menu. Selecione os canais a serem adicionados e clique em OK. As notificações são agrupadas em ordem alfabética para cada tipo de canal.

      Para adicionar uma entrada à lista de caixas de seleção, clique em Gerenciar canal de notificação e siga as instruções. Ao retornar a essa caixa de diálogo, clique em Atualizar .

  8. Para verificar a configuração da verificação de tempo de atividade, clique em Test. Se a mensagem "Connection error - refused" for exibida, talvez você não tenha instalado o servidor HTTP Apache ou tenha especificado o tipo de verificação HTTPS em vez de HTTP. Para outros erros, consulte Conferir a verificação de tempo de atividade.

  9. Clique em Criar. Quando a ação de criação for bem-sucedida, a mensagem Verificação e alerta criados e a página do painel Verificações de tempo de atividade serão exibidas.

    A nova verificação de tempo de atividade será listada no painel de verificações de tempo de atividade. Se você clicar no nome da verificação, a visualização de detalhes dessa verificação de tempo de atividade será aberta. Essa visualização exibe vários gráficos, mostra a porcentagem de tempo de atividade e informações de configuração, assim como lista as políticas de alerta configuradas. Para ver uma política específica, clique no nome dela.

    Também é possível visualizar a política de alertas na página Alertas. Na página de alertas, o painel Políticas lista um subconjunto de políticas. Para ver uma lista de todas as políticas, clique em Ver todas as políticas.

Crie um painel e um gráfico

Para exibir as métricas coletadas pelo Monitoring, crie um gráfico e um painel:

Há dois editores de painel: Clássico e Visualização. O editor de Visualização está sendo implantado gradualmente. O editor de Visualização aceita um conjunto mais amplo de widgets do painel do que o editor Clássico.

Visualizar

Para criar um painel usando o editor de visualização, siga estas etapas:

  1. Acessar o Monitoring

    Acessar Monitoring

  2. Na página Visão geral dos painéis, clique em Criar painel.

  3. Verifique se a opção Visualização está sendo exibida na barra de ferramentas do painel.

  4. Opcional: substitua Untitled Dashboard por um nome descritivo no seu painel.

  5. Para adicionar um gráfico de Gráfico de linhas ao painel, arraste a entrada da Biblioteca de widgets para a área do gráfico.

  6. Na seção Quais dados você quer visualizar?, faça o seguinte:

    • Selecione GCE VM Instance no tipo de recurso.
    • Insira CPU e selecione Utilização da CPU para a métrica.

    No exemplo a seguir, ilustramos um gráfico de linhas:

    Exemplo de um gráfico de linha recém-criado

    Use o ponteiro para redimensionar ou reposicionar o gráfico.

  7. Para adicionar um segundo gráfico de Gráfico de linhas ao painel, clique na barra de ferramentas do painel para ativar a Biblioteca de widgets, selecione um tipo de gráfico e arraste-o da Biblioteca de widgets até a área do gráfico. Por exemplo, é possível fazer as seguintes seleções:

    • Selecione GCE VM Instance no tipo de recurso.
    • Selecione Received bytes na métrica.

  8. Clique em Salvar painel.

Sites

Para criar um painel usando o editor clássico, siga estes passos:

  1. Acessar o Monitoring

    Acessar o Monitoring

  2. Selecione Painéis e selecione Criar painel.

  3. Verifique se a versão Clássica é exibida na barra de ferramentas do painel.

  4. Opcional: insira um nome para o painel e clique em Confirmar.

  5. Clique em Add Chart.

  6. Certifique-se de que a guia Metric esteja selecionada.

    Exibição da caixa de diálogo

  7. No cabeçalho Find resource type and metric, clique em instance, cpu, usage, etc.:

    • Selecione GCE VM Instance no tipo de recurso.
    • Insira CPU e selecione Utilização da CPU para a métrica.

  8. Clique em Save.

    Exibição do gráfico configurado.

  9. Para criar um segundo gráfico, clique em Adicionar gráfico, verifique se a guia Métricas está selecionada e insira um recurso em uma métrica. Por exemplo, é possível fazer as seguintes seleções:

    • Selecione GCE VM Instance no tipo de recurso.
    • Selecione Received bytes na métrica.

  10. Clique em Save.

Testar a verificação e o alerta

Este procedimento pode demorar até quarenta minutos. Foi incluída uma amostra de cronograma para sua referência. Nela, a hora atual é 12h.

12h: espera.

Acesse o Monitoring. No bloco Uptime checks, aguarde até que o ícone de My Uptime Check mude para um círculo verde com uma marca de seleção. O tempo máximo de espera nesse estágio é de cinco minutos:

Exibição do passe de verificação de tempo de atividade.

12h15: o ícone Minha verificações de tempo de atividade está verde. Teste a verificação e o alerta.

Acesse a página Instâncias de VM, selecione a instância e clique em Parar.

12h25 Notificação de alerta recebida.

Corrija o "problema" reiniciando a VM. Volte à página Instâncias de VM, selecione a instância e clique em Iniciar.

12h40 Incidente resolvido.

Recebida a segunda notificação de alerta.

Ver os registros

O Monitoring e o Logging são totalmente integrados.

Para visualizar os registros dos recursos exibidos em um gráfico, faça o seguinte:

  1. Acesse o painel que exibe o gráfico relevante.

  2. No gráfico, clique em Mais e, em seguida, clique em Visualizar registros:

    Exibição da seleção de

Se preferir, acesse o Logging e especifique os parâmetros de filtro:

  1. No Console do Cloud, acesse o Logging:

    Acessar o Logging

  2. Altere as configurações do Logs Viewer para ver os registros que você quer:

    • Clique no Menu e selecione Limpar filtros e retornar ao modo básico.
    • Na primeira lista suspensa, selecione G​C​E VM Instance, lamp-1-vm.
    • Na segunda lista suspensa, selecione syslog e clique em OK.
    • Não altere os valores padrão dos outros campos. Os registros da instância de VM são exibidos.

      Exibição da visualização dos registros do console.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

Excluir o projeto

Se você criou um novo projeto neste guia de início rápido, é necessário excluí-lo. Caso contrário, pule esta seção.

  1. No Console do Cloud, acesse a página Gerenciar recursos:

    Acessar a página "Gerenciar recursos"

  2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
  3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

Excluir recursos do guia de início rápido

Se você usou um projeto atual neste guia de início rápido, exclua a política de alertas, verificações de tempo de atividade, painel e instância de VM:

  1. Acesse o Monitoring:

    Acessar o Monitoring

  2. Exclua a política de alertas:

    1. Selecione Alertas.
    2. Selecione Minha política de verificação de tempo de atividade e clique em Excluir .
  3. Exclua a verificação de tempo de atividade:

    1. Selecione Verificações de tempo de atividade.
    2. Selecione Minha verificação de tempo de atividade e clique em Excluir .
  4. Exclua o painel:

    1. Selecione Painéis.
    2. Para o painel chamado Painel do guia de início rápido, clique em Excluir . Confirme a operação de exclusão.
  5. Exclua a instância de VM criada:

    1. No Console do Cloud, acesse a página Instâncias de VM.

      Acessar a página "Instâncias de VM"

    2. Marque a caixa de seleção para instância que você quer excluir.
    3. Clique em Excluir para remover a instância.

A seguir