NGINX

Type de données

Métriques de l’équilibreur de charge

Description

La surveillance NGINX est un rapport basé sur le temps, fondé sur les métriques de données disponibles. Elle offre aux clients une visibilité sur les métriques disponibles dans leurs applications Openmix. Le rapport temporel des métriques NGINX est ingéré par Fusion afin que les clients puissent voir les performances actuelles et récentes des équilibreurs de charge.

Elle fournit des données sur la santé de l’équilibreur de charge NGINX et des serveurs d’applications. Elle affiche les métriques du flux NGINX Fusion de manière à fournir un retour d’information au client sur la santé des serveurs NGINX. L’intégration standard de NGINX Fusion permet d’inclure les métriques NGINX dans les applications Openmix.

Format du flux de données

Exemple de flux de données

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

Valeurs du flux

Valeurs pouvant être calculées dans l’application :

Informations configurées par équilibreur de charge

Point de terminaison pour récupérer le statut : http://nginx.org/en/docs/http/ngx_http_stub_status_module.html

Configuration du serveur

Exemple de configuration

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

Collecte de métriques : NGINX (open source)

NGINX open source expose plusieurs métriques de base sur l’activité du serveur sur une page de statut simple, à condition que le module HTTP stub status soit activé.

Pour vérifier si le module est déjà activé, exécutez : nginx -V 2>&1 | grep -o with-http_stub_status_module

Le module de statut est activé si vous voyez with-http_stub_status_module comme sortie dans le terminal. Si cette commande ne renvoie aucune sortie, vous devez activer le module de statut. Vous pouvez utiliser le paramètre de configuration --with-http_stub_status_module lors de la compilation de NGINX à partir des sources :

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

Après avoir vérifié que le module est activé ou l’avoir activé vous-même, vous devrez également modifier votre configuration NGINX pour configurer une URL accessible localement (par exemple, /nginx_status) pour la page de statut :

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

Remarque : Les blocs de serveur de la configuration NGINX ne se trouvent pas dans le fichier de configuration principal (par exemple, /etc/nginx/nginx.conf), mais dans des fichiers de configuration supplémentaires référencés par la configuration principale. Pour trouver les fichiers de configuration pertinents, localisez d’abord la configuration principale en exécutant :

`nginx -t`

Ouvrez le fichier de configuration principal listé et recherchez les lignes commençant par include près de la fin du bloc HTTP, telles que :

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

Dans l’un des fichiers de configuration référencés, vous devez trouver le bloc de serveur principal, que vous pouvez modifier comme ci-dessus pour configurer le rapport de métriques NGINX. Après avoir modifié les configurations, rechargez la configuration en exécutant :

`nginx -s reload`

Vous pouvez maintenant consulter la page de statut pour voir vos métriques :

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

Si vous essayez d’accéder à la page de statut depuis une machine distante, vous devez ajouter l’adresse IP de la machine distante à la liste blanche de votre configuration de statut, tout comme 127.0.0.1 est ajouté à la liste blanche dans l’extrait de configuration ci-dessus.

La page de statut NGINX est un moyen facile d’obtenir un aperçu rapide de vos métriques, mais pour une surveillance continue, vous devez enregistrer automatiquement ces données à intervalles réguliers. Des analyseurs pour la page de statut NGINX existent pour des outils de surveillance tels que Nagios et Datadog, et pour le démon de collecte de statistiques collectd.

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

Configuration dans Fusion

Vous pouvez accéder aux flux de données Fusion depuis le volet de navigation de gauche, sous Openmix. Pour les étapes initiales, veuillez consulter la documentation d’intégration de Fusion.

Lorsque vous accédez à la boîte de dialogue de configuration spécifique au service, saisissez les informations suivantes :

• Nom : Le nom donné au flux de données. Par défaut, il s’agit de “Service - Nom de la plateforme” s’il n’est pas spécifié.
• Exécuter toutes les : La fréquence à laquelle le flux de données est mis à jour à partir du service.
• Plateforme : La plateforme associée au flux de données.
• URL : L’URL est un point de terminaison sur le réseau du client qui renvoie les données que le client souhaite voir dans Openmix.

Une fois l’installation terminée, elle est répertoriée sur la page d’accueil des flux de données Fusion avec un statut vert et des métriques de surveillance dans l’historique des journaux.

Pour modifier un flux de données Fusion, cliquez sur le flux de données dans la liste, puis cliquez sur le bouton Modifier. Une fois que vous avez modifié la configuration, cliquez sur Enregistrer. Cela vous ramène à la liste des flux de données avec vos modifications enregistrées et appliquées au flux de données.