:Memantau kluster NGINX

Prasyarat

• NGINX telah terinstal dan berfungsi dengan baik.

• Untuk mengaktifkan pemantauan modul status stub NGINX, instal ngx_http_stub_status_module.

  Prosedur untuk Menginstal ngx_http_stub_status_module

  1. Periksa apakah ngx_http_stub_status_module telah terinstal.

     nginx -V 2>&1 | grep -o with-http_stub_status_module

     • Keluaran serupa menunjukkan bahwa ngx_http_stub_status_module telah terinstal.

     • Jika ngx_http_stub_status_module belum terinstal, jalankan perintah berikut untuk menginstal modul:

       wget http://nginx.org/download/nginx-1.13.12.tar.gz
       tar xfz nginx-1.13.12.tar.gz
       cd nginx-1.13.12/
       ./configure --with-http_stub_status_module
       make
       make install

  2. Mulai ngx_http_stub_status_module untuk menanyakan status NGINX.

     location /nginx_status {
       stub_status on;
       allow 127.0.0.1;  # hanya mengizinkan permintaan dari localhost
       deny all;   # menolak semua host lainnya 
      }

     Catatan

     • Nilai dari location harus berupa nginx_status.

     • allow 127.0.0.1 dan deny all hanya mengizinkan akses lokal. Untuk mengizinkan akses dari kluster NGINX, komentari dua baris kode ini, atau ubah 127.0.0.1 menjadi alamat IP kluster NGINX.

  3. Mulai ulang NGINX.

     nginx -t
     nginx -s reload 

  4. (Opsional) Periksa apakah ngx_http_stub_status_module telah dimulai.

     curl http://127.0.0.1/nginx_status

     Keluaran serupa menunjukkan bahwa ngx_http_stub_status_module telah dimulai.

     

• Untuk mengaktifkan pemantauan modul status lalu lintas host virtual (VTS) NGINX, instal nginx-module-vts.

  Prosedur untuk Menginstal nginx-module-vts

  1. Unduh nginx-module-vts di https://github.com/vozlt/nginx-module-vts.

  2. Kompilasi file konfigurasi NGINX.

     1. Tambahkan nginx-module-vts ke file konfigurasi NGINX.

        --add-module=/path/to/nginx-module-vts

     2. Unduh paket perangkat lunak resmi dan kompilasi menjadi nginx-module-vts.

        ./configure --user=www --group=www --prefix=/usr/local/nginx --with-http_sysguard_module  --add-module=nginx-module-vts

  3. Instal nginx-module-vts.

     make && make install

  4. Ubah file konfigurasi NGINX dan tambahkan antarmuka pemantauan.

     http {
         vhost_traffic_status_zone;
             vhost_traffic_status_filter_by_host on;
     
         ...
     
         server {
     
             ...
     
             location /status {
                 vhost_traffic_status_display;
                 vhost_traffic_status_display_format html;
             }
         }
     }

     Disarankan untuk menjalankan perintah berikut guna mengaktifkan penyaringan vhost:

     vhost_traffic_status_filter_by_host on

     Catatan

     Jika Anda mengonfigurasi beberapa nama server di NGINX, aktifkan penyaringan vhost untuk memastikan sistem mengumpulkan data lalu lintas berdasarkan nama server yang berbeda. Jika tidak diaktifkan, sistem akan mengaitkan semua lalu lintas ke server pertama.

     Jika Anda tidak perlu memantau lalu lintas berdasarkan wilayah, jalankan perintah berikut untuk menonaktifkan penyaringan vhost, di mana elipsis (...) menunjukkan kode yang dihilangkan:

     server {
     ...
     vhost_traffic_status off;
     ...
     }

  5. Periksa apakah nginx-module-vts telah terinstal.

     curl http://127.0.0.1/status

Prosedur

1. Masuk ke Konsol ARMS.

2. Di panel navigasi sisi kiri, klik Integration Center. Di halaman yang muncul, klik kartu Nginx.

3. Di halaman Nginx, atur parameter.

   1. Pilih tipe lingkungan.

      • Kubernetes Environment: Objek yang dipantau berjalan di kluster Container Service for Kubernetes (ACK).

      • ECS(VPC): Objek yang dipantau berjalan pada Instance Elastic Compute Service (ECS).

   2. Pilih kluster ACK atau instance ECS sesuai petunjuk.

   3. Atur bagian Configuration Information.

      Kluster ACK

      Parameter	Deskripsi	Contoh
      Name(Not required)	Nama kluster NGINX yang ingin Anda integrasikan ke dalam Managed Service for Prometheus.	nginxtest123
      Enable Nginx for Stub Status monitoring	Menentukan apakah menggunakan ngx_http_stub_status_module (modul bawaan di NGINX) untuk mengumpulkan metrik, termasuk jumlah permintaan yang diterima dan diproses oleh NGINX. Catatan Sebelum mengaktifkan fitur pemantauan ini, pastikan ngx_http_stub_status_module telah terinstal. Untuk informasi lebih lanjut, lihat ngx_http_stub_status_module.	N/A
      Enable Nginx for Vts monitoring	Menentukan apakah menggunakan nginx-module-vts untuk mengumpulkan metrik, termasuk jumlah permintaan NGINX, jumlah byte, dan waktu respons. Catatan Sebelum mengaktifkan fitur pemantauan ini, pastikan nginx-module-vts telah terinstal. Untuk informasi lebih lanjut, lihat nginx-module-vts.	N/A
      Nginx Host	Nama domain layanan NGINX. Nama domain berikut didukung: Endpoint layanan NGINX di dalam kluster Alamat IP internal kluster ACK tempat layanan NGINX berada Alamat IPv4 publik layanan NGINX	nginx-server.namespace
      Nginx Port	Nomor port server NGINX.	80
      Metric collection interval(Unit/second)	Interval untuk mengumpulkan data pemantauan. Nilai default: 15. Satuan: detik.	15

      ECS (VPC)

      Parameter	Deskripsi	Contoh
      Name(Not required)	Nama kluster NGINX yang ingin Anda integrasikan ke dalam Managed Service for Prometheus.	nginxtest321
      Enable Nginx for Stub Status monitoring	Menentukan apakah menggunakan ngx_http_stub_status_module (modul bawaan di NGINX) untuk mengumpulkan metrik, termasuk jumlah permintaan yang diterima dan diproses oleh layanan NGINX.	N/A
      Enable Nginx for Vts monitoring	Menentukan apakah menggunakan nginx-module-vts untuk mengumpulkan metrik, termasuk jumlah permintaan NGINX, jumlah byte, dan waktu respons. Catatan Sebelum mengaktifkan fitur pemantauan ini, pastikan nginx-module-vts telah terinstal. Untuk informasi lebih lanjut, lihat nginx-module-vts.	N/A
      Nginx Host	Nama domain layanan NGINX. Nama domain berikut didukung: Endpoint layanan NGINX di dalam kluster Alamat IP internal kluster ACK tempat layanan NGINX berada Alamat IPv4 publik layanan NGINX	nginx-server.namespace
      Nginx Port	Nomor port server NGINX.	80
      Metric collection interval(Unit/second)	Interval untuk mengumpulkan data pemantauan. Nilai default: 15. Satuan: detik.	15
      Custom Labels	Tag kustom metrik instance ECS yang ditempatkan di virtual private cloud (VPC) yang ingin Anda pantau. Dengan mengonfigurasi tag, Anda dapat mengatur, mencari, memantau, atau menganalisis metrik secara rinci saat menggunakan alat seperti Grafana. Untuk informasi lebih lanjut, lihat Tambahkan tag ke metrik instance ECS menggunakan VPC. Catatan Kunci tag tidak boleh berisi karakter khusus, seperti tanda hubung (-), titik (.), dan persen (%). Karakter khusus digunakan dalam fungsi Prometheus. Tag berformat data key-value.	test1:aaa

Lihat informasi pemantauan

Untuk melihat komponen yang terintegrasi, klik Integration Management di panel navigasi sisi kiri. Setelah mengklik kartu komponen, Anda dapat melihat informasi seperti target, metrik, dasbor, peringatan, konfigurasi penemuan layanan, dan komponen di panel yang muncul.