NGINX lento? Como monitorar conexões com o stub_status
Seu NGINX está respondendo lentamente? Descubra como usar o módulo stub_status para identificar gargalos em conexões simultâneas e otimizar seu servidor.
Resumo
- O módulo stub_status oferece métricas em tempo real sobre o tráfego do servidor web.
- Conexões em estado reading ou writing elevadas indicam gargalos de I/O ou processamento do backend.
- A ativação do módulo exige apenas uma diretiva simples no arquivo de configuração do NGINX.
- A monitoração constante evita que limites de conexões simultâneas causem downtime inesperado.
- O acompanhamento via stub_status é complementar a outras ferramentas de diagnóstico de rede no Linux.
Por que o seu NGINX está demorando para responder?
Quando um servidor web começa a apresentar alta latência, a primeira reação costuma ser reiniciar o serviço. No entanto, sem entender se o problema reside em conexões travadas, esgotamento de recursos ou gargalos no backend, você está apenas aplicando um curativo. O NGINX, conhecido pela sua alta performance, possui uma ferramenta nativa chamada stub_status, que funciona como um painel de controle básico para entender o que está acontecendo embaixo do capô.
Entendendo o módulo stub_status na prática
O stub_status é um módulo que exibe o estado atual das conexões de forma minimalista. Ele mostra, por exemplo, quantas conexões estão aguardando leitura, quantas estão sendo processadas e quantas estão ociosas (keep-alive). Na prática, isso significa que você consegue ver instantaneamente se o seu servidor está sendo sobrecarregado por tráfego inesperado ou se existe uma aplicação lenta travando os workers.
Para verificar se o seu binário do NGINX possui este módulo, basta rodar o comando nginx -V 2>&1 | grep -o with-http_stub_status_module. Se o comando retornar a string, você está pronto para configurar. Caso contrário, será necessário recompilar o NGINX, um processo menos comum hoje em dia, dado que a maioria dos pacotes de distribuição já vem com essa funcionalidade habilitada por padrão.
Como habilitar e consultar o status
Configurar a monitoração é um processo de poucos minutos. Você deve criar ou editar um bloco de localização (location) dentro do seu arquivo de configuração (geralmente em /etc/nginx/sites-available/default ou similar). Adicione o seguinte trecho de código:
location /nginx_status { stub_status; allow 127.0.0.1; deny all; }Após recarregar o NGINX com nginx -t && systemctl reload nginx, você poderá acessar http://localhost/nginx_status. Lembre-se de restringir o acesso a esse endpoint para seu IP, evitando expor métricas internas do servidor a curiosos ou atacantes. O resultado será um texto simples com números que revelam o "pulso" do seu servidor web.
Interpretando os gargalos
Ao olhar para as métricas, foque nos estados das conexões. Se o número de conexões em reading for alto, o servidor está tendo dificuldades em ler o cabeçalho dos clientes, o que pode indicar problemas de rede. Se o número de conexões em writing for constante e elevado, o seu NGINX pode estar esperando pelo processamento de um backend lento (como um PHP-FPM ou um cluster de microsserviços), o que é muito comum em sistemas complexos, onde o gargalo nem sempre está no servidor web em si, mas em como o sistema gerencia a carga e os pods.
O próximo passo na investigação
O stub_status é apenas o começo da jornada. Se você identificar que o problema não está no NGINX, mas nas conexões TCP que chegam ou saem do servidor, utilize ferramentas mais profundas para o diagnóstico. É possível realizar uma inspeção detalhada da rede usando o comando tcpdump para capturar pacotes específicos, ou monitorar o estado das conexões TCP com o utilitário ss, garantindo assim uma visão completa da pilha de comunicação.
Conclusão
Dominar o monitoramento básico do seu servidor é um diferencial importante para qualquer engenheiro que busca estabilidade. Ao integrar o stub_status nas suas rotinas de observabilidade, você deixa de adivinhar onde está o erro e passa a ter dados concretos para tomar decisões, seja ajustando timeouts ou aumentando a capacidade dos seus servidores.
A estabilidade de uma infraestrutura não vem apenas de hardware potente, mas de uma gestão inteligente dos recursos. Utilize as métricas nativas, automatize a coleta se necessário e nunca negligencie os sinais que o sistema envia antes de uma falha grave ocorrer.