Aquest article explora com podem obtenir la descripció detallada de cada fragment que participa en una instantània determinada.
Per obtenir l'estat d'una instantània determinada a Elasticsearch, utilitzem el punt final de l'API Get snapshot status.
Sintaxi de la sol·licitud
La sintaxi de la sol·licitud és la que es mostra a continuació:
OBTENIR _ instantània / _estat
OBTENIR _ instantània /< repositori >/ _estat
OBTENIR _ instantània /< repositori >/< instantània >/ _estat
La sol·licitud admet els paràmetres de ruta següents:
-
– El nom del repositori d'instantànies. Això és molt útil per limitar l'abast de la sol·licitud a un repositori determinat en lloc de la consulta a tot el sistema. -
– Especifica el nom d'una instantània de destinació. També podeu especificar les diverses instantànies com a llista separada per comes.
Podem ometre la instantània al paràmetre de sol·licitud per obtenir informació sobre les instantànies que s'executen actualment.
Cos de resposta
La sol·licitud hauria de retornar una informació detallada sobre la instantània. Aquesta informació inclosa a la resposta és:
- Repositori – El nom del repositori on resideix la instantània.
- Instantània – El nom de la instantània.
- uuid – UUID de la instantània.
- Estat – L'estat actual de la instantània. La instantània pot estar en els estats següents:
- Inclou_estat_global – Indica si l'estat global del clúster s'inclou a la instantània especificada.
- Shard_stats – Mostra el recompte dels fragments.
- Estadístiques – Detalls sobre el nombre de fitxers i la mida dels fitxers de la instantània.
a. FRACASSAT – La instantània que s'ha acabat amb un error i no s'ha pogut restaurar les dades de la qual s'ha fet una còpia de seguretat.
b. COMENÇAT – Indica que la instantània s'està executant actualment.
c. PARCIAL – Mostra que s'ha restaurat l'estat global del clúster però que les dades d'almenys un fragment no s'han pogut emmagatzemar correctament.
d. ÈXIT – Indica que la instantània s'ha acabat correctament.
Aquestes són algunes de la informació que es retorna de l'estat de la instantània.
Elasticsearch Crea una instantània
Per il·lustrar millor com utilitzar l'API d'Elasticsearch Get snapshot, creem una instantània de mostra. Tingueu en compte que aquesta secció no cobreix els conceptes bàsics per crear un dipòsit d'Elasticsearch ni altres requisits per a una instantània d'Elasticsearch.
Consulteu la documentació per obtenir més informació.
Suposem que tenim un dipòsit anomenat elk_bakcups, podem crear una instantània en aquest dipòsit amb la sol·licitud tal com es mostra a continuació:
rínxol -XPUT 'http://localhost:9200/_snapshot/elk_backups/test_snapshot?wait_for_completion=true' -H 'kbn-xsrf: informes'La sol·licitud anterior inicialitza la creació de la instantània al repositori especificat.
NOTA : el temps necessari perquè es completi la creació de la instantània depèn d'una sèrie de factors.
Elasticsearch Obteniu l'estat de la instantània
Un cop inicialitzem el procés de creació de la instantània, podem comprovar-ne l'estat executant la consulta següent:
rínxol -XGET 'http://localhost:9200/_snapshot/elk_backups/test_snapshot/_status' -H 'kbn-xsrf: informes'Això hauria de retornar una informació detallada sobre l'estat de la instantània. Un exemple de sortida és el que es mostra a continuació:
{'instantània' : [
{
'instantània' : 'prova_instantània' ,
'repositori' : 'cada_còpia de seguretat' , < fort >
fort > 'uuid' : '9oOJtTunR_WC-1a7NA-9WQ' ,
'estat' : 'ÈXIT' ,
'inclou_estat_global' : veritat ,
'shards_stats' : {
'inicialitzant' : 0 ,
'va començar' : 0 ,
'finalitzar' : 0 ,
'fet' : 94 ,
'fracassat' : 0 ,
'total' : 94
} ,
'estadístiques' : {
'incremental' : {
'nombre_fitxers' : 282 ,
'mida_en_bytes' : 750304
} ,
'total' : {
'nombre_fitxers' : 692 ,
'mida_en_bytes' : 62159894
} ,
'hora_inici_en_millis' : 1663770043239 ,
'temps_en_millis' : 26212
} ,
'índexs' : { < fort >
fort > 'el meu flux de dades' : {
'shards_stats' : {
'inicialitzant' : 0 ,
'va començar' : 0 ,
'finalitzar' : 0 ,
'fet' : 1 ,
'fracassat' : 0 ,
'total' : 1
} ,
'estadístiques' : {
'incremental' : {
'nombre_fitxers' : 0 ,
'mida_en_bytes' : 0
} ,
'total' : {
'nombre_fitxers' : 10 ,
'mida_en_bytes' : 13518
} ,
-----------------SORTIDA TRUNCAT-------------------------
A Kibana, podeu comprovar l'estat de la instantània navegant a la secció Stack Management - Snapshot and Restore.
Seleccioneu la instantània de destinació i visualitzeu-ne els detalls.
NOTA : Tingueu en compte que Kibana no proporciona detalls complets tal com els proporciona l'API d'estat de la instantània d'Elasticsearch.
Conclusió
En aquesta publicació, hem explorat els fonaments de treballar amb l'API get snapshot status que ens permet obtenir una informació detallada sobre una instantània determinada.
Gràcies per llegir!