Monitorar as métricas do controlador ingress-nginx no complemento de roteamento de aplicativos com Prometheus e Grafana

Cuidado

A Rede SIG do Kubernetes e o Comitê de Resposta à Segurança anunciaram a desativação do projeto Ingress NGINX, com manutenção que terminou em março de 2026. A Microsoft fornecerá suporte oficial para patches de segurança críticos para recursos de entrada NGINX de complemento de roteamento de aplicativos até Novembro de 2026.

O AKS se alinha ao Kubernetes upstream e usa a API de Gateway como o padrão de longo prazo para ingress e gerenciamento de tráfego L7. Migre antes que o suporte termine em novembro de 2026, com base em seus requisitos:

O controlador ingress-nginx no complemento de roteamento de aplicativos expõe muitas métricas para solicitações, o processo nginx e o controlador que podem ser úteis para analisar o desempenho e o uso do aplicativo.

O complemento de roteamento de aplicativos expõe as métricas Prometheus no ponto de extremidade em /metrics na porta 10254 e um Serviço privado nginx-metrics.

Pré-requisitos

Validando o ponto de extremidade de métricas

Para validar se as métricas estão sendo coletadas, você pode configurar um encaminhamento de porta de uma porta local para a porta 10254 no serviço nginx-metrics.

kubectl port-forward -n app-routing-system service/nginx-metrics :10254

Forwarding from 127.0.0.1:43307 -> 10254
Forwarding from [::1]:43307 -> 10254

Observe a porta local (43307 nesse caso) e abra http://localhost:43307/metrics no navegador. Você deve ver as métricas do controlador ingress-nginx carregando.

Captura de tela das métricas do Prometheus no navegador.

Agora você pode encerrar o processo port-forward para fechar o encaminhamento.

Configurando o serviço gerenciado do Azure Monitor para Prometheus

O Serviço gerenciado do Azure Monitor para Prometheus é um serviço totalmente gerenciado compatível com o Prometheus que dá suporte a recursos padrão do setor, como PromQL, painéis do Grafana e alertas do Prometheus. Esse serviço requer a configuração do complemento de métricas para o agente Azure Monitor, que envia dados para o Prometheus. Se o cluster não estiver configurado com o complemento, você poderá seguir este artigo para configurar seu cluster do AKS (Serviço de Kubernetes do Azure) para enviar dados ao serviço gerenciado do Azure Monitor para Prometheus.

Habilitar a coleta de dados baseada nos Monitores de Serviço

Depois que seu cluster for atualizado com o agente do Azure Monitor, você precisará configurar o agente para habilitar a coleta de dados do ponto de extremidade de métricas. Você pode criar um Pod ou um Monitor de Serviço para fazer isso.

O seguinte cria um Monitor de Serviço que coleta métricas do controlador ingress-nginx implantado pelo complemento de roteamento de aplicativos.

kubectl apply -f - <<EOF
apiVersion: azmonitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: nginx-monitor
  namespace: app-routing-system
spec:
  labelLimit: 63
  labelNameLengthLimit: 511
  labelValueLengthLimit: 1023
  selector:
    matchLabels:
      app.kubernetes.io/component: ingress-controller
      app.kubernetes.io/managed-by: aks-app-routing-operator
      app.kubernetes.io/name: nginx
  endpoints:
  - port: prometheus
EOF

Em alguns minutos, os pods ama-metrics no namespace kube-system devem reiniciar e adotar a nova configuração.

Examinar a visualização de métricas no Espaço Gerenciado do Azure para Grafana

Agora que você tem o serviço gerenciado do Azure Monitor para Prometheus e o Espaço Gerenciado do Azure para Grafana configurados, você deve acessar sua instância do Espaço Gerenciado do Azure para Grafana.

Há dois painéis oficiais do ingress-nginx que você pode baixar e importar para sua instância do Grafana:

  • Painel do controlador ingress-nginx
  • Painel de desempenho de tratamento de solicitação

Painel do controlador ingress-nginx

Este painel oferece visibilidade do volume de solicitações, conexões, taxas de sucesso, recargas de configuração e configurações fora de sincronia. Você também pode usá-lo para visualizar a pressão de E/S da rede, a memória e o uso da CPU do controlador de entrada. Por fim, ele também mostra os tempos de resposta de percentil P50, P95 e P99 de suas entradas e suas taxas de transferência.

Você pode baixar esse painel do GitHub.

Captura de tela de um navegador mostrando o painel ingress-nginx no Grafana.

Painel de desempenho de tratamento de solicitação

Esse painel fornece visibilidade sobre o desempenho de tratamento de solicitação dos diferentes destinos de entrada upstream, que são os pontos de extremidade dos aplicativos para os quais o controlador de entrada está encaminhando o tráfego. Mostra os percentis P50, P95 e P99 do total de solicitações e tempos de resposta upstream. Você também pode exibir agregações de erros de solicitação e latência. Use esse painel para examinar e melhorar o desempenho e a escalabilidade de seus aplicativos.

Você pode baixar esse painel do GitHub.

Captura de tela de um navegador mostrando o painel de desempenho de tratamento de solicitação ingress-nginx no Grafana.

Importando um painel

Para importar um painel do Grafana, expanda o menu à esquerda e clique em Importar em Painéis.

Captura de tela de um navegador mostrando a instância do Grafana com Importar painel realçado.

Em seguida, carregue o arquivo de painel desejado e clique em Carregar.

Captura de tela de um navegador mostrando a caixa de diálogo Importar painel da instância do Grafana.

Próximas etapas

  • Última atualização em