Intégration du contrôleur d'entrée NGINX

NGINX Ingress Controller est un équilibreur de charge spécialisé pour les environnements Kubernetes (et autres environnements conteneurisés). Un contrôleur Ingress fait abstraction de la complexité du routage du trafic des applications Kubernetes et fournit un pont entre les services Kubernetes et les services externes.

Le contrôleur d'entrée NGINX expose les métriques qui peuvent être récupérées par un serveur ou un agent Prometheus . Ces métriques vous informent des connexions de processus en cours et de la charge d'entrée actuelle que votre système gère. Ces métriques vous informent également sur les rechargements de configuration entrants et activent la condition d'alerte sur les erreurs de rechargement de configuration ou les modifications de configuration inattendues.

Utilisez New Relic pour augmenter la visibilité sur les performances de votre contrôleur d’entrée NGINX et alerter sur les erreurs de configuration potentielles. Avec New Relic vous pouvez monitorer :

monitoring du rechargement de la configuration (erreurs et dernier rechargement réussi)
débit à facettes par classes d'entrée
Informations de demande et de réponse détaillées sur le montant de la charge et le temps de réponse
Statistiques sur le processeur et la mémoire

Activer l'intégration

Suivez ces étapes pour activer l'intégration.

Suivez la documentation du NGINX Ingress Controller pour Prometheus pour découvrir les points de terminaison métriques.
Configurer Prometheus monitoring. Les métriques Prometheus doivent être intégrées à New Relic, vous pouvez utiliser l'agent Prometheus ou l'intégration d'écriture à distance, voir comment envoyer des métriques Prometheus.
Important
L' agent Prometheus récupère uniquement les métriques par défaut à partir d'un ensemble d'intégration.
Dans ce cas, vous devez identifier votre pod ou point de terminaison avec l'une de ces étiquettes app.kubernetes.io/name, app.newrelic.io/name, k8s-app contenant la chaîne nginx.
Utilisez la requête suivante pour confirmer que les métriques sont ingérées comme prévu :
```
FROM Metric SELECT count(*) WHERE metricName LIKE 'nginx_%' FACET metricName LIMIT MAX
```
Installez le quickstart de NGINX Ingress Controller pour accéder aux alertes et aux alertes intégrées.
Une fois importés, vous pouvez modifier ou cloner les ressources pour les adapter à vos besoins spécifiques.
Important
Certains graphiques du dashboard incluent des requêtes avec des conditions qui nécessitent l'identification de votre pod ou point de terminaison avec l'une de ces étiquettes app.kubernetes.io/name, app.newrelic.io/name, k8s-app contenant la chaîne nginx.

Rechercher et utiliser les données

Métriques

Les métriques Prometheus sont stockées sous forme de métriques dimensionnelles. Vous pouvez effectuer une requête à l'aide de NRQL ou utiliser l' explorateur de données pour parcourir les métriques, les facettes et filtrer les dimensions associées disponibles.

Les différents ensembles de métriques exposés par cette intégration sont définis dans la documentation de NGINX Ingress Controller.

Utilisez la requête NRQL suivante pour comprendre les métriques ingérées dans New Relic :

Lister les noms métriques uniques :

FROM Metric SELECT uniques(metricName) WHERE metricName LIKE 'nginx_%' LIMIT MAX

Compter le nombre de mises à jour métriques :

FROM Metric SELECT datapointcount() WHERE metricName LIKE 'nginx_%' LIMIT MAX

Estimer l'ingestion de données (ingestion quotidienne, en octets) :

FROM Metric SELECT bytecountestimate() WHERE metricName LIKE 'nginx_%' SINCE 1 day ago

Dépannage

Suivez les conseils de dépannage de la documentation de NGINX Ingress Controller pour vous assurer que les métriques sont configurées comme prévu sur votre cluster.

Vous pouvez également consulter les directives de dépannage spécifiques pour l'intégration Prometheus .

Cette traduction automatique est fournie pour votre commodité.