Coletar registros do Apache com o Agente de operações

Saiba como coletar e visualizar registros syslog coletados de um servidor da Web Apache instalado em uma instância de máquina virtual (VM) do Compute Engine usando o Agente de operações. É possível usar um processo semelhante ao deste guia de início rápido para monitorar outros aplicativos de terceiros.

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

  1. Crie uma instância de VM do Compute Engine e instale o Agente de operações.
  2. instalar um servidor da Web Apache;
  3. Configure o Agente de operações do servidor da Web Apache.
  4. Ver registros no Explorador de registros
  5. Criar um alerta baseado em registros
  6. Teste o alerta.
  7. 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

  1. As restrições de segurança definidas pela sua organização podem impedir que você conclua as etapas a seguir. Para informações sobre solução de problemas, consulte Desenvolver aplicativos em um ambiente restrito do Google Cloud.

  2. 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.
  3. 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

  4. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  5. Ative as APIs Compute Engine, Cloud Monitoring, and Cloud Logging.

    Ative as APIs

  6. 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

  7. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  8. Ative as APIs Compute Engine, Cloud Monitoring, and Cloud Logging.

    Ative as APIs

Crie uma instância de VM

  1. No painel de navegação do console do Google Cloud, selecione Compute Engine e, depois, Instâncias de VM:

    Acessar Instâncias de VM

  2. Crie uma VM clicando em Criar instância.

  3. No campo Nome, insira um nome descritivo.
  4. Em Tipo de máquina, selecione e2-small.
  5. Na seção Disco de inicialização, mantenha a configuração padrão de Debian GNU/Linux.
  6. Na seção Firewall, selecione Permitir tráfego HTTP e Permitir tráfego HTTPS.
  7. Na seção Observabilidade: agente de operações, selecione Instalar agente de operações para monitoramento e geração de registros.
  8. Clique em Criar.

Instalar um servidor da Web Apache

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

  1. Na página Instâncias de VM, localize a nova VM, acesse a coluna Conectar e clique em SSH.

    Problemas com a conexão? Consulte Solução de problemas de SSH.

  2. Para atualizar as listas de pacotes, copie o comando a seguir na área de transferência, cole-o no terminal SSH e pressione Enter:

    sudo apt-get update
    
  3. Depois que a mensagem "Lendo listas de pacotes... Pronto", no terminal SSH, execute o seguinte comando para instalar um servidor da Web Apache2:

    sudo apt-get install apache2 php7.0
    

    Quando for solicitado que você continue a instalação, insira Y. Se o comando de instalação falhar, use sudo apt-get install apache2 php.

  4. Quando o prompt de comando retornar, acesse a página Instâncias de VM e copie o endereço IP externo da VM no seguinte URL:

    http://EXTERNAL_IP
    
  5. Para se conectar ao servidor da Web Apache, abra uma nova guia do navegador e insira o URL da etapa anterior.

    Quando o servidor da Web for instalado, a guia do navegador exibirá a página padrão do Apache2 Debian.

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

Coletar registros e métricas do servidor da Web Apache

Nestas etapas, você configura o Agente de operações para coletar registros e métricas do servidor da Web Apache:
  1. Acesse o terminal SSH da sua instância de VM. Se você não tiver um terminal aberto, faça o seguinte:

    1. No painel de navegação do console do Google Cloud, selecione Compute Engine e, depois, Instâncias de VM:

      Acessar Instâncias de VM

    2. Localize a nova VM e clique em SSH.

  2. Copie o comando a seguir, cole-o no terminal da instância e pressione Enter:

    # 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, acesse Configurar o Agente de operações para o servidor da Web Apache.

  3. Aguarde até que o prompt de comando seja exibido, o que leva pelo menos 60 segundos.

Acessar os registros do servidor da Web Apache

Para acessar os registros no console do Google Cloud, use a Análise de registros:

  1. No painel de navegação do console do Google Cloud, selecione Logging e clique em Análise de registros:

    Acessar a Análise de registros

    Os registros mais recentes são exibidos no painel Resultados da consulta.

  2. Na barra de ferramentas, verifique se a opção Mostrar consulta está ativada.

  3. Para acessar os registros do servidor da Web Apache, crie e execute uma consulta:

    1. Expanda a lista de projetos do Google Cloud no seletor de projetos do Google Cloud e copie o ID do projeto do Google Cloud para a área de transferência.

    2. 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.

    3. Clique em Executar consulta.

      Os resultados da consulta são exibidos no painel Resultados da consulta.

Você configurou o Agente de operações para coletar registros e métricas do servidor da Web Apache e visualizou esses registros. A próxima etapa é criar uma política de alertas para receber uma notificação quando um padrão específico aparecer em um registro.

Criar um canal de notificação por e-mail

Antes de criar uma política de alertas, configure os canais de notificação que você quer que ela use. O Cloud Monitoring é compatível com muitos tipos diferentes de canais de notificação, como e-mail, Slack, PagerDuty e Pub/Sub. Para mais informações, consulte Criar e gerenciar canais de notificação. Para receber notificações por e-mail, faça o seguinte:
  1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Alertas:

    Acessar Alertas

  2. Na barra de ferramentas, clique em Editar canais de notificação.
  3. Na página Canais de notificação, role até E-mail e clique em Adicionar novo.
  4. Insira seu endereço de e-mail, um nome de exibição, como My email, e clique em Salvar.

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.

  1. No painel de navegação do console do Google Cloud, selecione Logging e clique em Análise de registros:

    Acessar a Análise de registros

  2. Na barra de ferramentas Resultados da consulta, clique em Criar alerta. O painel da política de alertas com base em registros é aberto.

  3. Em Detalhes do alerta, no campo Nome da política de alertas, insira 404 Not Found.

  4. Em Escolha os registros a serem incluídos neste alerta, faça o seguinte:

    1. Remova todo o conteúdo que estiver na caixa de texto do filtro de registro.
    2. Copie a consulta a seguir e cole na caixa de texto do filtro de registro:

      severity>=DEFAULT /help httpRequest.status=404
      

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

  5. Na seção Definir a frequência da notificação e a duração do fechamento automático, faça o seguinte:

    1. Defina o campo Tempo entre as notificações para 5 min.
    2. Defina o campo Duração do fechamento automático de incidentes como 30 min.
  6. Em Quem precisa ser notificado?, selecione seu e-mail no menu Canais de notificação e clique em Salvar.

Teste a política de alertas

Para testar a política de alertas, faça o seguinte:

  1. Acesse o terminal SSH da sua instância de VM. Se nenhum terminal estiver aberto, faça o seguinte:

    1. No painel de navegação do console do Google Cloud, selecione Compute Engine e, depois, Instâncias de VM:

      Acessar Instâncias de VM

    2. Localize a nova VM e clique em SSH.
  2. Para pesquisar a página falsa localhost/help no servidor, execute este comando:

    curl localhost/help
    

    Quando você vê uma mensagem 404 Not Found no terminal, uma notificação por e-mail é enviada. Esse processo leva alguns minutos para ser concluído.

    Você vai receber uma notificação por e-mail semelhante a esta:

    O exemplo de alerta com base em registro gera uma notificação por e-mail.

  3. Para visualizar as novas entradas de registro, faça o seguinte:

    1. No painel de navegação do console do Google Cloud, selecione Logging e clique em Análise de registros:

      Acessar a Análise de registros

    2. Na barra de ferramentas, clique em Ir para momento atual.

Você configurou o Agente de operações para coletar registros e métricas do servidor da Web Apache, mas somente visualizou registros. Saiba como ver as métricas do servidor da Web Apache em Coletar métricas do servidor da Web Apache com o Agente de operações: gerar tráfego.

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 e não precisa mais dele, exclua o projeto.

Se você usou um projeto atual, faça o seguinte:

  1. Se você criou uma VM, exclua-a:

    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.
  2. Exclua a política de alertas que você criou:

    1. No painel de navegação do console do Google Cloud, selecione Monitoramento e  Alertas:

      Acessar Alertas

    2. Selecione a política de alertas que você criou e clique em Excluir.

A seguir