Monitorizarea Metricilor de Trafic și Conexiunilor Active cu stub_status în Nginx

Jurnale și depanare Standard Nginx

Ghid de utilizare a modulului ngx_http_stub_status_module: expunerea securizată a metricilor Nginx (conexiuni active, acceptate, procesate, cereri per secundă) pentru Prometheus Nginx Exporter, Datadog sau Zabbix.

Sintaxă
location /nginx_status { stub_status; allow 127.0.0.1; deny all; }

Pentru a menține un server web sănătos în producție, echipele de inginerie au nevoie de vizibilitate în timp real asupra numărului de conexiuni TCP concurente și a ratei de cereri per secundă. Modulul nativ stub_status expune o pagină simplă de text cu metricile vitale ale proceselor worker Nginx, utilizată direct de agenți de monitorizare precum Prometheus Nginx Exporter, Datadog, New Relic sau Grafana.

Configurarea unui punct final securizat de metrici
# În interiorul unui bloc server (sau pe un port dedicat intern 8080):
server {
    listen 127.0.0.1:8080;
    server_name localhost;

    location /nginx_status {
        # Activează pagina de metrici:
        stub_status;

        # Securitate strictă: acces permis EXCLUSIV de pe mașina locală:
        allow 127.0.0.1;
        allow ::1;
        deny all;

        # Dezactivăm jurnalizarea cererilor interne de monitorizare:
        access_log off;
    }
}

Interpretarea Ieșirii stub_status

Ieșirea comenzii: curl http://127.0.0.1:8080/nginx_status
Active connections: 291 
server accepts handled requests
 16630948 16630948 31070465 
Reading: 6 Writing: 179 Waiting: 106
  • Active connections: Numărul total de conexiuni deschise în acest moment (inclusiv conexiunile Waiting).
  • accepts: Numărul total de conexiuni TCP acceptate de la pornirea serverului.
  • handled: Conexiunile procesate cu succes. Dacă acest număr este mai mic decât accepts, serverul a atins limita worker_connections!
  • requests: Numărul total de cereri HTTP deservite (raportul requests / handled arată câte cereri sunt transmise per conexiune prin keep-alive).
  • Reading: Nginx citește antetele trimise de client.
  • Writing: Nginx scrie răspunsul înapoi către client sau citește din backend.
  • Waiting: Conexiuni inactive (Keep-Alive) care așteaptă o nouă cerere de la browser.