F5 NGINX PLUS

F5 NGINX Plus : Surveillance de l’activité en direct

Vous avez déjà eu besoin de savoir ce qui arrive en ce moment-même à votre serveur NGINX Plus ? Vous craignez une attaque DDoS, ou des utilisateurs signalent des erreurs sur votre site web ? NGINX Plus comprend une interface de surveillance de l’activité en temps réel qui fournit des mesures clés de charge et de performance. En utilisant une interface RESTful JSON simple, il est très facile de connecter ces statistiques à des tableaux de bord en direct et à des outils de surveillance de tierce partie.

Le tableau de bord NGINX Plus fournit des informations essentielles sur les performances des applications
Le tableau de bord NGINX Plus fournit des informations essentielles sur les performances des applications

Les données de suivi de l’activité en direct sont générées par l’API NGINX Plus API. Vous pouvez configurer la surveillance de l’activité en direct comme suit :

server {
    listen 8080;

    location /api {
        api write=on;
        # directives limiting access to the API
    }

    location = /dashboard.html {
        root   /usr/share/nginx/html;
    }

    # Redirection des requêtes faites vers le tableau de bord de l’API pré-NGINX Plus
    location = /status.html {
        return 301 /dashboard.html;
    }
}

Le paramètre write=on est nécessaire si vous souhaitez utiliser l’API pour reconfigurer les groupes en amont ou effacer l’ensemble des statistiques collectées. Il n’est pas nécessaire pour récupérer des informations d’état.

Nous vous recommandons de restreindre l’accès à l’emplacement /api. Le Guide d’administration de NGINX Plus décrit plus en détail les schémas de sécurité appropriés.

En détail : le flux JSON de surveillance de l’activité en direct

Lorsque vous accédez à l’API, NGINX Plus renvoie un document au format JSON contenant les statistiques actuelles. Vous pouvez demander des statistiques complètes à l’adresse /api/api-version/, où api-version est le numéro de version de l’API NGINX Plus. Vous pouvez également obtenir des sous-ensembles de données ou des points de données uniques à des points d’extrémité spécifiques de l’API, notamment :

  • /api/api-version/nginx/ : informations de base sur la version, le temps de fonctionnement et l’identification
  • /api/api-version/connections/ : total des connexions actives et inactives
  • /api/api-version/http/caches/ : instrumentation pour chaque zone de cache nommée
  • /api/api-version/http/server_zones/ : nombre de requêtes et de réponses pour chaque zone d’état HTTP
  • /api/api-version/http/upstreams/ : nombre de requêtes et de réponses, temps de réponse, état des contrôles de santé et statistiques sur le temps de fonctionnement par serveur dans chaque groupe HTTP en amont
  • /api/api-version/limit_conns/ : statistiques de limitation de débit indiquant le nombre de connexions passées, rejetées et retardées
  • /api/api-version/limit_reqs/ : statistiques sur la limitation du débit indiquant le nombre de demandes acceptées, rejetées et retardées
  • /api/api-version/stream/upstreams/ : nombre de requêtes et de réponses, temps de réponse, état des contrôles de santé et statistiques sur le temps de fonctionnement par serveur dans chaque groupe TCP/UDP en amont
  • /api/api-version/ssl/ : statistiques SSL/TLS

Pour une liste de tous les points de terminaison, voir la documentation de référence ou la démonstration Swagger UI sur demo.nginx.com.

Supervision externe

Vous pouvez également exporter les indicateurs de NGINX Plus vers les outils de surveillance externes de votre choix. NGINX Plus s’intègre à des outils tiers et NGINX populaires tels que ceux-ci :

Étapes suivantes