Cet article explore comment nous pouvons récupérer la description détaillée de chaque fragment participant à un instantané donné.
Pour récupérer le statut d'un instantané donné dans Elasticsearch, nous utilisons le point de terminaison de l'API Get snapshot status.
Syntaxe de la requête
La syntaxe de la requête est la suivante :
OBTENIR _instantané / _statut
OBTENIR _instantané /< dépôt >/ _statut
OBTENIR _instantané /< dépôt >/< instantané >/ _statut
La requête prend en charge les paramètres de chemin suivants :
-
– Le nom du référentiel d'instantanés. Ceci est très utile pour limiter la portée de la requête à un référentiel donné au lieu de la requête à l'échelle du système. -
– Spécifie le nom d'un instantané cible. Vous pouvez également spécifier les multiples instantanés sous forme de liste séparée par des virgules.
Nous pouvons omettre l'instantané dans le paramètre de requête pour récupérer des informations sur les instantanés en cours d'exécution.
Corps de la réponse
La requête doit renvoyer des informations détaillées sur l'instantané. Ces informations incluses dans la réponse sont :
- Dépôt – Le nom du référentiel dans lequel réside l'instantané.
- Instantané – Le nom de l'instantané.
- uuid – UUID de l'instantané.
- État – L'état actuel de l'instantané. L'instantané peut être dans les états suivants :
- Inclure_état_global – Indique si l'état global du cluster est inclus dans l'instantané spécifié.
- Shard_stats - Affiche le nombre de fragments.
- Statistiques – Détails sur le nombre de fichiers et la taille des fichiers dans l'instantané.
un. MANQUÉ – L'instantané qui se termine avec une erreur et ne parvient pas à restaurer les données sauvegardées.
b. A DÉBUTÉ – Indique que l'instantané est en cours d'exécution.
c. PARTIEL – Indique que l'état global du cluster est restauré mais que les données d'au moins une partition n'ont pas pu être stockées correctement.
ré. SUCCÈS – Indique que l'instantané s'est terminé avec succès.
Ce sont quelques-unes des informations renvoyées par l'état de l'instantané.
Elasticsearch Créer un instantané
Pour mieux illustrer comment utiliser l'API Elasticsearch Get snapshot, créons un exemple d'instantané. Gardez à l'esprit que cette section ne couvre pas les bases de la création d'un référentiel Elasticsearch ou d'autres exigences pour un instantané Elasticsearch.
Consultez la documentation pour en savoir plus.
Supposons que nous ayons un référentiel appelé elk_bakcups, nous pouvons créer un instantané dans ce référentiel avec la requête comme indiqué ci-dessous :
boucle -XPUT 'http://localhost:9200/_snapshot/elk_backups/test_snapshot?wait_for_completion=true' -H 'kbn-xsrf : création de rapports'La requête précédente initialise la création de l'instantané dans le référentiel spécifié.
REMARQUE : Le temps nécessaire à la création de l'instantané dépend d'un certain nombre de facteurs.
Elasticsearch Obtenir le statut de l'instantané
Une fois que nous avons initialisé le processus de création d'instantané, nous pouvons vérifier son statut en exécutant la requête suivante :
boucle -XGET 'http://localhost:9200/_snapshot/elk_backups/test_snapshot/_status' -H 'kbn-xsrf : création de rapports'Cela devrait renvoyer des informations détaillées sur l'état de l'instantané. Un exemple de sortie est illustré ci-dessous :
{'instantanés' : [
{
'instantané' : 'test_instantané' ,
'dépôt' : 'chaque_sauvegardes' , < fort >
fort > 'uuid' : '9oOJtTunR_WC-1a7NA-9WQ' ,
'Etat' : 'SUCCÈS' ,
'include_global_state' : vrai ,
'shards_stats' : {
'initialisation' : 0 ,
'a débuté' : 0 ,
'finaliser' : 0 ,
'Fini' : 94 ,
'manqué' : 0 ,
'total' : 94
} ,
'Statistiques' : {
'incrémentale' : {
'file_count' : 282 ,
'taille_en_octets' : 750304
} ,
'total' : {
'file_count' : 692 ,
'taille_en_octets' : 62159894
} ,
'start_time_in_millis' : 1663770043239 ,
'temps_en_millis' : 26212
} ,
'indices' : { < fort >
fort > 'mon-flux de données' : {
'shards_stats' : {
'initialisation' : 0 ,
'a débuté' : 0 ,
'finaliser' : 0 ,
'Fini' : 1 ,
'manqué' : 0 ,
'total' : 1
} ,
'Statistiques' : {
'incrémentale' : {
'file_count' : 0 ,
'taille_en_octets' : 0
} ,
'total' : {
'file_count' : dix ,
'taille_en_octets' : 13518
} ,
-----------------PRODUCTION TRONQUÉ------------------------
Dans Kibana, vous pouvez vérifier l'état de l'instantané en accédant à la section Stack Management - Snapshot and Restore.
Sélectionnez l'instantané cible et affichez les détails.
REMARQUE : Gardez à l'esprit que Kibana ne fournit pas les détails complets fournis par l'API Elasticsearch Get Snapshot Status.
Conclusion
Dans cet article, nous avons exploré les principes fondamentaux de l'utilisation de l'API get snapshot status qui nous permet de récupérer des informations détaillées sur un instantané donné.
Merci d'avoir lu!