NGINX

Datentyp

Metriken für Lastverteiler

Beschreibung

Die NGINX-Überwachung ist ein zeitbasierter Bericht, der auf den verfügbaren Datenmetriken basiert. Er bietet Kunden Einblick in die Metriken, die in ihren Openmix-Anwendungen verfügbar sind. Die zeitbasierte Berichterstattung der NGINX-Metriken wird von Fusion erfasst, sodass Kunden die aktuelle und jüngste Leistung der Lastverteiler einsehen können.

Er liefert Daten zur Integrität von NGINX-Lastverteilern und Anwendungsservern. Er zeigt die Metriken des NGINX-Fusion-Feeds so an, dass der Kunde Feedback zur Integrität der NGINX-Server erhält. Die Standard-NGINX-Fusion-Integration ermöglicht die Einbeziehung von NGINX-Metriken in Openmix-Anwendungen.

Daten-Feed-Format

Beispiel-Daten-Feed

    {
        "accepts": "5015",
         "active": "4",
         "handled": "5015",
         "reading": "0",
         "requests": "5482",
         "waiting": "3",
         "writing": "1"
    }
<!--NeedCopy-->

Feed-Werte

Werte, die in der Anwendung berechnet werden können:

Konfigurierte Informationen pro Lastverteiler

Endpunkt, von dem der Status abgerufen werden soll: http://nginx.org/en/docs/http/ngx_http_stub_status_module.html

Serverkonfiguration

Beispielkonfiguration

http://nginx.org/en/docs/http/ngx_http_stub_status_module.html

Metrikenerfassung: NGINX (Open-Source)

Open-Source-NGINX stellt mehrere grundlegende Metriken zur Serveraktivität auf einer einfachen Statusseite bereit, sofern das HTTP-Stub-Status-Modul aktiviert ist.

Um zu überprüfen, ob das Modul bereits aktiviert ist, führen Sie Folgendes aus: nginx -V 2>&1 | grep -o with-http_stub_status_module

Das Statusmodul ist aktiviert, wenn Sie with-http_stub_status_module als Ausgabe im Terminal sehen. Wenn dieser Befehl keine Ausgabe zurückgibt, müssen Sie das Statusmodul aktivieren. Sie können den Konfigurationsparameter --with-http_stub_status_module verwenden, wenn Sie NGINX aus dem Quellcode erstellen:

      ./configure \
      … \
      --with-http_stub_status_module
      make
      sudo make install
<!--NeedCopy-->

Nachdem Sie überprüft haben, ob das Modul aktiviert ist, oder es selbst aktiviert haben, müssen Sie auch Ihre NGINX-Konfiguration ändern, um eine lokal zugängliche URL (zum Beispiel /nginx_status) für die Statusseite einzurichten:

      server {
        location /nginx_status
        {
          stub_status on;
          access_log off;
          allow 127.0.0.1;
          deny all;
        }
      }
<!--NeedCopy-->

Hinweis: Die Serverblöcke der NGINX-Konfiguration befinden sich nicht in der Master-Konfigurationsdatei (zum Beispiel /etc/nginx/nginx.conf), sondern in zusätzlichen Konfigurationsdateien, die von der Master-Konfiguration referenziert werden. Um die relevanten Konfigurationsdateien zu finden, suchen Sie zuerst die Master-Konfiguration, indem Sie Folgendes ausführen:

`nginx -t`

Öffnen Sie die aufgelistete Master-Konfigurationsdatei und suchen Sie nach Zeilen, die mit include beginnen, nahe dem Ende des HTTP-Blocks, wie zum Beispiel:

`include/etc/nginx/conf.d/*.conf`

In einer der referenzierten Konfigurationsdateien müssen Sie den Haupt-Serverblock finden, den Sie wie oben beschrieben ändern können, um die NGINX-Metriken-Berichterstattung zu konfigurieren. Nachdem Sie Konfigurationen geändert haben, laden Sie die Konfiguration neu, indem Sie Folgendes ausführen:

`nginx -s reload`

Jetzt können Sie die Statusseite aufrufen, um Ihre Metriken anzuzeigen:

      Active connections: 24
      server accepts handled requests
      1156958 1156958 4491319
      Reading: 0 Writing: 18 Waiting : 6
<!--NeedCopy-->

Wenn Sie versuchen, von einem Remote-Computer auf die Statusseite zuzugreifen, müssen Sie die IP-Adresse des Remote-Computers in Ihrer Statuskonfiguration auf die Whitelist setzen, genau wie 127.0.0.1 im obigen Konfigurationsausschnitt auf der Whitelist steht.

Die NGINX-Statusseite ist eine einfache Möglichkeit, einen schnellen Überblick über Ihre Metriken zu erhalten, aber für die kontinuierliche Überwachung müssen Sie diese Daten automatisch in regelmäßigen Abständen aufzeichnen. Parser für die NGINX-Statusseite existieren für Überwachungstools wie Nagios und Datadog sowie für den Statistik-Sammeldienst collectd.

Quelle: https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/

Einrichtung in Fusion

Sie können über den linken Navigationsbereich unter Openmix auf Fusion-Daten-Feeds zugreifen. Für die ersten Schritte lesen Sie bitte die Dokumentation zur Fusion-Integration.

Wenn Sie zum Dialogfeld für die dienstspezifische Konfiguration gelangen, geben Sie Folgendes ein:

• Name: Der Name, der dem Daten-Feed gegeben wird. Dieser wird standardmäßig auf “Service - Plattformname” gesetzt, wenn nicht anders angegeben.
• Ausführungshäufigkeit: Die Häufigkeit, mit der der Daten-Feed vom Dienst aktualisiert wird.
• Plattform: Die Plattform, die mit dem Daten-Feed verknüpft ist.
• URL: Die URL ist ein Endpunkt im Netzwerk des Kunden, der die Daten zurückgibt, die der Kunde in Openmix sehen möchte.

Nach Abschluss der Installation wird er auf der Startseite der Fusion-Daten-Feeds mit einem grünen Status und Überwachungsmetriken in der Protokollhistorie aufgeführt.

Um einen Fusion-Daten-Feed zu bearbeiten, klicken Sie in der Liste auf den Daten-Feed und dann auf die Schaltfläche Bearbeiten. Nachdem Sie die Konfiguration geändert haben, klicken Sie auf Speichern. Dies führt Sie zurück zur Daten-Feed-Liste, wobei Ihre Änderungen gespeichert und auf den Daten-Feed angewendet wurden.