Konfigurasi modul stub_status nginx untuk kebutuhan monitoring statistik dasar

stub_status di NGINX adalah modul bawaan (module http_stub_status_module) yang digunakan untuk menampilkan statistik ringan dan real-time dari server NGINX, seperti:

• Jumlah koneksi aktif
• Permintaan yang diterima dan diproses
• Koneksi dalam status membaca/menulis/waiting

Modul ini sangat berguna untuk:

• Monitoring performa NGINX
• Integrasi dengan tool observabilitas seperti Prometheus, Grafana, Zabbix, dll.
• Troubleshooting (apakah ada koneksi yang menggantung, overload, dll)

Berikut adalah konfigurasi lengkap stub_status di NGINX untuk monitoring statistik dasar seperti active connection, request rate, dan lain-lain (biasanya untuk integrasi dengan Prometheus atau NGINX monitoring tools):

Pastikan Modul stub_status Aktif

Modul stub_status sudah terpasang secara default di NGINX versi bawaan Ubuntu. Kamu bisa cek:

nginx -V 2>&1 | grep --color stub_status

Jika muncul --with-http_stub_status_module, berarti sudah aktif.

---

Cara Mengaktifkan stub_status di nginx:

Edit file NGINX, biasanya di:

• /etc/nginx/nginx.conf atau
• /etc/nginx/sites-available/default

Tambahkan konfigurasi location /nginx_status:

location /nginx_status {
    stub_status;
    allow 127.0.0.1;  # hanya localhost (ubah jika perlu)
    deny all;
}

Keterangan :

URAIAN	PERINTAH	KETERANGAN
Untuk mengizinkan hanya localhost	allow 127.0.0.1;	Hanya dapat di akses melalui localhost itu sendiri
Untuk mengizinkan hanya IP tertentu	allow 180.242.5.123;	Hanya mengizinkan untuk IP Client 180.242.5.123
Untuk mengizinkan dari segmen network tertentu	allow 10.10.10.0/24;	Hanya mengizinkan untuk segmen dari IP tersebut

Setelah konfigurasi ditambahkan, jalankan perintah berikut untuk memuat ulang service nginx dan menjalankan perintah di bawah:

sudo nginx -t
sudo systemctl reload nginx

---

Cara akses & Test Hasil konfigurasi stub_nginx:

Akses menggunakan browser:

http://localhost/nginx_status

Akses menggunakan curl di command promt :

curl http://localhost/nginx_status

Contoh output :

Active connections: 3 
server accepts handled requests
 22 22 38 
Reading: 0 Writing: 1 Waiting: 2