Guia de início rápido: VMs do Cloud Logging para Compute Engine

Guia de início rápido: VMs do Cloud Logging para Compute Engine

Guia de início rápido: VMs do Cloud Logging para Compute Engine

Neste documento, mostramos como visualizar os registros syslog coletados de um servidor da Web Apache instalado em uma instância de máquina virtual (VM) do Compute Engine. É possível usar um processo semelhante ao deste guia de início rápido para monitorar aplicativos de terceiros.

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. Instalar um servidor da Web Apache
3. Instalar e configurar o Agente de operações para o servidor da Web Apache
4. Ver registros no Explorador de registros
5. Criar um alerta baseado em registros
6. Fazer a limpeza.

---

Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud, clique em Orientação:

Orientações

---

Antes de começar

Algumas das etapas deste documento podem não funcionar corretamente se sua organização aplicar restrições ao ambiente do Google Cloud. Nesse caso, talvez não seja possível concluir tarefas como criar endereços IP públicos ou chaves de contas de serviço. Se você fizer uma solicitação que retorne um erro sobre restrições, veja como Desenvolver aplicativos em um ambiente restrito do Google Cloud.

Você precisa ter um projeto do Google Cloud com faturamento ativado para concluir este guia de início rápido. Se você não tiver um projeto do Google Cloud ou se o faturamento não estiver ativado para o projeto do Google Cloud, faça o seguinte:

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.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como verificar se o faturamento está ativado em um projeto.

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

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

5. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como verificar se o faturamento está ativado em um projeto.

6. Se você tiver um canal de notificação por e-mail configurado, pule esta etapa.

   Para configurar um canal de notificação por e-mail, faça o seguinte:

   1. No Console do Google Cloud, selecione o Cloud Monitoring ou clique no botão a seguir:

      Acessar Monitoring
   2. Selecione Alerting.
   3. Clique em Editar canais de notificação.
   4. Na seção E-mail, clique em Adicionar novo e preencha a caixa de diálogo.

Criar uma instância de VM do Compute Engine

Recomendamos que você crie uma nova instância de VM do Compute Engine para este guia de início rápido porque instala e configura o software.

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

   Acessar o Compute Engine

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

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

   • No campo Nome, use quickstart-vm.
   • No campo Tipo de máquina, selecione Small.
   • 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. Quando a VM estiver pronta, ela aparecerá na lista de instâncias na guia Instâncias.

Instalar um servidor da Web Apache

Para implantar um servidor da Web Apache na instância de VM do Compute Engine, faça o seguinte:

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

2. Para atualizar as listas de pacotes na instância, execute o seguinte comando:

   sudo apt-get update
   

3. Para instalar um servidor HTTP Apache2, execute o seguinte comando:

   sudo apt-get install apache2 php7.0
   

   Observação: se o comando anterior falhar, use sudo apt-get install apache2 php. Se você for solicitado a continuar a instalação, insira Y.

4. Abra o navegador e conecte-se ao servidor HTTP Apache2 usando o URL http://EXTERNAL_IP, em que EXTERNAL_IP é o endereço IP externo da VM. Esse endereço está na coluna IP externo da instância de VM.

   Você verá a página padrão do Apache2:

   

Instalar e configurar o Agente de operações

Para coletar registros e métricas do seu servidor da Web Apache, instale o agente de operações usando o terminal:

1. Para abrir um terminal na instância de VM, na coluna Conectar, clique em SSH.

2. Para instalar o agente de operações, execute o seguinte comando:

      curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh
      sudo bash add-google-cloud-ops-agent-repo.sh --also-install
   

   Você verá o seguinte: google-cloud-ops-agent installation succeeded.

3. Copie o comando a seguir e cole-o no terminal:

   # Configures Ops Agent to collect telemetry from the app and restart Ops Agent.
   
   set -e
   
   # Create a back up of the existing file so existing configurations are not lost.
   sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak
   
   # Configure the Ops Agent.
   sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
   metrics:
     receivers:
       apache:
         type: apache
     service:
       pipelines:
         apache:
           receivers:
             - apache
   logging:
     receivers:
       apache_access:
         type: apache_access
       apache_error:
         type: apache_error
     service:
       pipelines:
         apache:
           receivers:
             - apache_access
             - apache_error
   EOF
   
   sudo service google-cloud-ops-agent restart
   sleep 60
   

   O comando anterior cria a configuração para coletar e ingerir registros e métricas do servidor da Web Apache. Para mais informações sobre como ingerir registros do servidor da Web do Apache, consulte Configurar o agente de operações do servidor da Web do Apache.

Veja os registros

Use o Explorador de registros para ver os registros no Console do Google Cloud. Para selecionar determinadas entradas de registro, execute uma consulta.

Para ver os registros no console do Google Cloud, faça o seguinte:

1. No console do Google Cloud, selecione "Logging" no menu de navegação e clique em "Explorador de registros":

   Acesse o Explorador de registros

2. No painel Consulta, ative Mostrar consulta. O editor de consultas é aberto.

3. Para localizar seu ID do projeto do Google Cloud, expanda a lista de projetos do Google Cloud no seletor de projetos do Google Cloud. Na coluna ID, copie o ID do projeto do Google Cloud para a área de transferência.

4. Na expressão a seguir, cole o ID copiado no campo PROJECT_ID e copie a expressão no editor de consultas:

   resource.type="gce_instance"
   logName=("projects/PROJECT_ID/logs/apache_access" OR
   "projects/PROJECT_ID/logs/apache_error")
   

   Quando a consulta anterior é executada, apenas as entradas de registro apache_access e apache_error são mostradas.

5. Clique em Executar consulta ou pressione a tecla Enter. Os resultados da consulta são exibidos no painel Resultados da consulta.

criar um alerta baseado em registros;

Para receber notificações quando uma mensagem específica aparecer nas entradas de registro, crie um alerta com base em registros. Nesta seção, você cria um alerta baseado em registro para ser notificado quando uma mensagem 404 Not Found aparecer nas entradas de registro.

Para criar um alerta baseado em registro, faça o seguinte:

1. Para criar um alerta baseado em registro, você precisa configurar um canal de notificação. Para este guia de início rápido, crie um canal de notificação por e-mail. Consulte Configurar notificações por e-mail na seção Antes de começar deste guia de início rápido.

2. Acesse o Explorador de registros no Console do Google Cloud:

   Acesse o Explorador de registros

3. Na barra de ferramentas Resultados da consulta, clique em Criar alerta. O painel da política de alertas com base em registros é aberto. Preencha os campos da seguinte forma:

   1. Em Detalhes do alerta, digite 404 Not Found no campo Nome da política de alerta.

   2. Em Escolha os registros a serem incluídos neste alerta, copie a consulta a seguir e cole-a na caixa de texto do filtro de registros:

       severity>=DEFAULT /help httpRequest.status=404
      

      O filtro de registro anterior pesquisa entradas de registro com severity de pelo menos DEFAULT, que contenham o texto /help, e que tenham um status httpRequest 404.

   3. Em Definir frequência de notificação e duração do fechamento automático, selecione os seguintes valores:

      1. Tempo entre as notificações: 5 minutos

      2. Duração do fechamento automático de incidentes: 30 minutos

   4. Em Quem deve ser notificado?, selecione um e-mail de Canais de notificação e clique em Salvar para configurar a política de alertas.

Para testar o alerta com base em registros que você acabou de criar, faça o seguinte:

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

   Acessar o Compute Engine

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

3. Para pesquisar no servidor a página falsa localhost/help, execute o seguinte comando:

   curl localhost/help
   

   Depois que você vir uma mensagem 404 Not Found no terminal, uma notificação por e-mail será enviada. O processo pode levar alguns minutos para ser concluído.

   A notificação por e-mail que você recebe é semelhante a esta:

   

Limpar

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

• Se você criou um novo projeto do Google Cloud para este guia de início rápido, exclua o projeto do Google Cloud:

  Cuidado: excluir um projeto tem os seguintes efeitos:
  • Tudo no projeto é excluído. Se você tiver usado um projeto atual para seguir este tutorial, a exclusão dele incluirá quaisquer outras ações feitas no projeto.
  • Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.
  1. No Console do Google Cloud, acesse a página Gerenciar recursos.

     Acessar "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.

• Se você criou uma nova VM em um projeto, exclua a instância de VM:

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

     Acessar instâncias de VM

  2. Marque a caixa de seleção de a instância que você quer excluir.
  3. Para excluir a instância, clique em Mais ações, clique em Excluir e siga as instruções.

• Se você usou uma instância de VM atual neste guia de início rápido, desinstale o agente de operações:

  1. Para desinstalar o agente de operações, abra o terminal e execute o seguinte comando:

     sudo bash add-google-cloud-ops-agent-repo.sh --uninstall
     

A seguir

• Para informações sobre como visualizar registros no Explorador de registros, consulte Como usar o Explorador de registros.

• Para informações sobre como fazer consultas no Explorador de registros, consulte Criar consultas no Explorador de registros.

• Para ver informações sobre como monitorar uma instância de VM do Compute Engine, consulte o guia de início rápido Monitorar uma máquina virtual do Compute Engine .

• Para mais informações sobre o Monitoring e a relação dele com o Cloud Logging, consulte Monitoring.