Surveillance de NGINX et NGINX Plus

Développez votre surveillance actuelle de NGINX (open source) pour prendre en charge les fonctionnalités supplémentaires fournies par le serveur Web NGINX Plus (commercial).

Les intégrations de plug-ins Site24x7 prennent en charge NGINX open source et sa variante commerciale NGINX Plus. Le plug-in existant de la version communautaire de NGINX a été étendu pour prendre en charge la surveillance avancée de l'activité en direct et beaucoup plus de fonctionnalités dans le modèle d'entreprise NGINX Plus. Utilisez cette fonctionnalité supplémentaire pour surveiller vos serveurs Web NGINX et NGINX Plus et garder une longueur d'avance sur les problèmes.

Ce document explique en détail comment configurer NGINX, les plug-ins NGINX Plus et les paramètres de surveillance pour fournir une visibilité approfondie des performances, de la disponibilité et des statistiques d'utilisation des serveurs NGINX.

Indicateurs de surveillance des performances NGINX

NGINX, un serveur proxy HTTP et inverse, est un produit open source, libre. La surveillance de NGINX vous permet de garder une longueur d'avance sur les problèmes survenant au sein de NGINX ainsi que partout ailleurs dans votre infrastructure Web. Les différents indicateurs prêts à l'emploi que nous fournissons sont les suivants :

Attente

An active connection or a keep-alive connection can be in the Attente state if there is no active request at the moment.

Lecture

When a request is received, the connection moves from the waiting state, and the request is counted as Lecture. In this state, NGINX server is reading a client request header.

Connexions ouvertes

It is the rate of connections opened per second. Monitoring connection_opened is critical to know if your reverse proxy or load balancer is optimally processing the requests in a timely manner.

Demandes par seconde

It is the number of requests received per second. Monitoring request_per_s helps to alert on spikes or a sudden drop in the incoming web traffic.

Connexions perdues

The connection_dropped is the count of dropped connections. Generally, connections are dropped when a resource limit has been reached.

Écriture

After a request is read, it is counted as Écriture. The request remains in the Writing state till a response is returned to the client. So while NGINX is waiting for a response from its upstream systems and operating on the response, the request will be in the Writing state.

Indicateurs de surveillance des performances NGINX Plus

NGINX Plus, la version commerciale de NGINX, présente les fonctionnalités open source de base, ainsi que des indicateurs supplémentaires. La version entreprise comprend une surveillance avancée de l'activité et une répartition de la charge, en plus des contrôles de santé pour les pages et les applications personnalisées. Les différents indicateurs fournis pour NGINX Plus sont :

Connexions acceptées et actives

The number of client connections attempted by NGINX is given as connections_accepted. The currently active connections (connections_active) is the same as the reading and writing states combined in open source NGINX.

Poignées de main et échecs de poignées de main

Both NGINX and NGINX Plus are used to terminate encrypted SSL connections, thereby reducing the load on internal servers and certificate costs. Metrics poignées de main and handshakes_failed help in understanding the web server's SSL termination and gauge the capacity of hardwares or virtual machines.

Réponses 1xx, 2xx, 3xx, 4xx, 5xx

Nombre de réponses avec les types de code d'état HTTP 1xx, 2xx, 3xx, 4xx et 5xx.

Sessions réutilisées

The metric session_reuses gives the total number of SSL session credentials reused across multiple SSL connections.

Demandes/réponses par serveur back-end de zone

The total number of sessions reused (session_reuses) and the total number of requests received by the zone backend servers gives an idea as to how traffic gets distributed between NGINX servers and zones.

Connexions abandonnées et inactives

If a worker fails to obtain a connection for a particular request, then that is listed under connections_dropped. The connections_idle is the same as the waiting state in NGINX, i.e. client connections with zero current requests.

Conditions préalables

  • Assurez-vous que le serveur NGINX ou NGINX Plus est installé et qu'il fonctionne.
  • Assurez-vous que la valeur STATUS_URL dans la section config est saisie correctement.
  • Notre agent de surveillance du serveur Linux doit être installé sur le réseau ou sur l'hôte spécifique où les serveur NGINX et NGINX Plus sont exécutés.
  • Lors de l'ajout d'un plug-in, le nom du plug-in et son nom de dossier doivent être identiques.

Installation du plug-in

  • Téléchargez et installez la dernière version de l'agent Linux de Site24x7 sur le serveur sur lequel vous prévoyez d'exécuter le plug-in. S'il est installé avec succès, vous verrez un moniteur de serveur Linux dans le panneau de configuration Site24x7. Cela confirme que l'agent est en mesure de communiquer avec notre centre de données.
  • Download the nginx.py or nginxplus.py file from our GitHub repository.
    wget https://raw.githubusercontent.com/site24x7/plugins/master/nginx/nginx.py
    OR
    wget https://raw.githubusercontent.com/site24x7/plugins/master/nginxplus/nginxplus.py
  • Par défaut, le chemin Python indiqué dans le script du plug-in est #!/usr/bin/python. Si vous souhaitez fournir un autre chemin d'accès python, remplacez le chemin existant précédé du caractère shebang « #! ».
  • Par défaut, le plug-in surveille l'instance NGINX ou NGINX Plus configurée sur « localhost ». Modifiez la valeur NGINX_STATUS_URL pour modifier la configuration de la surveillance. Si vous avezplusieurs configurations, vous pouvez les exécuter à l'aide d'un seul script de plug-in. Saisissez les détails de configuration requis dans « nginx.cfg » ou « nginxplus.cfg » dans notre référentiel GitHub.
  • Créez un dossier portant le nom « nginx » ou « nginxplus » sous le répertoire des plug-ins de l'agent Linux de Site24x7 : /opt/site24x7/monagent/plugins/ et placez les fichiers nginx.py et nginxplus.py dans leurs dossiers respectifs.
L'agent exécute automatiquement le plug-in dans un délai de cinq minutes et envoie les données de performances au centre de données Site24x7.
Conseil

Manually execute the plugin script using the following command and verify its output. For example, for the NGINX plugin:

python nginx.py

Afficher les données dans le client Web de Site24x7

  1. Connectez-vous à Site24x7 et accédez à Serveur > Plug-ins > et cliquez sur le nom du moniteur de plug-in.
  2. Vous pourrez afficher les graphiques de performances sur les différents indicateurs de vos serveurs NGINX et NGINX Plus.

Contribution du plug-in

N'hésitez pas à contribuer à notre plug-in existant et à faire des suggestions ou des commentaires sur notre communauté.