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
-
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.
Dans le volet de navigation de gauche, cliquez sur Dev Tools.
-
Dans la zone Console, exécutez la commande suivante pour vérifier l'état de santé du cluster.
GET /_cluster/healthUne 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
statusindique l'état de santé du cluster. Les valeurs possibles sontgreen,yellowetred.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
yellowpeut 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'étatgreende votre cluster. Une cause fréquente de l'étatyellowest 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>)}'RemarqueAprè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
|
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/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/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 /<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é. |