Tous les produits
Search
Centre de documentation

Elasticsearch:Use commands to check cluster health status

Dernière mise à jour :Aug 09, 2026

Exécutez des commandes dans la console Dev Tools de Kibana pour vérifier l'état de santé du cluster, la charge des nœuds, l'allocation des shards et les informations relatives aux index, afin d'assurer une surveillance régulière et un dépannage efficace.

Prérequis

Vous devez disposer d'une instance Alibaba Cloud Elasticsearch. Pour plus d'informations, consultez la rubrique Créer un cluster Alibaba Cloud Elasticsearch.

Procédure

  1. Connectez-vous à la console Kibana de votre cluster Elasticsearch.

    Pour obtenir des instructions détaillées, consultez la rubrique Se connecter à la console Kibana. Toutes les commandes présentées dans cette rubrique s'exécutent dans la console Dev Tools.

  2. Dans le volet de navigation de gauche, cliquez sur Dev Tools.

  3. Dans la zone Console, exécutez la commande suivante pour vérifier l'état de santé du cluster.

    GET /_cluster/health

    Une requête aboutie renvoie la réponse suivante :

    {
      "cluster_name" : "es-cn-45xxxxxxxxxxxxk1q",
      "status" : "green",
      "timed_out" : false,
      "number_of_nodes" : 2,
      "number_of_data_nodes" : 2,
      "active_primary_shards" : 18,
      "active_shards" : 36,
      "relocating_shards" : 0,
      "initializing_shards" : 0,
      "unassigned_shards" : 0,
      "delayed_unassigned_shards" : 0,
      "number_of_pending_tasks" : 0,
      "number_of_in_flight_fetch" : 0,
      "task_max_waiting_in_queue_millis" : 0,
      "active_shards_percent_as_number" : 100.0
    }

    Le champ status indique l'état de santé du cluster. Les valeurs possibles sont green, yellow et red.

    Status

    State

    Description

    red

    Tous les shards primaires ne sont pas disponibles.

    Un ou plusieurs shards primaires ne sont pas assignés.

    yellow

    Tous les shards primaires sont disponibles, mais tous les shards réplica ne le sont pas.

    Un ou plusieurs shards réplica ne sont pas assignés.

    green

    Tous les shards primaires et réplica sont disponibles.

    Tous les shards primaires et réplica sont assignés.

    Un état de cluster yellow peut ralentir considérablement certaines opérations, telles que la modification du mot de passe ou la mise à niveau de l'instance. Avant d'effectuer ces opérations, rétablissez l'état green de votre cluster. Une cause fréquente de l'état yellow est que le nombre de réplicas d'un index est supérieur au nombre de nœuds disponibles moins un. Pour résoudre ce problème, suivez ces étapes :

    • Identifiez les index dont l'état est yellow :

      curl -u <username>:<password> http://<host>:9200/_cat/indices
    • Ajustez le nombre de réplicas pour l'index concerné en définissant la valeur au nombre de nœuds disponibles moins un.

      curl -XPUT -u <username>:<password> http://<host>:9200/<problematic_index_name>/_settings -H 'Content-Type: application/json' -d '{"index":{"number_of_replicas":(<number_of_nodes - 1>)}'
      Remarque

      Après le redémarrage ou la mise à l'échelle d'une instance, ajustez le nombre de réplicas de vos index pour qu'il corresponde au nouveau nombre de nœuds.

Commandes de cluster

Command

Description

GET /_cat/health?v

Renvoie l'état de santé du cluster (green, yellow ou red). Pour les descriptions des états, consultez le tableau ci-dessus.

GET /_cluster/health?pretty=true

Renvoie l'état de santé du cluster. Le paramètre pretty=true met en forme la sortie JSON pour une meilleure lisibilité. Vous pouvez également ajouter d'autres paramètres de requête, tels que :

  • level=indices : affiche l'état de chaque index.

  • level=shards : affiche les informations relatives aux shards.

GET /_cluster/stats

Renvoie les statistiques du cluster, y compris les informations sur le CPU et la JVM.

GET /_cluster/state

Renvoie des informations détaillées sur l'état du cluster, y compris les nœuds et les shards.

GET /_cluster/pending_tasks

Renvoie les tâches en attente dans le cluster.

GET /_cluster/settings

Renvoie les paramètres globaux du cluster.

Commandes de nœud

Command

Description

GET /_cat/master?v

Renvoie des informations sur le nœud maître.

GET /_cat/nodes?v

Renvoie l'état actuel de chaque nœud, y compris l'utilisation du CPU, l'utilisation de la mémoire heap et la charge.

GET /_cat/nodeattrs?v

Renvoie les attributs personnalisés de chaque nœud.

GET /_nodes/stats?pretty=true

Renvoie les statistiques des nœuds.

GET /_nodes/process

Renvoie les informations de processus pour les nœuds.

GET /_nodes/hot_threads

Renvoie les tâches qui consomment une quantité élevée de CPU.

GET /_nodes/<nodeip>/jvm,process,os

Renvoie les informations JVM, de processus et du système d'exploitation (OS) pour un nœud spécifié.

GET /_cat/plugins?v

Renvoie les plugins installés sur chaque nœud.

GET /_cat/thread_pool?v

Renvoie les statistiques du pool de threads pour chaque nœud, y compris le type de pool de threads, le nombre de threads actifs et la taille de la file d'attente.

Commandes de shard

Command

Description

GET /_cat/shards?v

Renvoie des informations détaillées sur chaque shard, telles que le nom de l'index, l'ID du shard, le type (primaire ou réplica), l'état, le nombre de documents et l'utilisation du disque. La sortie inclut la raison de l'échec pour tout shard ayant échoué. Pour afficher les informations de shard pour un index spécifique, exécutez GET _cat/shards/<index>?v.

GET /_cat/allocation?v

Renvoie l'allocation des shards pour chaque nœud.

GET /_cat/recovery?v

Renvoie la progression de la récupération pour chaque shard.

Commandes de segment

GET /_cat/segments?v

Renvoie les informations de segment pour chaque index, telles que le nom du segment, le shard auquel il appartient, l'utilisation de la mémoire ou du disque, et s'il a été vidé sur le disque. Vous pouvez également afficher les informations de segment pour un index spécifique en exécutant GET _cat/segments/<index>?v.

Commandes d'index

Command

Description

GET /_cat/indices?v

Renvoie des informations détaillées pour tous les index, y compris l'état de santé, l'état, le nombre de shards et de réplicas, et le nombre de documents. Pour afficher les informations d'un index spécifique, exécutez GET _cat/indices/<index>?v.

GET /_cat/aliases?v

Renvoie des informations sur tous les alias d'index, y compris les index vers lesquels ils pointent et leurs configurations de routage.

Commandes de mapping

Command

Description

GET /_mapping

Renvoie les mappings pour tous les index.

GET /<index>/_mapping

Renvoie le mapping pour un index spécifique.

Commandes de document

Command

Description

GET /_cat/count?v

Renvoie le nombre total de documents dans le cluster. Pour afficher le nombre pour un index spécifique, exécutez GET _cat/count/<index>?v.

GET /<index>/_doc/<id>

Récupère les données d'un document spécifique.

Commandes de snapshot

Command

Description

GET _snapshot/_all

Renvoie tous les snapshots.

GET _snapshot/<snapshot_name>/_status

Renvoie la progression d'un snapshot spécifié.