:Integrasi Nginx

Prasyarat

• Layanan Nginx telah diinstal dan berjalan.

• Untuk mengaktifkan pemantauan Stub Status pada Nginx, instal modul ngx_http_stub_status_module.

  Cara menginstal modul ngx_http_stub_status_module

  1. Periksa apakah modul ngx_http_stub_status_module telah diinstal.

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

     • Jika output berikut dikembalikan, modul ngx_http_stub_status_module telah diinstal.

       [root@xxx ~]# nginx -V 2>&1 | grep -o with-http_stub_status_module
       with-http_stub_status_module
       [root@xxx ~]#

     • Jika tidak ada output yang dikembalikan, instal modul tersebut dengan menjalankan perintah berikut:

       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. Aktifkan modul ngx_http_stub_status_module untuk mengkueri status Nginx.

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

     Catatan

     • Jalur location harus diberi nama nginx_status.

     • Direktif allow 127.0.0.1 dan deny all hanya mengizinkan akses lokal. Untuk mengizinkan akses dari Nginx exporter, Anda dapat memberi komentar pada kedua baris tersebut atau mengganti 127.0.0.1 dengan alamat IP Nginx exporter.

  3. Restart Nginx.

     nginx -t
     nginx -s reload 

  4. Opsi: Verifikasi bahwa modul ngx_http_stub_status_module telah dijalankan.

     curl http://127.0.0.1/nginx_status

     Jika output berikut dikembalikan, modul ngx_http_stub_status_module telah dijalankan.

     [root@xxx ~]# curl 12xxx/nginx_status
     Active connections: 1
     server accepts handled requests
      177 177 3956
     Reading: 0 Writing: 1 Waiting: 0
     [root@xxx ~]#

• Untuk mengaktifkan pemantauan VTS pada Nginx, instal modul nginx-module-vts.

  Cara menginstal modul nginx-module-vts

  1. Unduh modul nginx-module-vts.

     Catatan

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

  2. Konfigurasikan pengaturan kompilasi.

     1. Tambahkan modul nginx-module-vts selama kompilasi Nginx.

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

     2. Unduh paket Nginx resmi dan kompilasi modul nginx-module-vts ke dalamnya.

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

  3. Instal modul nginx-module-vts.

     make && make install

  4. Konfigurasikan Nginx. Modifikasi file nginx.conf dan tambahkan titik akhir 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;
             }
         }
     }

     Aktifkan penyaringan vhost dalam file konfigurasi.

     vhost_traffic_status_filter_by_host on

     Catatan

     Jika Nginx dikonfigurasi dengan beberapa direktif server_name, fitur ini memungkinkan sistem mengumpulkan statistik trafik untuk setiap nama server. Jika tidak, seluruh trafik akan dikaitkan dengan server_name pertama secara default.

     Jika Anda tidak perlu mengumpulkan statistik trafik untuk blok server tertentu, Anda dapat menonaktifkan vhost_traffic_status. Tanda elipsis (...) dalam contoh menunjukkan konten yang dihilangkan.

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

  5. Verifikasi bahwa modul nginx-module-vts telah diinstal.

     curl http://127.0.0.1/status

Integrasikan Nginx

1. Masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, buka Integration Center dan klik kartu Nginx.

2. Konfigurasikan parameter integrasi.

   1. Pilih jenis lingkungan.

      • Lingkungan Kubernetes: Target pemantauan berjalan di kluster ACK.

      • ECS (VPC): Target pemantauan berjalan pada instans ECS.

   2. Pilih kluster ACK atau instans ECS.

   3. Konfigurasikan integrasi.

      Lingkungan Kubernetes

      Parameter	Deskripsi	Contoh
      Integration name (optional)	Nama kustom untuk integrasi.	nginxtest123
      Enable Nginx for stub status monitoring	Mengaktifkan atau menonaktifkan fitur pemantauan ini. Fitur ini menyediakan statistik mengenai permintaan dan koneksi Nginx. Catatan Sebelum mengaktifkan opsi ini, pastikan bahwa modul ngx_http_stub_status_module telah diinstal.	N/A
      Enable Nginx for VTS monitoring	Mengaktifkan atau menonaktifkan fitur pemantauan ini. Opsi ini menggunakan modul nginx-module-vts, yang biasanya memerlukan kompilasi manual, untuk mengumpulkan data. Fitur ini menyediakan metrik seperti jumlah permintaan Nginx, ukuran byte, dan waktu respons. Catatan Sebelum mengaktifkan opsi ini, pastikan bahwa modul nginx-module-vts telah diinstal.	N/A
      Nginx host	Jenis berikut didukung: Alamat akses dalam kluster layanan Nginx Alamat IP internal kluster tempat layanan berada Alamat IPv4 publik layanan	nginx-server.namespace
      Nginx port	Port layanan Nginx.	80
      Metric collection interval (seconds)	Interval pengumpulan metrik. Nilai default adalah 15 detik.	15

      ECS (VPC)

      Parameter	Deskripsi	Contoh
      Integration name (optional)	Nama kustom untuk integrasi.	nginxtest321
      Enable Nginx for stub status monitoring	Mengaktifkan atau menonaktifkan fitur pemantauan ini. Fitur ini menyediakan statistik mengenai permintaan dan koneksi Nginx.	N/A
      Enable Nginx for VTS monitoring	Mengaktifkan atau menonaktifkan fitur pemantauan ini. Opsi ini menggunakan modul nginx-module-vts, yang biasanya memerlukan kompilasi manual, untuk mengumpulkan data. Fitur ini menyediakan metrik seperti jumlah permintaan Nginx, ukuran byte, dan waktu respons. Catatan Sebelum mengaktifkan opsi ini, pastikan bahwa modul nginx-module-vts telah diinstal.	N/A
      Nginx host	Jenis berikut didukung: Alamat akses dalam kluster layanan Nginx Alamat IP internal kluster tempat layanan berada Alamat IPv4 publik layanan	nginx-server.namespace
      Nginx port	Port layanan Nginx.	80
      Metric collection interval (seconds)	Interval pengumpulan metrik. Nilai default adalah 15 detik.	15
      Custom Tags	Menambahkan tag pasangan kunci-nilai kustom ke metrik yang dikumpulkan oleh Prometheus, sehingga memungkinkan organisasi, kueri, pemantauan, dan analisis yang lebih terperinci di alat seperti Grafana. Untuk informasi selengkapnya, lihat Suntikkan tag kustom ke metrik untuk instans di lingkungan VPC. Catatan Kunci tag tidak boleh mengandung karakter khusus seperti tanda hubung (-), titik (.), atau persen (%) karena karakter-karakter ini memiliki makna khusus di Prometheus. Tag yang disuntikkan harus dalam format kunci-nilai yang valid sesuai aturan Prometheus.	test1:aaa

Lihat informasi pemantauan

Untuk melihat komponen yang telah diintegrasikan, klik Integration Management di panel navigasi sebelah kiri. Klik kartu integrasi untuk melihat detailnya, termasuk target, metrik, dasbor, peringatan, konfigurasi penemuan layanan, dan exporter. Di halaman Self-monitoring untuk lingkungan Kubernetes, pilih tab Prometheus Agent. Anda dapat menyaring data menggunakan daftar drop-down job, instance, dan agent. Halaman ini menampilkan panel pemantauan berikut: Agent running status (replika yang diharapkan, replika yang berjalan, jumlah target, dan total deret waktu yang diambil); Agent discovery/scraping exceptions (jumlah pengecualian penemuan layanan job, pengecualian scraping job, dan pengecualian scraping target; pengecualian ditandai dengan warna merah); Agent configuration delivery exceptions (pengecualian sendConfig dan pengecualian sendTargets; status normal ditunjukkan dengan warna hijau); Agent collection and processing exceptions; dan Agent running version. Di bagian bawah, tabel Agent status overview mencantumkan metrik untuk setiap agen, seperti heartbeat, targets, series, writeArms, pod_name, memoryLimit, dan cpuLim.