Référence des métriques et attributs OpenTelemetry NGINX

Cette référence couvre toutes les métriques et attributs collectés par le récepteur OpenTelemetry NGINX, applicables aux déploiements sur hôte et Kubernetes.

Métriques principales de NGINX

Le nginxreceiver de OpenTelemetry Collector Contrib collecte les métriques suivantes à partir du module de statut stub NGINX :

métrique	Description	Type
`nginx.connections_accepted`	Le nombre total de connexions client acceptées. Utilisez ceci pour suivre les taux d'acceptation des connexions au fil du temps.	Somme
`nginx.connections_handled`	Le nombre total de connexions gérées. Généralement, la valeur du paramètre est la même que nginx.connections_accepted sauf si certaines limites de ressources ont été atteintes (par exemple, la limite worker_connections). Un écart entre les connexions acceptées et gérées suggère des contraintes de ressources.	Somme
`nginx.connections_current`	Le nombre actuel de connexions nginx par état. Les états incluent : active (connexions actives totales), reading (lecture des en-têtes de requête), writing (écriture des réponses), waiting (connexions keep-alive en attente de la prochaine requête).	Somme
`nginx.requests`	Nombre total de requêtes effectuées vers le serveur depuis son démarrage. Utilisez les calculs de taux pour dériver les requêtes par seconde pour le monitoring des performances.	Somme

Conseils de planification de la capacité :

Un nombre élevé de connexions waiting peut indiquer des opportunités d'optimisation keep-alive
L'écart entre les connexions accepted et handled suggère des contraintes de ressources
Les ratios requête-connexion aident à optimiser les configurations des workers

Attributs de ressource

Les attributs de ressource fournissent un contexte sur votre déploiement NGINX et varient selon que vous utilisez un déploiement sur hôte ou Kubernetes.

Attribut commun

Attribut	Description	Exemples de valeurs
`state`	L'état d'une connexion (applicable à la métrique `nginx.connections_current`)	`active`, `reading`, `writing`, `waiting`
`nginx.server.endpoint`	L'URL du point de terminaison de statut stub NGINX	`http://localhost:8080/stub_status`

Attributs de déploiement sur hôte

Attribut	Description	Exemples de valeurs
`nginx.deployment.name`	Un nom unique pour identifier ce déploiement NGINX	`production-web-01`, `staging-api`
`nginx.display.name`	Un nom convivial combinant le préfixe « server » avec le nom du déploiement	`server:production-web-01`
`host.name`	Le nom d'hôte du système où NGINX est en cours d'exécution	`web-server-01.example.com`
`host.id`	L'identifiant unique du système hôte	`i-1234567890abcdef0`
`logtype`	Le type de log collecté (applicable aux logs uniquement). Utilisé par les règles d'analyse intégrées de New Relic. Cet attribut est disponible uniquement lorsque le transfert des logs est activé.	`nginx` (pour les logs d'accès), `nginx-error` (pour les logs d'erreurs)

Attributs de déploiement Kubernetes

Attribut	Description	Exemples de valeurs
`k8s.cluster.name`	Le nom du cluster Kubernetes	`nginx-cluster`, `production-k8s`
`k8s.namespace.name`	L'espace de noms Kubernetes où le pod NGINX est en cours d'exécution	`default`, `web-services`, `production`
`k8s.pod.name`	Le nom du pod Kubernetes exécutant NGINX	`nginx-deployment-7d4b8c6f9-x5z8w`
`nginx.deployment.name`	Défini sur le nom du pod pour les déploiements Kubernetes	`nginx-deployment-7d4b8c6f9-x5z8w`
`nginx.display.name`	Un nom d'affichage complet comprenant les informations sur le cluster, l'espace de noms et le pod	`server:k8s:nginx-cluster:default:pod:nginx-deployment-7d4b8c6f9-x5z8w:nginx:8080`

Détails de la collecte des métriques

Fréquence de collecte

Intervalle par défaut: 30 secondes
Configurable: peut être ajusté dans la configuration d'OpenTelemetry Collector

Source des données

Toutes les métriques sont collectées à partir du module stub_status de NGINX, qui doit être activé et configuré pour exposer un point de terminaison HTTP.

types métriques

Métriques de somme: valeurs cumulées qui représentent les totaux au fil du temps
Calculs de taux: utilisez la fonction rate() de New Relic pour convertir les métriques cumulées en taux par seconde pour le monitoring

Guides de configuration :

Monitorer NGINX sur des environnements auto-hébergés - Configuration complète pour les déploiements sur hôte
Monitorer NGINX sur Kubernetes - Configuration complète pour les déploiements Kubernetes

Utilisation des données :

Trouvez et interrogez vos données NGINX - Dashboards, requêtes NRQL et alertes

Référence technique :

Documentation du récepteur NGINX - Détails techniques d'OpenTelemetry

Cette traduction automatique est fournie pour votre commodité.