NGINX+

Type de données

Mesures d’équilibrage de charge

Description

  • L’adaptateur Fusion s’intègre au flux d’API d’état NGINX+.
  • Échantillon :http://demo.nginx.com/status
  • Format : JSON
  • Mesures de données liées à l’instance NGINX à ingérer : mesures de base du flux d’état NGINX+.

Flux de données

Valeurs d’alimentation

Mesure Valeur d’alimentation JSON, objet
Adresse IP de LB address  
Horodatage load_timestamp  
Charger l’horodatage timestamp  
Informations sur le processus processes (bloc JSON entier) { respawned: counter }
Informations de connexion connections (bloc JSON entier) { accepted: counter, dropped: counter, active: current counter, idle: counter }
Informations SSL ssl { handshakes: counter, handshakes_failed: counter, session_reuses: counter }
Informations sur les demandes requests { total: counter, current: current counter }
En amont upstreams (bloc JSON entier) {["upstream name"]: peers: { [peer index]: id: integer, server: IP string, name: IP string, back up: boolean, weight: integer, state: "up, down, unavail, checking, or unhealthy," active: current counter, requests: counter, header_time: average time (ms), response_time: average time (ms), responses: { 1xx: counter, 2xx: counter, 3xx: counter, 4xx: counter, 5xx: counter, total: counter }, sent: counter, received: counter, fails: counter, unavail: counter, health_checks: { checks: counter, fails: counter, unhealthy: counter, last_passed: boolean }, downtime: time (ms), downstart: timestamp, selected: timestamp }, keepalive: counter, zombies: counter, zone: "zone name" }

Informations configurées par équilibreur de charge

Point de terminaison à partir de l’endroit où extraire l’état :http://nginx.org/en/docs/http/ngx_http_api_module.html

Notes d’implémentation

Le flux de fusion interroge ces points de terminaison sur le serveur NGINX+ :

  • /processes
  • /connections
  • /ssl
  • /requests
  • /upstreams

Configuration serveur

Exemple de configuration

Les documents officiels de NGINX Plus ontdétailssur la façon de configurer le module d’état développé.

http://nginx.org/en/docs/http/ngx_http_status_module.html#data

Collection de mesures : NGINX Plus

Le commercial NGINX Plus fournit beaucoup plus de mesures par son ngx_http_status_module que sont disponibles en open source NGINX. Parmi les mesures supplémentaires exposées par NGINX Plus figurent les octets diffusés en continu et les informations sur les systèmes et les caches en amont. NGINX Plus signale également le nombre de tous les types de code d’état HTTP (1xx, 2xx, 3xx, 4xx, 5xx). Un exemple de tableau d’état NGINX Plus est disponibleici.

Remarque : les connexions « actives » du tableau de bord d’état NGINX Plus sont définies légèrement différemment des connexions d’état Active dans les métriques collectées via le module d’état stub NGINX open source. Dans les mesures NGINX Plus, les connexions actives n’incluent pas les connexions en attente (alias connexions inactives). NGINX Plus présente également des statistiques au format JSON pour une intégration facile avec d’autres systèmes de surveillance. Avec NGINX Plus, vous pouvez voir les mesures et l’état d’intégrité d’un groupe de serveurs en amont donné, ou effectuer une hiérarchisation vers le bas pour obtenir un compte uniquement des codes de réponse d’un seul serveur dans ce flux en amont :

{"1xx":0,"2xx":3483032,"3xx":0,"4xx":23,"5xx":0,"total":3483055}

Pour activer le tableau de bord des mesures NGINX Plus, vous pouvez ajouter un bloc de serveur d’état à l’intérieur du bloc HTTP de votre configuration NGINX. Voir cette sectionsur la collecte de mesures à partir de NGINX open-source pour obtenir des instructions sur la localisation des fichiers de configuration pertinents. Par exemple, pour configurer un tableau de bord d’état sur http://your.ip.address:8080/status.html et une interface JSON sur http://your.ip.address:8080/status, vous devez ajouter le bloc de serveur suivant :

server {
        listen 8080;
        root /usr/share/nginx/html;
        location /status {
          status;
        }
        location = /status.html {
        }
      }

<!--NeedCopy-->

Les pages d’état doivent être actives une fois que vous rechargez votre configuration NGINX :

nginx -s reload

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

Configurer dans Fusion

Vous pouvez accéder aux flux de données Fusion à partir du volet de navigation gauche, sous Openmix. Pour les étapes initiales, reportez-vous à Intégration de Fusion Documentation.

Lorsque vous accédez à la boîte de dialogue de configuration spécifique au service, entrez les éléments suivants :

  • Nom : nom donné au flux de données. La valeur par défaut est « Service - Platform Name » s’il n’est pas spécifié.
  • Exécuter chaque : fréquence à laquelle le flux de données est mis à jour à partir du service.
  • Plateforme : 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 état vert et des mesures 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 la configuration modifiée, 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.

NGINX+