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:
- Crie uma instância de VM do Compute Engine e instale o Agente de operações.
- instalar um servidor da Web Apache;
- Configure o Agente de operações do servidor da Web Apache.
- Ver registros no Explorador de registros
- Criar um alerta baseado em registros
- Teste o alerta.
- Fazer a limpeza.
Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud, clique em Orientação:
Antes de começar
-
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.
- 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.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative as APIs Compute Engine, Cloud Monitoring, and Cloud Logging.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative as APIs Compute Engine, Cloud Monitoring, and Cloud Logging.
Crie uma instância de VM
-
No painel de navegação do console do Google Cloud, selecione Compute Engine e, depois, Instâncias de VM:
Crie uma VM clicando em Criar instância.
- No campo
Nome , insira um nome descritivo. - Em
Tipo de máquina , selecione e2-small. - Na seção
Disco de inicialização , mantenha a configuração padrão de Debian GNU/Linux. - Na seção
Firewall , selecione Permitir tráfego HTTP e Permitir tráfego HTTPS. - Na seção Observabilidade: agente de operações, selecione Instalar agente de operações para monitoramento e geração de registros.
- 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:
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.
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
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, usesudo apt-get install apache2 php
.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
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.
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:Acesse o terminal SSH da sua instância de VM. Se você não tiver um terminal aberto, faça o seguinte:
-
No painel de navegação do console do Google Cloud, selecione Compute Engine e, depois, Instâncias de VM:
- Localize a nova VM e clique em SSH.
-
Copie o comando a seguir, cole-o no terminal da instância e pressione Enter:
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.
- 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:
-
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.
Na barra de ferramentas, verifique se a opção Mostrar consulta está ativada.
Para acessar os registros do servidor da Web Apache, crie e execute uma consulta:
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.
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
eapache_error
são mostradas.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:-
No painel de navegação do console do Google Cloud, selecione Monitoramento e notifications Alertas:
- Na barra de ferramentas, clique em Editar canais de notificação.
- Na página Canais de notificação, role até
E-mail e clique em Adicionar novo. - 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.
-
No painel de navegação do console do Google Cloud, selecione Logging e clique em Análise de registros:
Na barra de ferramentas Resultados da consulta, clique em add_alert Criar alerta. O painel da política de alertas com base em registros é aberto.
Em Detalhes do alerta, no campo Nome da política de alertas, insira
404 Not Found
.Em Escolha os registros a serem incluídos neste alerta, faça o seguinte:
- Remova todo o conteúdo que estiver na caixa de texto do filtro de registro.
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 menosDEFAULT
, que contenham o texto/help
e que contenham um statushttpRequest
de404
.
Na seção Definir a frequência da notificação e a duração do fechamento automático, faça o seguinte:
- Defina o campo Tempo entre as notificações para 5 min.
- Defina o campo Duração do fechamento automático de incidentes como 30 min.
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:
Acesse o terminal SSH da sua instância de VM. Se nenhum terminal estiver aberto, faça o seguinte:
-
No painel de navegação do console do Google Cloud, selecione Compute Engine e, depois, Instâncias de VM:
- Localize a nova VM e clique em SSH.
-
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:
Para visualizar as novas entradas de registro, faça o seguinte:
-
No painel de navegação do console do Google Cloud, selecione Logging e clique em Análise de registros:
- 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:
Se você criou uma VM, exclua-a:
- No Console do Google Cloud, acesse a página Instâncias de VMs.
- Marque a caixa de seleção de a instância que você quer excluir.
- Para excluir a instância, clique em Mais ações, clique em Excluir e siga as instruções.
Exclua a política de alertas que você criou:
-
No painel de navegação do console do Google Cloud, selecione Monitoramento e notifications Alertas:
- Selecione a política de alertas que você criou e clique em
Excluir .
-
A seguir
Para saber mais sobre o Agente de operações e as integrações compatíveis, consulte:
Para mais informações sobre como visualizar registros no Explorador de registros, consulte Visualizar registros usando o Explorador de registros.
Para informações sobre como fazer consultas no Explorador de registros, confira Criar consultas na Análise de registros.
Para informações sobre como coletar e ver métricas do servidor da Web Apache, consulte o guia de início rápido Coletar métricas do servidor da Web Apache com o Agente de operações.
Para mais informações sobre o Monitoring e a relação dele com o Cloud Logging, consulte Monitoramento.