Surveillance de NGINX

La mise en place d’un outil de surveillance pour NGINX est essentielle au bon fonctionnement d’un site web. Une surveillance adéquate de NGINX peut fournir de nombreuses informations utiles sur les performances de l’application sous-jacente. Il existe de nombreux systèmes de surveillance adaptés à cette tâche ; la première étape consiste toutefois à activer la collecte de métriques dans NGINX.

Utilisation du module « stub_status »

Il existe un module pour NGINX Open Source appelé « ngx_http_stub_status_module » (ou simplement « stub_status ») qui fournit quelques métriques importantes sur l’activité de NGINX.

Pour vérifier si votre version de NGINX inclut le module stub_status, exécutez nginx -V :

$ nginx -V 2>&1 | grep --color -- --with-http_stub_status_module

Toutes nos versions de NGINX incluent le module stub_status sur toutes les plateformes prises en charge.

Si votre version de NGINX n’inclut pas le module stub_status, vous devez la recompiler à partir du code source en ajoutant le paramètre --with-http_stub_status_module au script configure.

Ensuite, activez le module dans votre configuration NGINX en ajoutant la directive stub_status dans un bloc location. Vous pouvez ajouter ce bloc à une configuration server existante. Vous pouvez également ajouter un bloc server distinct, avec un seul bloc location dédié à la directive stub_status, comme ci-dessous :

server {
    listen 127.0.0.1:80;
    server_name 127.0.0.1;

    location /nginx_status {
        stub_status;
    }
}

Les blocs server appropriés pour la directive stub_status se trouvent parfois en dehors du fichier de configuration principal (nginx.conf). Si vous ne trouvez pas de bloc approprié dans ce fichier, recherchez d’autres fichiers de configuration, qui sont généralement inclus dans nginx.conf.

Nous vous recommandons également de n’autoriser que les utilisateurs habilités à accéder aux métriques, par exemple en incluant les directives allow et deny dans le bloc location ou server.

Après avoir configuré le module stub_status, n’oubliez pas de recharger la configuration de NGINX (par exemple, à l’aide de la commande service nginx reload). Pour en savoir plus sur les signaux de contrôle de NGINX, cliquez ici.

Pour afficher les métriques stub_status, exécutez une requête curl. La commande suivante convient à la configuration présentée ci-dessus :

$ curl http://127.0.0.1/nginx_statusActive connections: 2
server accepts handled requests
 841845 841845 1631067
Reading: 0 Writing: 1 Waiting: 1

Si cela ne fonctionne pas, vérifiez vers où les requêtes adressées à /nginx_status sont acheminées. Dans de nombreux cas, un autre bloc server peut vous empêcher d’accéder aux métriques stub_status. Pour en savoir plus sur ces métriques NGINX à l’échelle de l’instance, consultez la documentation de référence.

Une fois le module stub_status activé et opérationnel dans NGINX, vous pouvez procéder à l’installation et à la configuration du système de surveillance de votre choix.

Fichiers journaux et syslog

Le journal d’accès et le journal d’erreurs de NGINX contiennent de nombreuses informations utiles pouvant servir à la collecte de métriques. Vous pouvez utiliser les variables de NGINX pour personnaliser entièrement le format du journal d’accès. Certains outils de surveillance peuvent exploiter les fichiers journaux de NGINX pour collecter des métriques.

Pour répondre à diverses exigences en matière de performances et de sécurité, envisagez d’utiliser la fonctionnalité syslog de NGINX. Alors que les fichiers journaux sont écrits sur le disque, syslog permet à NGINX d’envoyer les données de journalisation via un protocole réseau. Par exemple, vous pouvez configurer un système Linux dédié pour collecter toutes les données de journalisation provenant de vos différentes instances NGINX.

Pour plus d’informations sur la journalisation, consultez le Guide d’administration de NGINX Plus.

Surveillance de NGINX avec Amplify

Nous proposons un outil natif de surveillance de NGINX. Il s’appelle « NGINX Amplify ». Il s’agit d’un outil SaaS qui vous permet de surveiller gratuitement jusqu’à cinq serveurs (des abonnements sont disponibles pour un plus grand nombre de serveurs).

Il est facile de démarrer avec NGINX Amplify. En moins de dix minutes, vous pouvez obtenir des graphiques prêts à l’emploi pour toutes les principales métriques NGINX. NGINX Amplify utilise automatiquement les métriques de stub_status et des journaux d’accès, et peut également recueillir diverses informations sur le système d’exploitation.

Avec NGINX Amplify, vous pouvez visualiser les performances de NGINX et surveiller le système d’exploitation, PHP‑FPM, les conteneurs Docker, et bien plus encore. Amplify propose notamment un analyseur statique de votre configuration NGINX, qui fournit des recommandations pour la rendre plus sûre et plus efficace.

En savoir plus sur NGINX Amplify ici et l’essayer gratuitement.

Module d’API supplémentaire dans NGINX Plus

NGINX Plus offre un meilleur moyen d’obtenir des métriques de performance grâce à un module d’API spécialisé.

Le module API fournit un ensemble détaillé de métriques, principalement axées sur l’équilibrage de charge et les statistiques des serveurs virtuels. Par exemple, une répartition de tous les codes d’état HTTP (1xx, 2xx, 3xx, 4xx, 5xx) est présentée pour les blocs server. Des informations sur l’état de santé sont disponibles pour les serveurs en amont HTTP et TCP/UDP. Les métriques de cache comprennent les accès réussis et les échecs pour chaque zone de cache.

Outre la collecte d’un ensemble étendu de métriques, l’API vous permet également de reconfigurer les groupes de serveurs en amont HTTP et TCP/UDP et de gérer les variables clé-valeur sans recharger la configuration ni redémarrer NGINX Plus.

NGINX Plus est également fourni avec un tableau de bord intégré qui exploite les métriques supplémentaires. Ces dernières peuvent également être utilisées dans NGINX Amplify.

Autres solutions de surveillance

Plusieurs autres produits de supervision peuvent collecter et présenter les métriques NGINX. Les liens ci-dessous décrivent les scénarios d’intégration les plus courants :

• L’extension de surveillance de NGINX pour AppDynamics
• Datadog‑NGINX intégration
• NGINX monitoring avec Dynatrace
• Le plug-in NGINX pour New Relic
• Le plug-in NGINX pour Pingdom Server Monitor
• Prometheus HTTP : exportateurs et intégrations