In dit artikel wordt onderzocht hoe we de gedetailleerde beschrijving kunnen ophalen van elke scherf die deelneemt aan een bepaalde momentopname.
Om de status van een bepaalde momentopname in Elasticsearch op te halen, gebruiken we het Get snapshot status API-eindpunt.
Syntaxis aanvragen
De syntaxis van het verzoek is als volgt:
GET _snapshot / _toestand
GET _snapshot /< opslagplaats >/ _toestand
GET _snapshot /< opslagplaats >/< momentopname >/ _toestand
De aanvraag ondersteunt de volgende padparameters:
-
– De naam van de snapshot-repository. Dit is erg handig om de reikwijdte van het verzoek te beperken tot een bepaalde repository in plaats van de systeembrede query. -
– Specificeert de naam van een doel-snapshot. U kunt de meerdere snapshots ook specificeren als een door komma's gescheiden lijst.
We kunnen de momentopname in de verzoekparameter weglaten om informatie over de momenteel actieve momentopnamen op te halen.
Reactietekst
Het verzoek moet gedetailleerde informatie over de momentopname retourneren. Dergelijke informatie die in het antwoord is opgenomen, is:
- Opslagplaats – De naam van de repository waarin de snapshot zich bevindt.
- Momentopname – De naam van de momentopname.
- uuid – UUID van de momentopname.
- Staat – De huidige status van de momentopname. De momentopname kan de volgende statussen hebben:
- Inclusief_globale_staat – Geeft aan of de globale clusterstatus is opgenomen in de opgegeven momentopname.
- Shard_stats – Toont het aantal scherven.
- Statistieken – Details over het aantal bestanden en de grootte van de bestanden in de snapshot.
a. MISLUKT – De momentopname die is voltooid met een fout en de back-upgegevens niet kan herstellen.
b. BEGONNEN – Geeft aan dat de momentopname momenteel wordt uitgevoerd.
c. GEDEELTELIJK – Geeft aan dat de globale clusterstatus is hersteld, maar dat de gegevens van ten minste één shard niet zijn opgeslagen.
d. SUCCES – Geeft aan dat de snapshot met succes is voltooid.
Dat zijn enkele van de informatie die wordt geretourneerd door de status van de momentopname.
Elasticsearch Momentopname maken
Laten we een voorbeeldmomentopname maken om het beste te illustreren hoe u de Elasticsearch Get snapshot-API kunt gebruiken. Houd er rekening mee dat deze sectie niet de basis behandelt van het maken van een Elasticsearch-repository of andere vereisten voor een Elasticsearch-snapshot.
Raadpleeg de documentatie voor meer informatie.
Stel dat we een repository hebben met de naam elk_bakcups, dan kunnen we een snapshot in die repository maken met het verzoek zoals hieronder weergegeven:
krullen -XPUT 'http://localhost:9200/_snapshot/elk_backups/test_snapshot?wait_for_completion=true' -H 'kbn-xsrf: rapportage'De vorige aanvraag initialiseert het maken van de momentopname in de opgegeven repository.
OPMERKING : De tijd die nodig is om het maken van de momentopname te voltooien, is afhankelijk van een aantal factoren.
Elasticsearch Snapshot-status ophalen
Nadat we het proces voor het maken van snapshots hebben geïnitialiseerd, kunnen we de status ervan controleren door de volgende query uit te voeren:
krullen -XGET 'http://localhost:9200/_snapshot/elk_backups/test_snapshot/_status' -H 'kbn-xsrf: rapportage'Dit zou gedetailleerde informatie over de status van de momentopname moeten retourneren. Een voorbeelduitvoer ziet er als volgt uit:
{'momentopnamen' : [
{
'momentopname' : 'test_snapshot' ,
'opslagplaats' : 'elk_backups' , < krachtig >
krachtig > 'uuid' : '9oOJtTunR_WC-1a7NA-9WQ' ,
'staat' : 'SUCCES' ,
'include_global_state' : WAAR ,
'scherven_stats' : {
'initialiseren' : 0 ,
'begonnen' : 0 ,
'afronden' : 0 ,
'gedaan' : 94 ,
'mislukt' : 0 ,
'totaal' : 94
} ,
'statistieken' : {
'toenemend' : {
'bestand_aantal' : 282 ,
'grootte_in_bytes' : 750304
} ,
'totaal' : {
'bestand_aantal' : 692 ,
'grootte_in_bytes' : 62159894
} ,
'start_time_in_millis' : 1663770043239 ,
'time_in_millis' : 26212
} ,
'indexen' : { < krachtig >
krachtig > 'mijn-gegevensstroom' : {
'scherven_stats' : {
'initialiseren' : 0 ,
'begonnen' : 0 ,
'afronden' : 0 ,
'gedaan' : 1 ,
'mislukt' : 0 ,
'totaal' : 1
} ,
'statistieken' : {
'toenemend' : {
'bestand_aantal' : 0 ,
'grootte_in_bytes' : 0
} ,
'totaal' : {
'bestand_aantal' : 10 ,
'grootte_in_bytes' : 13518
} ,
-----------------UITGANG AFGEKORT ------------------------
In Kibana kunt u de status van de momentopname controleren door naar het gedeelte Stapelbeheer – Momentopname en herstellen te gaan.
Selecteer de doelsnapshot en bekijk de details.
OPMERKING : Houd er rekening mee dat Kibana geen uitgebreide details biedt zoals geleverd door de Elasticsearch get snapshot-status-API.
Conclusie
In dit bericht hebben we de basisprincipes van het werken met de get snapshot-status-API onderzocht, waarmee we gedetailleerde informatie over een bepaalde momentopname kunnen ophalen.
Bedankt voor het lezen!