Référence des métriques OpenTelemetry Elasticsearch

Ce guide de référence fournit un aperçu complet de toutes les métriques collectées par l'intégration OpenTelemetry pour Elasticsearch, vous aidant à comprendre quelles données sont disponibles pour monitorer la santé et les performances de votre cluster.

Indicateurs clés en un coup d'œil

Monitorez l'état de santé et les performances de votre cluster Elasticsearch avec ces métriques essentielles :

Catégorie de métrique	Ce qu'elle mesure	Priorité
Santé Cluster	`elasticsearch.cluster.health` - État global du cluster (vert/jaune/rouge)	🔴 Critique
Statut des shards	`elasticsearch.cluster.shards` - Shards non attribués, en cours de déplacement ou en cours d'initialisation	🔴 Critique
Disponibilité des nœuds	`elasticsearch.cluster.data_nodes` - Nœuds de données actifs dans le cluster	🔴 Critique
Utilisation du tas JVM	`jvm.memory.heap.utilization` - Pourcentage d'utilisation de la mémoire	🔴 Critique
Performance de la recherche	`elasticsearch.node.operations.time` - Latence des requêtes et de l'extraction	🟡 Important
Utilisation des ressources	`system.cpu.utilization` , `system.memory.usage` - Ressources système de l'hôte	🔵 Monitoring

Référence complète des métriques

L'intégration collecte plus de 50 métriques sur le cluster, le nœud, la JVM et l'infrastructure de l'hôte. Développez les sections ci-dessous pour les spécifications détaillées des métriques.

Conseil

Pour le catalogue complet des métriques disponibles, consultez la documentation OpenTelemetry elasticsearchreceiver et hostmetricsreceiver.

métrique	Description	Attributs
`elasticsearch.cluster.health`	L'état de santé du cluster.	—
`elasticsearch.cluster.in_flight_fetch`	Opérations d'extraction de shards toujours en cours.	—
`elasticsearch.cluster.nodes`	Nombre total de nœuds de cluster.	—
`elasticsearch.cluster.data_nodes`	Le nombre de nœuds de données dans le cluster.	—
`elasticsearch.cluster.shards`	Le nombre de shards dans le cluster.	—
`elasticsearch.cluster.pending_tasks`	Tâches au niveau du cluster en attente d'exécution.	—
`elasticsearch.cluster.state_update.time`	Temps cumulé passé à mettre à jour l'état du cluster.	`state` (any) `type` (computation, context_construction, commit, completion, master_apply, notification)

aggregation

(primary_shards | total)

aggregation

(primary_shards | total)

operation

(index, delete, get, query, fetch, scroll, suggest, merge, refresh, flush, warmer)

aggregation

(primary_shards | total)

métrique	Description	Attributs
`elasticsearch.index.documents`	Documents par index, ventilés par état.	`state` (active \| supprimé) `aggregation` (primary_shards \| total)
`elasticsearch.index.operations.merge.current`	Opérations de fusion de segments actives.	`aggregation` (primary_shards \| total)
`elasticsearch.index.operations.time`	Temps passé sur les opérations au niveau de l'index.	`operation` (index, delete, get, query, fetch, scroll, suggest, merge, refresh, flush, warmer) `aggregation` (primary_shards \| total)
`elasticsearch.index.shards.size`	La taille des fragments attribués à cet index.
`elasticsearch.index.segments.count`	Nombre de segments d'un index.
`elasticsearch.index.operations.completed`	Le nombre d'opérations terminées pour un index.

métrique	Description	Attributs
`elasticsearch.node.cache.count`	Hits et manques du cache de requête sur les shards de nœuds.	`type` (hit \| miss)
`elasticsearch.node.cache.evictions`	Éjections du cache de nœud.	`cache_name` (fielddata \| requête)
`elasticsearch.node.cache.memory.usage`	Utilisation de la mémoire cache en octets.	`cache_name` (fielddata \| requête)
`elasticsearch.node.cluster.io`	E/S réseau interne du cluster en octets.	`direction` (reçu \| envoyé)
`elasticsearch.node.documents`	Documents hébergés par le nœud.	`state` (active \| deleted)
`elasticsearch.node.disk.io.read`	Débit de lecture disque (KiB) sur les magasins de fichiers.	—
`elasticsearch.node.disk.io.write`	Débit d'écriture disque (KiB) sur les magasins de fichiers.	—
`elasticsearch.node.fs.disk.available`	Disque disponible pour la JVM.	—
`elasticsearch.node.fs.disk.total`	Capacité totale du disque sur le nœud.	—
`elasticsearch.node.http.connections`	Connexions HTTP desservies par le nœud.	—
`elasticsearch.node.ingest.documents.current`	Documents actuellement ingérés.	—
`elasticsearch.node.ingest.operations.failed`	Échecs d'ingestion cumulés.	—
`elasticsearch.node.open_files`	Descripteurs de fichiers ouverts en cours d'utilisation.	—
`elasticsearch.node.operations.completed`	Opérations effectuées par le nœud.	`operation` (index, delete, get, query, fetch, scroll, suggest, merge, refresh, flush, warmer)
`elasticsearch.node.operations.current`	Opérations en cours.	`operation` (même ensemble)
`elasticsearch.node.operations.get.completed`	Hits et manques GET.	`result` (hit \| miss)
`elasticsearch.node.operations.time`	Temps passé par un nœud sur les opérations..	`Operation` (index \| delete\| get\| query\| fetch\| scroll\| suggest\| merge\| refresh\| flush\| warmer)
`elasticsearch.node.shards.reserved.size`	Croissance prévue des shards due aux récupérations.	—
`elasticsearch.node.shards.size`	La taille des fragments affectés à ce nœud.	—

métrique	Description	Attributs
`elasticsearch.os.cpu.load_avg.1m`	Moyenne de charge du système d'exploitation sur une minute.	—
`elasticsearch.os.cpu.load_avg.5m`	Moyenne de charge du système d'exploitation sur cinq minutes.	—
`elasticsearch.os.cpu.load_avg.15m`	Moyenne de charge du système d'exploitation sur quinze minutes.	—
`elasticsearch.os.cpu.usage`	Utilisation récente du CPU pour l'ensemble du système, ou -1 si non pris en charge.
`elasticsearch.os.memory`	Utilisation de la mémoire physique telle que vue par Elasticsearch.	`state` (libre \| utilisé)
`jvm.gc.collections.count`	Nombre total d'exécutions de garbage collection.	`name` (nom du collecteur)
`jvm.gc.collections.elapsed`	Temps passé dans le garbage collection.	`name` (nom du collecteur)
`jvm.memory.heap.max`	Mémoire de tas maximale disponible.	—
`jvm.memory.heap.used`	Mémoire de tas actuellement utilisée.	—
`jvm.memory.heap.utilization`	Fraction de l'utilisation de la mémoire du tas.	—
`jvm.threads.count`	Nombre de threads JVM actifs.	—

métrique	Description	Attributs
`system.cpu.time`	Temps CPU cumulé ventilé par état.	`cpu` (CPU logique) `state` (idle\| interrupt\| nice\| softirq\| steal\| system\| user\| wait)
`system.cpu.utilization`	Différence de system.cpu.time depuis la dernière mesure par processeur logique, divisée par le temps écoulé (valeur dans l'intervalle [0,1]).	`cpu` (CPU logique) `state` (même ensemble que ci-dessus)
`system.cpu.load_average.1m`	Moyenne de charge du système sur une minute.	—
`system.cpu.load_average.5m`	Moyenne de charge du système sur cinq minutes.	—
`system.cpu.load_average.15m`	Moyenne de charge du système sur quinze minutes.	—
`system.memory.utilization`	Taux d'utilisation de la mémoire.	`state` (used)
`system.memory.usage`	Octets de mémoire utilisés..	`state` (buffered\| cached\| inactive\| free\| slab_reclaimable\| slab_unreclaimable\| used)
`system.disk.io`	Débit d'E/S disque par périphérique.	`device` (disk) `direction` (read \| write)
`system.disk.operations`	Opérations disque par périphérique.	`device` `direction` (lecture \| écriture)
`system.filesystem.usage`	Capacité du système de fichiers par état.	`device` `state` (utilisé \| libre \| réservé)
`system.filesystem.utilization`	Ratio d'utilisation du système de fichiers.	`device` `state` (utilisé)
`system.network.io`	Octets réseau par interface.	`interface` `direction` (receive \| transmit)
`system.network.packets`	Paquets réseau par interface.	`interface` `direction` (receive \| transmit)
`process.cpu.utilization`	Pourcentage du temps CPU total utilisé par le processus depuis la dernière collecte, exprimé sous forme de valeur comprise entre 0 et 1.	`process.pid` (PID) `process.executable.name` (nom binaire) `process.owner` (utilisateur) `state` (utilisateur \| système \| autre)

Attributs de ressource par type de déploiement

Toutes les métriques Elasticsearch incluent des attributs de ressource (tags) qui vous aident à organiser et filtrer vos données dans New Relic. Les attributs spécifiques dépendent de la manière dont vous avez déployé Elasticsearch :

Attributs communs (tous les déploiements)

Chaque déploiement inclut ces identifiants Elasticsearch principaux :

Attribut	Description
`elasticsearch.cluster.name`	Le nom unique de votre cluster Elasticsearch
`elasticsearch.node.name`	Identifiant de nœud Elasticsearch individuel

Déploiements basés sur l'hôte

Pour Elasticsearch s'exécutant directement sur des hôtes ou des VM, vous verrez des attributs d'infrastructure de l'hôte supplémentaires :

Attribut	Description
`host.name`	Nom d'hôte où Elasticsearch s'exécute
`os.type`	Système d'exploitation (linux, windows, darwin)

Déploiements Kubernetes

Les déploiements Kubernetes incluent des attributs d'orchestration de conteneurs supplémentaires pour une visibilité accrue :

Attribut	Description
`k8s.cluster.name`	Nom de votre cluster Kubernetes
`k8s.namespace.name`	L'espace de noms où s'exécute Elasticsearch
`k8s.pod.name`	Le nom spécifique du pod Elasticsearch
`k8s.pod.uid`	Identifiant unique du pod
`k8s.deployment.name`	Nom du déploiement Kubernetes (si vous utilisez un Déploiement)

Utiliser efficacement les attributs de ressource

Ces attributs permettent des scénarios de monitoring puissants :

Gestion multi-environnements :

Filtrer les dashboards par elasticsearch.cluster.name pour la production vs le staging
Créer des stratégies d'alerte spécifiques au cluster
Comparer les performances dans différents environnements

Corrélation de l'infrastructure :

Utilisez host.name ou k8s.pod.name pour corréler avec le monitoring de l'infrastructure
Suivez l'utilisation des ressources au niveau de l'hôte ou du pod
Identifiez les modèles de performance sur l'ensemble de votre infrastructure

Monitoring spécifique à Kubernetes :

Monitorer Elasticsearch dans plusieurs espaces de noms
Suivez les événements du cycle de vie des pods et leur impact sur les performances
Créer des alertes basées sur la santé des déploiements Kubernetes

Prochaines étapes

Maintenant que vous comprenez quelles métriques sont disponibles, voici les prochaines étapes pour un monitoring efficace d'Elasticsearch :

Installation et configuration :

Installation sur l'hôte - Configurez le monitoring d'Elasticsearch exécuté sur des hôtes/VM
Installation Kubernetes - Configurer le monitoring d'Elasticsearch sur Kubernetes

Configurer le monitoring et les alertes :

Afficher vos données - Apprenez à accéder aux dashboards et à explorer vos métriques Elasticsearch dans New Relic
Créer des alertes - Configurez un monitoring proactif avec le mode guidé ou des conditions d'alerte NRQL
Requêtes NRQL - Écrivez des requêtes personnalisées pour analyser vos données de performance Elasticsearch

Cette traduction automatique est fournie pour votre commodité.

Référence des métriques OpenTelemetry Elasticsearch

Indicateurs clés en un coup d'œil

Référence complète des métriques

Conseil

Métriques de cluster(elasticsearchreceiver)

Métriques d'activité d'index (elasticsearchreceiver)

Métriques d'activité et de charge de travail des nœuds (elasticsearchreceiver)

Métriques JVM et OS rapportées par Elasticsearch (elasticsearchreceiver)

Métriques de l'infrastructure hôte (hostmetricsreceiver)

Attributs de ressource par type de déploiement

Attributs communs (tous les déploiements)

Déploiements basés sur l'hôte

Déploiements Kubernetes

Utiliser efficacement les attributs de ressource

Prochaines étapes

Cette traduction automatique est fournie pour votre commodité.

Référence des métriques OpenTelemetry Elasticsearch

Indicateurs clés en un coup d'œil.css-21sua1{background:none;border:none;width:0;padding:0;}

Référence complète des métriques

Conseil

Métriques d'activité d'index (elasticsearchreceiver)

Métriques d'activité et de charge de travail des nœuds (elasticsearchreceiver)

Métriques JVM et OS rapportées par Elasticsearch (elasticsearchreceiver)

Métriques de l'infrastructure hôte (hostmetricsreceiver)

Attributs de ressource par type de déploiement

Attributs communs (tous les déploiements)

Déploiements basés sur l'hôte

Déploiements Kubernetes

Utiliser efficacement les attributs de ressource

Prochaines étapes

Indicateurs clés en un coup d'œil