Monitoramento do NGINX

Configurar uma ferramenta de monitoramento para o NGINX é uma parte importante da manutenção das operações de um site. O monitoramento adequado do NGINX pode revelar muitas informações úteis sobre o desempenho da aplicação subjacente. Existem vários sistemas de monitoramento adequados para essa tarefa; no entanto, o primeiro passo é habilitar a coleta de métricas no NGINX.

Como usar o módulo stub_status Module

Há um módulo para o NGINX Open Source chamado ngx_http_stub_status_module (ou simplesmente stub_status) que disponibiliza algumas métricas importantes sobre a atividade do NGINX.

Para verificar se a sua compilação do NGINX inclui o módulo stub_status, execute nginx -V:

$ nginx -V 2>&1 | grep --color -- --with-http_stub_status_module

Todas as nossas compilações do NGINX incluem o módulo stub_status em todas as plataformas compatíveis.

Se a sua compilação do NGINX não incluir o módulo stub_status, será necessário recompilá-lo a partir do código-fonte e incluir o parâmetro --with-http_stub_status_module no script configure.

Como próxima etapa, habilite o módulo na configuração do NGINX incluindo a diretiva stub_status em um bloco location. Você pode adicionar o bloco a uma configuração de server existente. Como alternativa, adicione um bloco server separado, com um único location específico para a diretiva stub_status, como neste exemplo:

server {
    listen 127.0.0.1:80;
    server_name 127.0.0.1;

    location /nginx_status {
        stub_status;
    }
}

Blocos server apropriados para a diretiva stub_status às vezes são encontrados fora do arquivo de configuração principal (nginx.conf). Se você não encontrar um bloco adequado nesse arquivo, procure outros arquivos de configuração, que normalmente são incluídos no nginx.conf.

Também recomendamos que você permita que apenas usuários autorizados acessem as métricas, por exemplo, incluindo as diretivas allow e deny no bloco location ou server.

Depois de configurar o módulo stub_status, não se esqueça de recarregar a configuração do NGINX (por exemplo, com o comando service nginx reload). Você pode saber mais sobre os sinais de controle do NGINX aqui.

Para exibir as métricas do stub_status, faça uma consulta com o comando curl. O comando a seguir é adequado para a configuração mostrada acima:

$ curl http://127.0.0.1/nginx_statusActive connections: 2
server accepts handled requests
 841845 841845 1631067
Reading: 0 Writing: 1 Waiting: 1

Se isso não funcionar, verifique para onde as solicitações a /nginx_status são encaminhadas. Em muitos casos, outro bloco server pode ser o motivo pelo qual você não consegue acessar as métricas de stub_status. Para saber mais sobre essas métricas do NGINX que abrangem toda a instância, consulte a documentação de referência.

Com o módulo stub_status habilitado e funcionando no NGINX, você pode prosseguir com a instalação e a configuração do sistema de monitoramento de sua preferência.

Arquivos de log e syslog

O log de acesso e o log de erros do NGINX contêm muitas informações úteis para a coleta de métricas. Você pode usar as variáveis do NGINX para personalizar totalmente o formato do log de acesso. Algumas ferramentas de monitoramento podem usar os arquivos de log do NGINX para coletar métricas.

Para atender a diversos requisitos de desempenho e segurança, considere usar o recurso de syslog do NGINX. Enquanto os arquivos de log são gravados em disco, o syslog permite que o NGINX envie dados de log por meio de um protocolo de rede. Por exemplo, você pode configurar um sistema Linux dedicado para coletar todos os dados de log de várias instâncias do NGINX.

Para obter mais informações sobre registros, consulte o Guia do Administrador do NGINX Plus.

Monitoramento do NGINX com o Amplify

Temos uma ferramenta nativa para monitorar o NGINX. Ela se chama NGINX Amplify e é uma ferramenta SaaS que você pode usar para monitorar gratuitamente até cinco servidores (assinaturas estão disponíveis para quantidades maiores de servidores).

É fácil começar a usar o NGINX Amplify. Em menos de dez minutos, você pode obter gráficos prontos para uso de todas as principais métricas do NGINX. O NGINX Amplify usa automaticamente métricas de stub_status e dos logs de acesso, além de poder coletar diversas informações do sistema operacional.

Com o NGINX Amplify, você pode visualizar o desempenho do NGINX e monitorar o sistema operacional, o PHP‑FPM, os contêineres Docker e muito mais. Um recurso exclusivo do Amplify é um analisador estático da configuração do NGINX, que fornece recomendações para torná-la mais segura e eficiente.

Saiba mais sobre o NGINX Amplify aqui e experimente-o gratuitamente.

Módulo adicional de API no NGINX Plus

NGINX Plus oferece uma maneira melhor de obter métricas de desempenho por meio de um módulo de API especializado.

O módulo de API oferece um conjunto detalhado de métricas, com foco principal no balanceamento de carga e nas estatísticas de servidores virtuais. Por exemplo, é apresentado um detalhamento de todos os códigos de status HTTP (1xx, 2xx, 3xx, 4xx, 5xx) para blocos server. As informações de status de integridade estão disponíveis para servidores upstream HTTP e TCP/UDP. As métricas de cache incluem acertos e falhas para cada zona de cache.

Além de coletar um conjunto abrangente de métricas, a API também permite reconfigurar grupos de servidores upstream HTTP e TCP/UDP e gerenciar variáveis de chave-valor sem recarregar a configuração nem reiniciar o NGINX Plus.

O NGINX Plus também inclui um painel integrado que utiliza as métricas adicionais. Essas métricas também estão disponíveis para uso no NGINX Amplify.

Outras soluções de monitoramento

Vários outros produtos de monitoramento podem coletar e apresentar métricas do NGINX. Os links abaixo descrevem os cenários de integração mais comuns:

• A extensão de monitoramento do NGINX para o AppDynamics
• Datadog‑NGINX integração
• NGINX Monitoramento do NGINX com o Dynatrace
• O plug-in do NGINX para o New Relic
• O plug-in do NGINX para o Pingdom Server Monitor
• Prometheus HTTP exporters e integrações