Taufik Mulyana
Taufik Mulyana
Linux System Administrator, Interested in Linux, Cloud, Containers
January 3, 2019 3 min read

Instalasi Nginx dengan Modul VTS

Instalasi Nginx dengan Modul VTS

Instalasi Nginx dengan Modul VTS, vts atau virtualhost traffic statusĀ merupakan sebuah modul nginx yang memungkinkan kita untuk mendapatkan informasi status pada virtualhost, berisi informasi mengenai server, upstream, cache mirip dengan sistem pemantauan pada nginx plus dan halaman htmlnya pun mengambil dari halaman demo sistem pemantauan nginx plus versi lama, untuk memasang modul ini kita perlu melakukan compile sendiri karena tidak tersedia secara langsung pada repositori nginx atau repositori distribusi GNU/Linux.

pada tutorial ini saya akan melakukan compile dari source deb yang diambil dari repository nginx, agar kita bisa membuat paket deb yang nantinya bisa digunakan pada server lain yang berbasiskan Debian.

Unduh Kode Sumber Nginx

saya menggunakan Ubuntu 18.04 Bionic, sebelum melakukan pemasangan tambahkan repositori nginx terlebih dahulu

$ sudo vim /etc/apt/sources.list.d/nginx.list

deb http://nginx.org/packages/ubuntu/ bionic nginx
deb-src http://nginx.org/packages/ubuntu/ bionic nginx

untuk distribusi lain bisa cek disini

lalu mutakhirkan list paket

$ sudo apt-get update

unduh kode sumber nginx dengan perintah berikut

$ cd /usr/local/src
$ sudo apt-get source nginx
-- output --
dpkg-source: info: extracting nginx in nginx-1.15.8
dpkg-source: info: unpacking nginx_1.15.8.orig.tar.gz
dpkg-source: info: unpacking nginx_1.15.8-1~bionic.debian.tar.xz

selanjutnya kita pasang depedensi yang dibutuhkan untuk membangun nginx

$ sudo apt-get build-dep nginx

clone kode sumber modul nginx vts dari github dengan perintah berikut

$ git clone https://github.com/vozlt/nginx-module-vts.git

Build Nginx dengan Modul VTS

untuk menambahkan modul kita perlu menambahkan parameter –add-modules pada rules

$ cd /usr/local/src/nginx-1.15.8/
$ vim debian/rules

cari config.env.nginx dan config.env.nginx_debug dan tambahkan parameter –add-module dan lokasi direktori modul vts dari hasil clone di github tadi

--add-module=/usr/local/src/nginx-module-vts

selanjutnya kita akan buat paket binary deb dengan utilitas dpkg-buildpackage

$ sudo dpkg-buildpackage -b -uc -us

setelah proses build selesai akan ada 2 paket deb, nginx_1.15.8-1~bionic_amd64.deb danĀ nginx-dbg_1.15.8-1~bionic_amd64.deb

modul telah ditambahkan ke paket binary nginx deb selanjutnya kita tinggal memasangnya

$ sudo dpkg -i /usr/local/src/nginx_1.15.*.deb

Konfigurasi Nginx

tambahkan vhost_traffic_status_zone pada direktif http

http {
    vhost_traffic_status_zone
    ...
}

kita akan menyetel status agar tampil pada endpoint /status, tambahkan vhost_traffic_status_display_format html pada direktif location /status

server {
    ...
    location /status {
        vhost_traffic_status_display
        vhost_traffic_status_display_format html;
    }
   ...
}

vhost_traffic_status_display juga boleh ditambahkan agar kita bisa melihat status dengan format lain seperti json, jsonp, prometheus

setelah konfigurasi selesai, kita cek konfigurasinya pastikan tidak ada galat

$ sudo nginx -t

jika tidak ada galat, jalankan layanan nginx

$ sudo systemctl start nginx

selanjutnya anda bisa akses endpoint /status di peramban, berikut tampilan antarmuka dari modul vts

instalasi-nginx-dengan-modul-vts

Leave a Reply

Your email address will not be published. Required fields are marked *