:Nginx entegrasyonu

Arka plan bilgileri

Nginx ölçümlerini ARMS konsolu içindeki Integration Center bölümünde görüntüleyin. Integration Center bölümünde Nginx bileşenini arayın, Collect Metrics sekmesini seçin ve ardından Kubernetes Environment sekmesine geçin. nginx_connections_accepted, nginx_connections_active, nginx_connections_handled, nginx_connections_reading, nginx_connections_waiting, nginx_connections_writing, nginx_http_requests_total, nginx_up ve nginxexporter_build_info dahil olmak üzere Nginx için desteklenen ölçümleri görüntüleyebilirsiniz. Ölçüm türleri COUNTER ve GAUGE'dür ve tüm ölçümler 'common' grubundadır.

Ön koşullar

• Nginx hizmeti yüklü ve çalışıyor durumdadır.

• Nginx için Stub Status izlemeyi etkinleştirmek üzere ngx_http_stub_status_module modülünü yükleyin.

  ngx_http_stub_status_module modülü nasıl yüklenir

  1. ngx_http_stub_status_module modülünün yüklü olup olmadığını kontrol edin.

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

     • Aşağıdaki çıktı döndürülürse ngx_http_stub_status_module modülü yüklüdür.

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

     • Çıktı döndürülmezse aşağıdaki komutları çalıştırarak modülü yükleyin:

       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. Nginx durumunu sorgulamak için ngx_http_stub_status_module modülünü etkinleştirin.

     location /nginx_status {
       stub_status on;
       allow 127.0.0.1;  #only allow requests from localhost
       deny all;   #deny all other hosts 
      }

     Not

     • Konum yolu nginx_status olarak adlandırılmalıdır.

     • allow 127.0.0.1 ve deny all yönergeleri yalnızca yerel erişime izin verir. Nginx exporter'dan gelen erişime izin vermek için bu iki satırı yorum satırı yapabilir veya 127.0.0.1 değerini Nginx exporter'ın IP adresiyle değiştirebilirsiniz.

  3. Nginx'i yeniden başlatın.

     nginx -t
     nginx -s reload 

  4. İsteğe bağlı: ngx_http_stub_status_module modülünün başlatıldığını doğrulayın.

     curl http://127.0.0.1/nginx_status

     Aşağıdaki çıktı döndürülürse ngx_http_stub_status_module modülü başlatılmış demektir.

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

• Nginx için VTS izlemeyi etkinleştirmek üzere nginx-module-vts modülünü yükleyin.

  nginx-module-vts modülü nasıl yüklenir

  1. nginx-module-vts modülünü indirin.

     Not

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

  2. Derleme ayarlarını yapılandırın.

     1. Nginx derlemesi sırasında nginx-module-vts modülünü ekleyin.

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

     2. Resmi Nginx paketini indirin ve nginx-module-vts modülünü buna derleyin.

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

  3. nginx-module-vts modülünü yükleyin.

     make && make install

  4. Nginx'i yapılandırın. nginx.conf dosyasını değiştirin ve izleme uç noktasını ekleyin.

     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;
             }
         }
     }

     Yapılandırma dosyasında sanal ana bilgisayar filtrelemeyi etkinleştirin.

     vhost_traffic_status_filter_by_host on

     Not

     Nginx birden fazla server_name yönergesi ile yapılandırılırsa bu özellik sistemin her sunucu adı için trafik istatistiklerini toplamasına olanak tanır. Aksi takdirde tüm trafik varsayılan olarak ilk server_name değerine atanır.

     Belirli bir sunucu bloğu için trafik istatistiklerini toplamanız gerekmiyorsa vhost_traffic_status özelliğini devre dışı bırakabilirsiniz. Örnekteki üç nokta (...) atlanan içeriği belirtir.

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

  5. nginx-module-vts modülünün yüklendiğini doğrulayın.

     curl http://127.0.0.1/status

Nginx'i entegre edin

1. ARMS konsolunda oturum açın. Sol gezinme bölmesinde Integration Center bölümüne gidin ve Nginx kartını tıklayın.

2. Entegrasyon parametrelerini yapılandırın.

   1. Ortam türünü seçin.

      • Kubernetes Environment: İzleme hedefi bir ACK kümesinde çalışır.

      • ECS (VPC): İzleme hedefi bir ECS örneğinde çalışır.

   2. Bir ACK kümesi veya bir ECS örneği seçin.

   3. Entegrasyonu yapılandırın.

      Kubernetes environment

      Parametre	Açıklama	Örnek
      Integration name (optional)	Entegrasyon için özel bir ad.	nginxtest123
      Enable Nginx for stub status monitoring	Bu izleme özelliğini etkinleştirir veya devre dışı bırakır. Nginx istekleri ve bağlantıları hakkında istatistikler sağlar. Not Bu seçeneği etkinleştirmeden önce ngx_http_stub_status_module modülünün yüklü olduğundan emin olun.	Yok
      Enable Nginx for VTS monitoring	Bu izleme özelliğini etkinleştirir veya devre dışı bırakır. Bu seçenek, genellikle manuel derleme gerektiren nginx-module-vts modülünü kullanarak veri toplar. Nginx istek sayıları, bayt boyutları ve yanıt süreleri gibi ölçümler sağlar. Not Bu seçeneği etkinleştirmeden önce nginx-module-vts modülünün yüklü olduğundan emin olun.	Yok
      Nginx host	Aşağıdaki türler desteklenir: Nginx hizmetinin küme içi erişim adresi Hizmetin bulunduğu kümenin dahili IP adresi Hizmetin genel IPv4 adresi	nginx-server.namespace
      Nginx port	Nginx hizmetinin bağlantı noktası.	80
      Metric collection interval (seconds)	Ölçüm toplama aralığı. Varsayılan değer 15 saniyedir.	15

      ECS (VPC)

      Parametre	Açıklama	Örnek
      Integration name (optional)	Entegrasyon için özel bir ad.	nginxtest321
      Enable Nginx for stub status monitoring	Bu izleme özelliğini etkinleştirir veya devre dışı bırakır. Nginx istekleri ve bağlantıları hakkında istatistikler sağlar.	Yok
      Enable Nginx for VTS monitoring	Bu izleme özelliğini etkinleştirir veya devre dışı bırakır. Bu seçenek, genellikle manuel derleme gerektiren nginx-module-vts modülünü kullanarak veri toplar. Nginx istek sayıları, bayt boyutları ve yanıt süreleri gibi ölçümler sağlar. Not Bu seçeneği etkinleştirmeden önce nginx-module-vts modülünün yüklü olduğundan emin olun.	Yok
      Nginx host	Aşağıdaki türler desteklenir: Nginx hizmetinin küme içi erişim adresi Hizmetin bulunduğu kümenin dahili IP adresi Hizmetin genel IPv4 adresi	nginx-server.namespace
      Nginx port	Nginx hizmetinin bağlantı noktası.	80
      Metric collection interval (seconds)	Ölçüm toplama aralığı. Varsayılan değer 15 saniyedir.	15
      Custom Tags	Prometheus tarafından toplanan ölçümlere özel anahtar-değer çifti etiketleri ekler. Bu sayede Grafana gibi araçlarda daha ayrıntılı organizasyon, sorgulama, izleme ve analiz yapılabilir. Daha fazla bilgi için bkz. VPC ortamındaki bir örnek için ölçümlere özel etiket ekleme. Not Etiket anahtarları Prometheus'ta özel anlamlara sahip oldukları için tire (-), nokta (.) veya yüzde (%) gibi özel karakterler içeremez. Eklenen etiketler Prometheus'un izin verdiği geçerli bir anahtar-değer biçiminde olmalıdır.	test1:aaa

İzleme bilgilerini görüntüleme

Entegre edilmiş bileşenleri görüntülemek için sol gezinme bölmesinde Integration Management seçeneğine tıklayın. Hedefler, ölçümler, panolar, uyarılar, hizmet keşfi yapılandırmaları ve exporter'lar dahil olmak üzere ayrıntılarını görüntülemek için bir entegrasyon kartını tıklayın. Kubernetes ortamı için Self-monitoring sayfasında Prometheus Agent sekmesini seçin. Verileri job, instance ve agent açılır listelerini kullanarak filtreleyebilirsiniz. Sayfa aşağıdaki izleme panellerini gösterir: Agent running status (beklenen çoğaltmalar, çalışan çoğaltmalar, hedef sayısı ve toplam seri kazınması); Agent discovery/scraping exceptions (iş hizmeti keşfi istisnaları, iş kazıma istisnaları ve hedef kazıma istisnaları sayısı; istisnalar kırmızıyla vurgulanır); Agent configuration delivery exceptions (sendConfig istisnaları ve sendTargets istisnaları; normal durum yeşil renkle belirtilir); Agent collection and processing exceptions; ve Agent running version. Alt kısımdaki Agent status overview tablosu heartbeat, targets, series, writeArms, pod_name, memoryLimit ve cpuLim gibi her aracının ölçümlerini listeler.