Elasticsearch monitoring Intégration

Notre intégration Elasticsearch collecte et envoie l'inventaire et les métriques de votre cluster Elasticsearch à notre plateforme, où vous pouvez voir l'état de votre environnement Elasticsearch. Nous collectons des métriques au niveau du cluster, du nœud et de l'index afin que vous puissiez trouver plus facilement la source de tout problème.

Pour installer Elasticsearch monitoring l'intégration , suivez les étapes suivantes :

Installer et activer l'intégration.
Configurer l'intégration.
Rechercher et utiliser des données.
En option, consultez les paramètres de configuration d'Elasticsearch.

Compatibilité et exigences

Versions d'Elasticsearch

Notre intégration est compatible avec Elasticsearch 7.x à 8.X.

Système d'exploitation pris en charge

Windows
Linux

Pour une liste complète des versions spécifiques Windows et Linux, consultez le tableau des systèmes d'exploitation compatibles.

exigences système

Un compte New Relic. Vous n'en avez pas ? Inscrivez-vous gratuitement ! Aucune carte de crédit requise.
Si Elasticsearch ne s'exécute pas sur Kubernetes ou Amazon ECS, installez l'agent d'infrastructure sur un hôte qui exécute Elasticsearch. Sinon:
- Si vous exécutez sur
- Si vous exécutez sur

Installer et activer l'intégration

Pour installer l'intégration Elasticsearch, suivez les instructions correspondant à votre environnement :

Installation de Linux

Suivez les instructions pour installer une intégration et remplacez la variable INTEGRATION_FILE_NAME par nri-elasticsearch.
Changez de répertoire pour accéder au dossier configuration de l'intégration en exécutant :
bash
```
$cd /etc/newrelic-infra/integrations.d
```
Copiez l’exemple de fichier de configuration en exécutant :
bash
```
$sudo cp elasticsearch-config.yml.sample elasticsearch-config.yml
```
Modifiez le fichier de configuration elasticsearch-config.yml avec votre éditeur préféré. Découvrez quelques exemples de fichiers de configuration.
Pour activer l'analyse automatique des erreurs Elasticsearch et logtransfert, copiez (ou renommez) le fichier elasticsearch-log.yml.example en elasticsearch-log.yml. Pas besoin de redémarrer l'agent.

Example

bash

$sudo cp /etc/newrelic-infra/logging.d/elasticsearch-log.yml.example /etc/newrelic-infra/logging.d/elasticsearch-log.yml

Autres environnements

Téléchargez l'image du programme d'installation nri-elasticsearch .MSI depuis :
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-elasticsearch/nri-elasticsearch-amd64.msi
Pour installer à partir de l’invite de commande Windows, exécutez :
```
msiexec.exe /qn /i PATH\TO\nri-elasticsearch-amd64.msi
```
Dans le répertoire de l'intégration, C:\Program Files\New Relic\newrelic-infra\integrations.d\, créez une copie de l'exemple de fichier de configuration en exécutant :
```
cp elasticsearch-config.yml.sample elasticsearch-config.yml
```
Modifiez le fichier elasticsearch-config.ymlcomme décrit dans les fichiers d'exemple elasticsearch-config.yml.

Notes supplémentaires :

Advanced: les intégrations sont également disponibles au formattarball pour permettre une installation en dehors d'un gestionnaire de paquets.
On-host integrations do not automatically update. Pour de meilleurs résultats, mettez régulièrement à jour le package d'intégration et l'agent d'infrastructure.

Ce document vous a-t-il aidé lors de votre installation ?

Configurer l'intégration

Il existe plusieurs façons de configurer l'intégration, selon la manière dont elle a été installée :

Si activé viaKubernetes, voir services de monitoring exécutés sur Kubernetes.
Si activé viaAmazon ECS, voir les services de monitoring exécutés sur ECS.
Si installé sur l'hôte, modifiez la configuration dans le fichier de configuration YAML de l'intégration, elasticsearch-config.yml. La configuration au format YAML d'une intégration est l'endroit où vous pouvez placer les informations de connexion requises et configurer la manière dont les données sont collectées. Les options que vous modifiez dépendent de votre configuration et de vos préférences. Le fichier configuration contient des paramètres communs applicables à toutes les intégrations, tels que interval, timeout, inventory_source. Pour tout savoir sur ces paramètres courants, reportez-vous à notre document sur les formats de configuration .

Important

Si vous utilisez toujours nos legacy fichiers configuration ou de définition, vérifiez le format configuration standard.

Fichiers d'exemple elasticsearch-config.yml

Il s'agit de la configuration de base utilisée pour collecter les métriques et l'inventaire à partir de votre hôte local :

integrations:
  - name: nri-elasticsearch
    env:
      HOSTNAME: localhost
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
      CONFIG_PATH: /etc/elasticsearch/elasticsearch.yml
    interval: 15s
    labels:
      environment: production
    inventory_source: config/elasticsearch

Cette configuration collecte des métriques toutes les 15 secondes et un inventaire toutes les 60 secondes :

integrations:
  - name: nri-elasticsearch
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-elasticsearch
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
      CONFIG_PATH: /etc/elasticsearch/elasticsearch.yml
    interval: 60s
    labels:
      environment: production
    inventory_source: config/elasticsearch

Dans cette configuration nous utilisons la variable d'environnement ELASTIC_HOST pour renseigner le paramètre nom d'hôte de l'intégration :

integrations:
  - name: nri-elasticsearch
    env:
      METRICS: "true"
      HOSTNAME: {{ELASTIC_HOST}}
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
    interval: 15s
    labels:
      env: production
      role: load_balancer

L'intégration est capable de collecter toutes les métriques du cluster en se connectant simplement à l'un des nœuds, en utilisant une configuration de base affichée avant que toutes les métriques du cluster puissent être récupérées.

Une autre façon de configurer l'intégration est de configurer le scraping de toutes les instances mais en activant le paramètre MASTER_ONLY qui fait que l'intégration ne collecte les métriques que si l'nstance scrapée est maître. Cela permet de partager la même configuration pour tous les nœuds et d'éviter la duplication des données.\ Voici à quoi devrait ressembler le fichier de configuration de chacun des nœuds :

integrations:
  - name: nri-elasticsearch
    env:
      HOSTNAME: localhost
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
      MASTER_ONLY: "true"
      CONFIG_PATH: /etc/elasticsearch/elasticsearch.yml
    interval: 15s
    labels:
      environment: production
    inventory_source: config/elasticsearch

Options de configuration pour l'intégration

Pour en savoir plus sur la recherche et l'utilisation de vos données, consultez les paramètres de configuration d'Elasticsearch.

Rechercher et utiliser des données

Les données de ce service sont signalées à un dashboard d'intégration.

Les données Elasticsearch sont attachées aux types d’événements suivants :

ElasticsearchClusterSample
ElasticsearchNodeSample
ElasticsearchCommonSample
ElasticsearchIndexSample

Vous pouvez interroger ces données à des fins de dépannage ou pour créer des graphiques et des dashboards personnalisés.

Pour en savoir plus sur la recherche et l'utilisation de vos données, consultez comment comprendre les données d'intégration.

Métriques collectées par l'intégration

L'intégration Elasticsearch collecte les métriques suivantes. Chaque nom de métrique est préfixé par un indicateur de catégorie et un point, tel que cluster. ou shards..

métrique	Description
`cluster.dataNodes`	Le nombre de nœuds de données dans le cluster.
`cluster.nodes`	Le nombre de nœuds dans le cluster.
`cluster.status`	L’état de santé du cluster Elasticsearch : `red`, `yellow` ou `green`.
`shards.active`	Le nombre de fragments actifs dans le cluster.
`shards.initializing`	Le nombre de fragments en cours d'initialisation.
`shards.primaryActive`	Le nombre de fragments primaires actifs dans le cluster.
`shards.relocating`	Le nombre de fragments qui se déplacent d’un nœud à un autre.
`shards.unassigned`	Le nombre de fragments qui ne sont pas attribués à un nœud.

métrique	Description
`activeSearches`	Le nombre de recherches actives.
`activeSearchesInMilliseconds`	Le temps passé sur la recherche.
`breakers.estimatedSizeFieldDataCircuitBreakerInBytes`	La taille estimée du disjoncteur de données de terrain, en octets.
`breakers.estimatedSizeParentCircuitBreakerInBytes`	La taille estimée du disjoncteur parent, en octets.
`breakers.estimatedSizeRequestCircuitBreakerInBytes`	La taille estimée du disjoncteur de demande, en octets.
`breakers.fieldDataCircuitBreakerTripped`	Le nombre de fois où le disjoncteur de données de terrain s'est déclenché.
`breakers.parentCircuitBreakerTripped`	Le nombre de fois que le disjoncteur parent s'est déclenché.
`breakers.requestCircuitBreakerTripped`	Le nombre de fois où le disjoncteur de demande s'est déclenché.
`cache.cacheSizeIDInBytes`	La taille du cache d'identification, en octets.
`flush.indexFlushDisk`	Le nombre de vidages d'index sur le disque depuis le début.
`flush.timeFlushIndexDiskInSeconds`	Le temps passé à vider l'index sur le disque.
`fs.bytesAvailableJVMInBytes`	Octets disponibles pour cette machine virtuelle Java sur ce magasin de fichiers, en octets.
`fs.bytesReadsInBytes`	Le nombre total d'octets lus à partir du magasin de fichiers, en octets.
`fs.bytesUserIoOperationsInBytes`	Le nombre total d'octets utilisés pour toutes les opérations I/O sur le magasin de fichiers, en octets.
`fs.iOOperations`	Le nombre total d'opérations I/O sur le magasin de fichiers.
`fs.reads`	Le nombre total de lectures à partir du magasin de fichiers.
`fs.totalSizeInBytes`	La taille totale du magasin de fichiers, en octets.
`fs.unallocatedBytesInBytes`	Le nombre total d'octets non alloués dans le magasin de fichiers, en octets.
`fs.writes`	Le nombre total d'écritures dans le magasin de fichiers.
`fs.writesInBytes`	Le nombre total d'octets écrits dans le magasin de fichiers, en octets.
`get.currentRequestsRunning`	Le nombre de requêtes GET en cours d'exécution.
`get.requestsDocumentExists`	Le numéro de requête GET où le document existait.
`get.requestsDocumentExistsInMilliseconds`	Le temps passé sur la requête GET où le document existait.
`get.requestsDocumentMissing`	Le numéro de requête GET où le document était manquant.
`get.requestsDocumentMissingInMilliseconds`	Le temps passé sur la requête GET où le document était manquant.
`get.timeGetRequestsInMilliseconds`	Le temps passé sur la requête GET.
`get.totalGetRequests`	Le nombre de requêtes GET.
`http.currentOpenConnections`	Le nombre de connexions HTTP actuellement ouvertes.
`http.openedConnections`	Le nombre de connexions HTTP ouvertes.
`indexing.docsCurrentlyDeleted`	Le nombre de documents actuellement supprimés d'un index.
`indexing.documentsCurrentlyIndexing`	Le nombre de documents actuellement indexés dans un index.
`indexing.documentsIndexed`	Le nombre de documents indexés dans un index.
`indexing.timeDeletingDocumentsInMilliseconds`	Le temps passé à supprimer des documents d'un index.
`indexing.timeIndexingDocumentsInMilliseconds`	Le temps passé à indexer les documents dans un index.
`indexing.totalDocumentsDeleted`	Le nombre de documents supprimés d'un index.
`indices.indexingOperationsFailed`	Le nombre d’opérations d’indexation ayant échoué.
`indices.indexingWaitedThrottlingInMilliseconds`	L'indexation du temps a été attendue en raison d'une limitation.
`indices.memoryQueryCacheInBytes`	La mémoire utilisée par le cache de requête, en octets.
`indices.numberIndices`	Le nombre de documents sur tous les fragments primaires attribués au nœud.
`indices.queryCacheEvictions`	Le nombre d'expulsions du cache de requêtes.
`indices.queryCacheHits`	Le nombre de requêtes taux d'accès au cache.
`indices.queryCacheMisses`	Le nombre de requêtes échouées dans le cache.
`indices.recoveryOngoingShardSource`	Le nombre de récupérations en cours pour lesquelles un fragment sert de source.
`indices.recoveryOngoingShardTarget`	Le nombre de récupérations en cours pour lesquelles un fragment sert de cible.
`indices.recoveryWaitedThrottlingInMilliseconds`	Le temps total de récupération attendu en raison de la limitation.
`indices.requestCacheEvictions`	Le nombre d'expulsions du cache de requêtes.
`indices.requestCacheHits`	Le nombre de demandes de taux d'accès au cache.
`indices.requestCacheMemoryInBytes`	La mémoire utilisée par le cache de requête, en octets.
`indices.requestCacheMisses`	Le nombre de requêtes manquées dans le cache.
`indices.segmentsIndexShard`	Le nombre de segments dans un fragment d'index.
`indices.segmentsMaxMemoryIndexWriterInBytes`	La mémoire maximale utilisée par le rédacteur d'index, en octets.
`indices.segmentsMemoryUsedDocValuesInBytes`	La mémoire utilisée par les valeurs du document, en octets.
`indices.segmentsMemoryUsedFixedBitSetInBytes`	La mémoire utilisée par l'ensemble de bits fixes, en octets.
`indices.segmentsMemoryUsedIndexSegmentsInBytes`	La mémoire utilisée par les segments d'index, en octets.
`indices.segmentsMemoryUsedIndexWriterInBytes`	La mémoire utilisée par le rédacteur d'index, en octets.
`indices.segmentsMemoryUsedNormsInBytes`	La mémoire utilisée par la norme, en octets.
`indices.segmentsMemoryUsedSegmentVersionMapInBytes`	La mémoire utilisée par la carte des versions de segment, en octets.
`indices.segmentsMemoryUsedStoredFieldsInBytes`	La mémoire utilisée par les champs stockés, en octets.
`indices.segmentsMemoryUsedTermsInBytes`	La mémoire utilisée par les termes, en octets.
`indices.segmentsMemoryUsedTermVectorsInBytes`	La mémoire utilisée par les vecteurs de termes, en octets.
`indices.translogOperations`	Le nombre d'opérations dans le log des transactions.
`indices.translogOperationsInBytes`	La taille du log des transactions, en octets.
`jvm.gc.collections`	Le nombre de récupérations de place exécutées par la JVM.
`jvm.gc.collectionsInMilliseconds`	Le temps passé à la collecte des déchets dans la JVM.
`jvm.gc.concurrentMarkSweep`	Le nombre de GC de marquage et de balayage simultanés dans la JVM.
`jvm.gc.concurrentMarkSweepInMilliseconds`	Le temps passé sur les GC de marquage et de balayage simultanés dans la JVM.
`jvm.gc.majorCollectionsOldGenerationObjects`	Le nombre de GC majeurs dans la JVM qui collectent des objets d'ancienne génération.
`jvm.gc.majorCollectionsOldGenerationObjectsInMilliseconds`	Le temps passé dans les principaux GC de la JVM qui collectent les objets d'ancienne génération.
`jvm.gc.minorCollectionsYoungGenerationObjects`	Le nombre de GC mineurs dans la JVM qui collecte les objets de jeune génération.
`jvm.gc.minorCollectionsYoungGenerationObjectsInMilliseconds`	Le temps passé dans les GC mineurs de la JVM qui collectent les objets de jeune génération.
`jvm.gc.parallelNewCollections`	Le nombre de nouveaux GC parallèles dans la JVM.
`jvm.gc.parallelNewCollectionsInMilliseconds`	Le temps passé sur les nouveaux GC parallèles dans la JVM.
`jvm.mem.heapCommittedInBytes`	La quantité de mémoire garantie comme étant disponible pour le tas JVM, en octets.
`jvm.mem.heapMaxInBytes`	La quantité maximale de mémoire pouvant être utilisée par le tas JVM, en octets.
`jvm.mem.heapUsed`	Le pourcentage de mémoire actuellement utilisé par le tas JVM sous forme de valeur comprise entre `0` et `1`.
`jvm.mem.heapUsedInBytes`	La quantité de mémoire actuellement utilisée par le tas JVM, en octets.
`jvm.mem.maxOldGenerationHeapInBytes`	La quantité maximale de mémoire pouvant être utilisée par le tas d'ancienne génération, en octets.
`jvm.mem.maxSurvivorSpaceInBytes`	La quantité maximale de mémoire pouvant être utilisée par l'espace survivant, en octets.
`jvm.mem.maxYoungGenerationHeapInBytes`	La quantité maximale de mémoire pouvant être utilisée par le tas de jeune génération, en octets.
`jvm.mem.nonHeapCommittedInBytes`	La quantité de mémoire garantie comme étant disponible pour la JVM non-heap, en octets.
`jvm.mem.nonHeapUsedInBytes`	La quantité de mémoire actuellement utilisée par la JVM non-heap, en octets.
`jvm.mem.usedOldGenerationHeapInBytes`	La quantité de mémoire actuellement utilisée par le tas d'ancienne génération, en octets.
`jvm.mem.usedSurvivorSpaceInBytes`	La quantité de mémoire actuellement utilisée par l'espace survivant, en octets.
`jvm.mem.usedYoungGenerationHeapInBytes`	La quantité de mémoire actuellement utilisée par le tas de jeune génération, en octets.
`jvm.ThreadsActive`	Le nombre de threads actifs dans la JVM.
`jvm.ThreadsPeak`	Le nombre maximal de threads utilisés par la JVM.
`merges.currentActive`	Le nombre de fusions de segments actuellement actives.
`merges.docsSegmentsMerging`	Le nombre de documents répartis sur les segments actuellement en cours de fusion.
`merges.docsSegmentMerges`	Le nombre de documents dans tous les segments fusionnés.
`merges.mergedSegmentsInBytes`	La taille de tous les segments fusionnés, en octets.
`merges.segmentMerges`	Le nombre de fusions de segments.
`merges.sizeSegmentsMergingInBytes`	La taille des segments en cours de fusion, en octets.
`merges.totalSegmentMergingInMilliseconds`	Le temps consacré à la fusion des segments.
`openFD`	Le nombre de descripteurs de fichiers ouverts associés au processus en cours, ou`-1` si non pris en charge.
`queriesTotal`	Le nombre de requêtes.
`refresh.total`	Le nombre d'actualisations de l'index.
`refresh.totalInMilliseconds`	Le temps passé à actualiser l'index.
`searchFetchCurrentlyRunning`	Le nombre de recherches en cours d'exécution.
`searchFetches`	Le nombre de recherches effectuées.
`sizeStoreInBytes`	La taille du magasin, en octets.
`threadpool.bulk.Queue`	Le nombre de threads en file d'attente dans le pool en masse.
`threadpool.bulkActive`	Le nombre de threads actifs dans le pool en masse.
`threadpool.bulkRejected`	Le nombre de threads rejetés dans le pool en masse.
`threadpool.bulkThreads`	Le nombre de threads dans le pool en masse.
`threadpool.fetchShardStartedQueue`	Le nombre de threads en file d'attente dans le pool de récupération de fragments démarré.
`threadpool.fetchShardStartedRejected`	Le nombre de threads rejetés dans le pool de fragments de récupération démarré.
`threadpool.fetchShardStartedThreads`	Le nombre de threads dans le pool de fragments de récupération démarré.
`threadpool.fetchShardStoreActive`	Le nombre de threads actifs dans le pool de stockage de fragments de récupération.
`threadpool.fetchShardStoreQueue`	Le nombre de threads en file d'attente dans le pool de stockage de fragments de récupération.
`threadpool.fetchShardStoreRejected`	Le nombre de threads rejetés dans le pool de stockage de fragments de récupération.
`threadpool.fetchShardStoreThreads`	Le nombre de threads dans le pool de stockage de fragments de récupération.
`threadpool.flushActive`	Le nombre de threads actifs dans la file d'attente de vidage.
`threadpool.flushQueue`	Le nombre de threads en file d'attente dans le pool de vidage.
`threadpool.flushRejected`	Le nombre de threads rejetés dans le pool de vidage.
`threadpool.flushThreads`	Le nombre de threads dans le pool de vidage.
`threadpool.forceMergeActive`	Le nombre de threads actifs pour les opérations de fusion forcée.
`threadpool.forceMergeQueue`	Le nombre de threads en file d'attente pour les opérations de fusion forcée.
`threadpool.forceMergeRejected`	Le nombre de threads rejetés pour les opérations de fusion forcée.
`threadpool.forceMergeThreads`	Le nombre de threads pour les opérations de fusion forcée.
`threadpool.genericActive`	Le nombre de threads actifs dans le pool générique.
`threadpool.genericQueue`	Le nombre de threads en file d'attente dans le pool générique.
`threadpool.genericRejected`	Le nombre de threads rejetés dans le pool générique.
`threadpool.genericThreads`	Le nombre de threads dans le pool générique.
`threadpool.getActive`	Le nombre de threads actifs dans le pool d'obtention.
`threadpool.getQueue`	Le nombre de threads en file d'attente dans le pool d'obtention.
`threadpool.getRejected`	Le nombre de threads rejetés dans le pool d'obtention.
`threadpool.getThreads`	Le nombre de threads dans le pool d'obtention.
`threadpool.listenerActive`	Le nombre de threads actifs dans le pool d'écouteurs. (Obsolète sur Elasticsearch 8)
`threadpool.listenerQueue`	Le nombre de threads en file d'attente dans le pool d'écoute. (Obsolète sur Elasticsearch 8)
`threadpool.listenerRejected`	Le nombre de threads rejetés dans le pool d'écouteurs. (Obsolète sur Elasticsearch 8)
`threadpool.listenerThreads`	Le nombre de threads dans le pool d'écoute. (Obsolète sur Elasticsearch 8)
`threadpool.managementActive`	Le nombre de threads actifs dans le pool de gestion.
`threadpool.managementQueue`	Le nombre de threads en file d'attente dans le pool de gestion.
`threadpool.managementRejected`	Le nombre de threads rejetés dans le pool de gestion.
`threadpool.managementThreads`	Le nombre de threads dans le pool de gestion.
`threadpool.mergeActive`	Le nombre de threads actifs dans le pool de fusion.
`threadpool.mergeQueue`	Le nombre de threads en file d'attente dans le pool de fusion.
`threadpool.mergeRejected`	Le nombre de threads rejetés dans le pool de fusion.
`threadpool.mergeThreads`	Le nombre de threads dans le pool de fusion.
`threadpool.percolateActive`	Le nombre de threads actifs dans le pool de percolation.
`threadpool.percolateQueue`	Le nombre de threads en file d'attente dans le pool de percolation.
`threadpool.percolateRejected`	Le nombre de threads rejetés dans le pool de percolation.
`threadpool.percolateThreads`	Le nombre de threads dans le pool de percolation.
`threadpool.refreshActive`	Le nombre de threads actifs dans le pool d'actualisation.
`threadpool.refreshQueue`	Le nombre de threads en file d'attente dans le pool d'actualisation.
`threadpool.refreshRejected`	Le nombre de threads rejetés dans le pool d'actualisation.
`threadpool.refreshThreads`	Le nombre de threads dans le pool d'actualisation.
`threadpool.searchActive`	Le nombre de threads actifs dans le pool de recherche.
`threadpool.searchQueue`	Le nombre de threads en file d'attente dans le pool de recherche.
`threadpool.searchRejected`	Le nombre de threads rejetés dans le pool de recherche.
`threadpool.searchThreads`	Le nombre de threads dans le pool de recherche.
`threadpool.snapshotActive`	Le nombre de threads actifs dans le pool de snapshots.
`threadpool.snapshotQueue`	Le nombre de threads en file d’attente dans le pool de snapshots.
`threadpool.snapshotRejected`	Le nombre de threads rejetés dans le pool de snapshots.
`threadpool.snapshotThreads`	Le nombre de threads dans le pool de snapshots.
`threadpool.activeFetchShardStarted`	Le nombre de threads actifs dans le pool de fragments de récupération démarré.
`transport.connectionsOpened`	Le nombre de connexions ouvertes pour la communication du cluster.
`transport.packetsReceived`	Le nombre de paquets reçus dans la communication du cluster.
`transport.packetsReceivedInBytes`	La taille des données reçues dans la communication du cluster, en octets.
`transport.packetsSent`	Le nombre de paquets envoyés dans la communication du cluster.
`transport.packetsSentInBytes`	La taille des données envoyées dans la communication de cluster, en octets.

métrique	Description
`primaries.docsDeleted`	Le nombre de documents supprimés des fragments primaires.
`primaries.docsnumber`	Le nombre de documents dans les fragments primaires.
`primaries.flushesTotal`	Le nombre de vidages d'index sur le disque à partir des fragments primaires depuis le démarrage.
`primaries.flushTotalTimeInMilliseconds`	Le temps passé à vider l’index sur le disque à partir des fragments primaires.
`primaries.get.documentsExist`	Le nombre de requêtes GET sur les fragments primaires où le document existait.
`primaries.get.documentsExistInMilliseconds`	Le temps passé sur la requête GET à partir des fragments primaires où le document existait.
`primaries.get.documentsMissing`	Le nombre de requêtes GET provenant des fragments primaires où le document manquait.
`primaries.get.documentsMissingInMilliseconds`	Le temps passé sur la requête GET à partir des fragments primaires où le document manquait.
`primaries.get.requests`	Le nombre de requêtes GET provenant des fragments primaires.
`primaries.get.requestsCurrent`	Le nombre de requêtes GET actuellement en cours d'exécution sur les fragments primaires.
`primaries.get.requestsInMilliseconds`	Le temps passé sur la requête GET à partir des fragments primaires.
`primaries.index.docsCurrentlyDeleted`	Le nombre de documents actuellement supprimés d'un index sur les fragments primaires.
`primaries.index.docsCurrentlyDeletedInMilliseconds`	Le temps passé à supprimer des documents d’un index sur les fragments primaires.
`primaries.index.docsCurrentlyIndexing`	Le nombre de documents actuellement indexés sur un index sur les fragments primaires.
`primaries.index.docsCurrentlyIndexingInMilliseconds`	Le temps passé à indexer les documents dans un index sur les fragments primaires.
`primaries.index.docsDeleted`	Le nombre de documents supprimés d'un index sur les fragments primaires.
`primaries.index.docsTotal`	Le nombre de documents indexés sur un index sur les fragments primaires.
`primaries.indexRefreshesTotal`	Le nombre d’actualisations d’index sur les fragments primaires.
`primaries.indexRefreshesTotalInMilliseconds`	Le temps passé à actualiser l'index sur les fragments primaires.
`primaries.merges.current`	Le nombre de fusions de segments actuellement actives sur les fragments primaires.
`primaries.merges.docsSegmentsCurrentlyMerged`	Le nombre de documents répartis sur les segments actuellement en cours de fusion sur les fragments primaires.
`primaries.merges.docsTotal`	Le nombre de documents sur tous les segments fusionnés sur les fragments principaux.
`primaries.merges.SegmentsCurrentlyMergedInBytes`	La taille des segments en cours de fusion sur les fragments primaires, en octets.
`primaries.merges.SegmentsTotal`	Le nombre de fusions de segments sur les fragments primaires.
`primaries.merges.segmentsTotalInBytes`	La taille de tous les segments fusionnés sur les fragments primaires, en octets.
`primaries.merges.segmentsTotalInMilliseconds`	Le temps passé à la fusion des segments sur les fragments primaires.
`primaries.queriesInMilliseconds`	Le temps passé à interroger les fragments primaires.
`primaries.queriesTotal`	Le nombre de requêtes adressées aux fragments primaires.
`primaries.queryActive`	Le nombre de requêtes actuellement actives sur les fragments primaires.
`primaries.queryFetches`	Le nombre de requêtes récupérées actuellement en cours d'exécution sur les fragments principaux.
`primaries.queryFetchesInMilliseconds`	Le temps passé sur les requêtes de récupération sur les fragments primaires.
`primaries.queryFetchesTotal`	Le nombre de requêtes récupérées sur les fragments primaires.
`primaries.sizeInBytes`	La taille de tous les fragments primaires, en octets.

métrique	Description
`index.docs`	Le nombre de documents dans l'index.
`index.docsDeleted`	Le nombre de documents supprimés dans l'index.
`index.health`	L'état de l'index : `red`, `yellow` ou `green`.
`index.primaryShards`	Le nombre de fragments primaires dans l'index.
`index.primaryStoreSizeInBytes`	La taille du magasin de fragments primaires dans l'index.
`index.replicaShards`	Le nombre de fragments de réplique dans l'index.
`index.storeSizeInBytes`	La taille du magasin des fragments primaires et réplicas dans l'index, en octets.

L'intégration Elasticsearch est un logiciel open source. Cela signifie que vous pouvez parcourir son code source et envoyer des améliorations, ou créer votre propre fork et le construire.

Paramètres d'instance Elasticsearch

Vous pouvez utiliser la section env du fichier elasticsearch-config.yml pour définir des paramètres spécifiques liés à Elasticsearch. Ces paramètres contrôlent la connexion à votre Elasticsearch instance, ainsi que d'autres paramètres et fonctionnalités de sécurité.

L'intégration Elasticsearch collecte à la fois les informations Métriques et Inventaire. Dans le tableau, utilisez la colonne Applies to pour les paramètres disponibles pour chaque collection :

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

Paramètre	Description	Défaut	S'applique à
HOSTNAME	nom d'hôte ou IP où Elasticsearch s'exécute.	hôte local	MI
LOCAL_HOSTNAME	nom d'hôte ou IP du nœud Elasticsearch à partir duquel collecter les données d'inventaire. Ne doit être défini que si vous ne souhaitez pas collecter de données d'inventaire sur localhost.	hôte local	M
PORT	Port sur lequel Elasticsearch écoute.	9200	MI
USERNAME	Nom d'utilisateur pour accéder à Elasticsearch Node.	N/A	MI
PASSWORD	Mot de passe pour l'utilisateur donné.	N/A	MI
CLUSTER_ENVIRONMENT	Une façon de préciser davantage pour quel cluster nous collectons des données, par exemple : « simulation ».	N/A	MI
USE_SSL	Utilisez SSL lors de la communication avec le nœud Elasticsearch.	false	MI
CA_BUNDLE_FILE	Emplacement du certificat SSL sur l'hôte. Requis uniquement si `USE_SSL` est vrai.	N/A	MI
CA_BUNDLE_DIR	Répertoire de bundles d'autorités de certification alternatives.	N/A	MI
SSL_ALTERNATIVE_HOSTNAME	Nom d'hôte alternatif du serveur que l'intégration acceptera comme valide aux fins de négociation SSL.	N/A	MI
TLS_INSECURE_SKIP_VERIFY	Ignorer la vérification de la chaîne de certificat du serveur et du nom d'hôte.	false	MI
CONFIG_PATH	Chemin vers le fichier de configuration Elasticsearch.	/etc/elasticsearch/ elasticsearch.yml	je
TIMEOUT	Délai d'expiration requests API, en secondes.	30	MI
COLLECT_INDICES	Indique s'il faut collecter ou non les métriques d'indices.	vrai	M
COLLECT_PRIMARIES	Indique s'il faut collecter les métriques primaires ou non.	vrai	M
INDICES_REGEX	Filtrer les indices collectés.	N/A	M
MASTER_ONLY	Collectez les métriques de cluster sur le maître élu uniquement.	false	M
METRICS	Définissez sur `true` pour activer la collecte de métriques uniquement.	false
INVENTORY	Définissez sur `true` pour activer la collecte d'inventaire uniquement.	false

Les valeurs de ces paramètres peuvent être définies de plusieurs manières :

Ajout de la valeur directement dans le fichier de configuration. C'est la manière la plus courante.
Remplacement des valeurs des variables d’environnement à l’aide de la notation {{ }} . En savoir plus sur l'utilisation des passthroughs de variables d'environnement avec l'intégration sur hôte ou voir l'exemple de remplacement des variables d'environnement.
Important
Cela nécessite l'agent d'infrastructure v1.14.0+.
Utilisation de la gestion des secrets. Utilisez ceci pour protéger les informations sensibles, telles que les mots de passe qui seraient exposés en texte brut dans le fichier de configuration. Pour plus d'informations, voir gestion des secrets.

Libellés et attribut personnalisé

Vous pouvez également décorer vos métriques à l’aide d’étiquettes. Les étiquettes vous permettent d'ajouter une paire d'attributs valeur clé à vos métriques, que vous pouvez ensuite utiliser pour interroger, filtrer ou regrouper vos métriques.
Le fichier d'exemple de configuration de base elasticsearch-config.yml inclut l'utilisation d'étiquettes. Cependant, comme ils ne sont pas obligatoires, vous pouvez supprimer, modifier ou en ajouter de nouveaux de votre choix.

labels:
   env: production
   role: load_balancer

Données d'inventaire

L'intégration Elasticsearch capture les paramètres de configuration du nœud Elasticsearch, comme spécifié dans le fichier de configuration YAML. Il collecte également les informations de configuration du nœud à partir du point de terminaison \_nodes/\_local . Les données sont disponibles sur la page Inventaire des infrastructures, sous la source config/elasticsearch .

Pour en savoir plus sur les données d'inventaire, consultez comment comprendre les données d'intégration.

Cette traduction automatique est fournie pour votre commodité.

Compatibilité et exigences

Versions d'Elasticsearch

Système d'exploitation pris en charge

exigences système

Installer et activer l'intégration

Installation de Linux

Autres environnements

Ce document vous a-t-il aidé lors de votre installation ?

Configurer l'intégration

Important

Fichiers d'exemple elasticsearch-config.yml

Configuration de base

configuration de base avec différents intervalles métriques et d'inventaire

Remplacement des variables d'environnement

Cluster monitoring

Options de configuration pour l'intégration

Rechercher et utiliser des données

Métriques collectées par l'intégration

Événement ElasticsearchClusterSample

Événement ElasticsearchNodeSample

Événement ElasticsearchCommonSample

Événement ElasticsearchIndexSample

Paramètres d'instance Elasticsearch

Important

Libellés et attribut personnalisé

Données d'inventaire

Cette traduction automatique est fournie pour votre commodité.

Elasticsearch monitoring Intégration

Compatibilité et exigences .css-21sua1{background:none;border:none;width:0;padding:0;}

Versions d'Elasticsearch

Système d'exploitation pris en charge

exigences système

Installer et activer l'intégration

Installation de Linux

Autres environnements

Ce document vous a-t-il aidé lors de votre installation ?

Configurer l'intégration

Important

Fichiers d'exemple elasticsearch-config.yml

Configuration de base

configuration de base avec différents intervalles métriques et d'inventaire

Remplacement des variables d'environnement

Cluster monitoring

Options de configuration pour l'intégration

Rechercher et utiliser des données

Métriques collectées par l'intégration

Événement ElasticsearchClusterSample

Événement ElasticsearchNodeSample

Événement ElasticsearchCommonSample

Événement ElasticsearchIndexSample

Paramètres d'instance Elasticsearch

Important

Libellés et attribut personnalisé

Données d'inventaire

Compatibilité et exigences