« Que vous débutiez avec Elasticsearch ou que vous soyez un professionnel chevronné, vous rencontrerez des cas où vous devrez récupérer des informations d'état sur le cluster Elasticsearch.
Vous pouvez ensuite utiliser les informations pour déterminer l'intégrité du cluster et effectuer un diagnostic ou un débogage pour divers problèmes.
Cet article découvrira comment vous pouvez récupérer les informations sur l'état du cluster en plusieurs étapes simples. »
API d'état du cluster Elasticsearch
Elasticsearch utilise largement l'API reposante. Par conséquent, il n'est pas surprenant qu'il fournisse un point de terminaison d'API pour récupérer les informations sur l'état du cluster.
La syntaxe du point de terminaison est la suivante :
OBTENIR / _groupe / Etat /< métrique >/< cible >
L'API accepte les paramètres de chemin suivants :
- métriques - cela spécifie une liste d'options à récupérer à partir du cluster. C'est un paramètre optionnel. Les options acceptées incluent
- _all – affiche toutes les métriques du cluster.
- blocs - affiche uniquement les blocs de la réponse.
- master_node - récupère uniquement la partie nœud maître.
- metadata – affiche uniquement les métadonnées.
- nodes – affiche uniquement les nœuds.
- routing_nodes – affiche les nœuds de routage.
- routing_table – affiche uniquement la routing_table.
- version – affiche la version du cluster.
- cible - spécifie une liste de flux de données, d'index et d'alias sous forme de valeurs séparées par des virgules. C'est un paramètre optionnel.
Les autres paramètres pris en charge dans la requête incluent :
- local – récupère les informations du cluster uniquement à partir du nœud local.
- expand_wildcards – spécifie s'il faut développer les expressions génériques.
- ignore_unavailable – si vrai, les index indisponibles sont ignorés.
Découvrez la documentation pour en savoir plus sur cette API, ce paramètre de requête, etc.
Exemple 1
L'exemple suivant renvoie toutes les informations sur l'état du cluster.
boucle -XGET 'http://localhost:9200/_cluster/state/_all?pretty=true' -H 'kbn-xsrf : création de rapports'
Les informations résultantes sur l'état du cluster sont les suivantes :
Exemple 2
L'exemple ci-dessous montre les métadonnées de la table de routage pour l'index 6IoKfqY1TredUYfi5DL7PA :
boucle -XGET 'http://localhost:9200/_cluster/state/metadata,routing_table/6IoKfqY1TredUYfi5DL7PA' -H 'kbn-xsrf : création de rapports'
La requête renverra les métadonnées et la table de routage de l'index spécifié comme indiqué :
Exemple 3
Pour récupérer la version du cluster, exécutez :
boucle -XGET 'http://localhost:9200/_cluster/state/version?pretty' -H 'kbn-xsrf : création de rapports'
L'exemple ci-dessus renverra la version du cluster comme indiqué :
'nom_cluster' : '776a462b8a1942bfb8ba46decf49ca8c' ,
'cluster_uuid' : '6IoKfqY1TredUYfi5DL7PA' ,
'version' : 1144 ,
'état_uuid' : '_efEiXwzTwyaBrezYDJ2sA'
}
Exemple 4
Pour récupérer l'état du cluster dans le nœud local uniquement, exécutez :
boucle -XGET 'http://localhost:9200/_cluster/state/_all?local=true' -H 'kbn-xsrf : création de rapports'
Dans ce cas, la requête renvoie des informations du nœud local au lieu du nœud maître.
Production:
Conclusion
Dans cet article, vous avez découvert l'API d'état du cluster. Cette API vous permet de récupérer des informations sur le cluster à partir du nœud maître ou local.
Merci d'avoir lu.