Neste documento, descrevemos como configurar a implantação do Google Kubernetes Engine para usar o Google Cloud Managed Service para Prometheus a fim de coletar métricas do Apache Web Server (httpd). Esta página mostra como fazer o seguinte:
- Configure o exportador do Apache Web Server para gerar relatórios de métricas.
- Configurar um recurso PodMonitoring para o serviço gerenciado para Prometheus a fim de coletar as métricas exportadas.
- Instalar um painel no Cloud Monitoring para ver as métricas.
Estas instruções se aplicam somente ao usar a coleção gerenciada com o serviço gerenciado para Prometheus. Se você estiver usando a coleção autoimplantada, consulte o repositório de origem do exportador do Apache HTTP para ver informações da instalação.
Estas instruções são um exemplo e devem funcionar na maioria dos ambientes do Kubernetes. Se você estiver com problemas para instalar um aplicativo ou exportador devido a políticas restritivas de segurança ou da organização, recomendamos consultar a documentação de código aberto para receber suporte.
Para informações sobre o Apache Web Server, consulte Apache HTTP.
Pré-requisitos
Para coletar métricas do Apache Web Server usando o Managed Service para Prometheus e a coleção gerenciada, sua implantação precisa atender aos seguintes requisitos:
- Seu cluster precisa executar a versão 1.21.4-gke.300 ou posterior do Google Kubernetes Engine.
- É necessário executar o Managed Service para Prometheus com a coleta gerenciada ativada. Para mais informações, consulte Começar a usar a coleta gerenciada.
- Para usar os painéis disponíveis no Cloud Monitoring com relação à
integração do servidor da Web Apache, use a versão v1.0.0
ou posterior do
httpd_exporter
.Para mais informações sobre os painéis disponíveis, consulte Visualizar painéis.
Instalar o exportador do servidor da Web do Apache
Recomendamos que você instale o exportador do Apache Web Server, httpd_exporter
, como um arquivo secundário para sua carga de trabalho do servidor da Web do Apache.
Para informações sobre o uso de arquivos secundários, consulte
Aplicativos estendidos no Kubernetes com pods de múltiplos
contêineres.
Para instalar httpd_exporter
como um arquivo secundário para o Apache Web Server, modifique a configuração do servidor da Web do Apache, conforme mostrado no exemplo a seguir:
Adicione à sua configuração todas as linhas precedidas pelo
símbolo +
.
/server-status
. Para isso, modifique a configuração com uma nova diretiva Location
e carregue o status_module.
Para aplicar as alterações de configuração de um arquivo local, execute o seguinte comando:
kubectl apply -n NAMESPACE_NAME -f FILE_NAME
Também é possível usar o Terraform para gerenciar as configurações.
Definir um recurso do PodMonitoring
Para a descoberta de destino, o Operador de serviço gerenciado para Prometheus requer um recurso PodMonitoring que corresponde ao exportador do Apache Web Server no mesmo namespace.
É possível usar a seguinte configuração do PodMonitoring:
Verifique se os seletores de rótulo e a porta correspondem aos seletores e à porta usados em Instalar o exportador do Apache Web Server.
Para aplicar as alterações de configuração de um arquivo local, execute o seguinte comando:
kubectl apply -n NAMESPACE_NAME -f FILE_NAME
Também é possível usar o Terraform para gerenciar as configurações.
Verificar a configuração
Você pode usar o Metrics Explorer para verificar se configurou corretamente o exportador do Apache Web Server. Pode levar um ou dois minutos para que o Cloud Monitoring ingira as métricas.
Para verificar se as métricas foram transferidas, faça o seguinte:
-
No Console do Google Cloud, acesse a página do leaderboard Metrics Explorer:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
- Verifique se PromQL está selecionado na opção de ativar/desativar PromQL. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
- Digite e execute a seguinte consulta:
up{job="httpd", cluster="CLUSTER_NAME", namespace="NAMESPACE_NAME"}
Ver painéis
A integração do Cloud Monitoring inclui o painel Visão geral do Apache Prometheus. Os painéis são instalados automaticamente ao configurar a integração. Também é possível visualizar visualizações estáticas de painéis sem instalar a integração.
Para ver um painel instalado, faça o seguinte:
-
No console do Google Cloud, acesse a página Painéis:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Selecione a guia Lista de painéis.
- Escolha a categoria Integrações.
- Clique no nome do painel, por exemplo, Visão geral do Apache Prometheus.
Para acessar uma visualização estática do painel, faça o seguinte:
-
No console do Google Cloud, acesse a página Integrações:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Clique no filtro de plataforma de implantação do Kubernetes Engine.
- Localize a integração com o Apache Web Server (httpd) e clique em Ver detalhes.
- Selecione a guia Painéis.
Solução de problemas
Para resolver problemas de transferências de métricas, consulte Problemas com a coleta de exportadores em Resolver problemas no processamento.