Phenquestions
Wat is Elasticsearch??
Elasticsearch is een gratis en open source zoek- en analyse-engine die wordt gebruikt voor het verzamelen, beheren en analyseren van gegevens.
Elasticsearch is een uitgebreide tool die Apache Lucene gebruikt om tekst, numerieke, gestructureerde en ongestructureerde geospatiale gegevens te verwerken. Elasticsearch gebruikt een eenvoudige en zeer krachtige REST API waarmee gebruikers deze kunnen configureren en beheren. In combinatie met andere tools zoals Kibana en Logstash, is het een van de meest populaire realtime- en gegevensanalyse-engines.
Zodra gegevens zijn verzameld uit bronnen zoals systeemlogboeken, statistieken, applicatiegegevens, enz., het wordt toegevoegd aan Elasticsearch en geïndexeerd, zodat u complexe gegevensquery's kunt uitvoeren en samenvattingen en informatieve dashboards kunt maken met behulp van visualisatietools zoals Kibana.
Wat is Elasticsearch-index??
Laten we het hebben over een van de belangrijkste dingen over Elastic, nadat we hebben uitgelegd wat Elasticsearch is: een index.
In Elasticsearch verwijst een index naar een verzameling nauw verwante documenten in de vorm van JSON-gegevens. De JSON-gegevens correleren de sleutels met bijbehorende waarden met hun sleutels.
Hier is een voorbeeld van een JSON-document:
"@timestamp": "2099-11-15T13:12:00",
"message": "GET /search HTTP/1.1 200 1070000",
"gebruiker":
"id": "json_doc"
Elasticsearch-indexen hebben de vorm van een omgekeerde index, die Elasticsearch doorzoekt met volledige tekst full. Een omgekeerde index werkt door alle unieke woorden in elk Elasticsearch-document op te sommen en komt nauwkeurig overeen met het document waarin het woord voorkomt.
De functie voor omgekeerde indexering van Elasticsearch maakt ook realtime zoeken mogelijk en kan worden bijgewerkt met behulp van de Elasticsearch-indexerings-API.
Een indexalias maken
Elasticsearch stelt zijn diensten en functionaliteit bloot met behulp van een zeer krachtige REST API. Met behulp van deze API kunnen we een alias maken voor een Elasticsearch-index.
Wat is een Index-alias?
Een Elastisearch-indexalias is een secundaire naam of identificatie die we kunnen gebruiken om naar een of meer indices te verwijzen.
Nadat u een indexalias hebt gemaakt, kunt u naar de index of indices verwijzen in Elasticsearch-API's.
Een voorbeeld van een geschikte index zijn indices die systeemlogboeken voor apache opslaan. Als u regelmatig apache-logboeken opvraagt, kunt u een alias voor apache_logs maken en die specifieke index opvragen en bijwerken.
Om een alias voor een bepaalde index te maken, gebruiken we het PUT-verzoek gevolgd door het pad van de index en de alias om.
In REST gebruiken we een PUT-methode om de doorgegeven entiteit of waarde op te vragen om te worden opgeslagen op de verzoek-URL. Simpel gezegd, met een HTTP PUT-methode kunt u informatie over een bron bijwerken of een nieuw item maken als er geen is.
Voor deze tutorial ga ik ervan uit dat Elasticsearch is geïnstalleerd en dat je een API-client of een tool hebt om HTTP-verzoeken zoals cURL te verzenden.
Laten we beginnen met het maken van een eenvoudige index zonder alias of parameters.
Voor de eenvoud gebruiken we cURL omdat we aannemen dat je Elasticsearch alleen zonder Kibana hebt geïnstalleerd installed. Als je echter Kibana hebt geïnstalleerd of fouten tegenkomt bij het gebruik van curl, overweeg dan om de Kibana-console te gebruiken, omdat deze beter geschikt is voor Elasticsearch API-verzoeken.
curl -X PUT "localhost:9200/my_index"?mooi"Deze opdracht maakt een eenvoudige index met standaardinstellingen en geeft het volgende terug:.
“erkend”: waar,
"shards_acknowledged": waar,
"index": "mijn_index"
Nu we een index hebben in Elasticsearch, kunnen we een alias maken met hetzelfde PUT-verzoek als:
PUT localhost:9200/my_index/_alias/my_alias_1We beginnen met het specificeren van de methode, in dit geval een PUT gevolgd door de URL van de index waaraan we een alias willen toevoegen. De volgende is de API die we willen gebruiken, in dit geval de Index Alias API (_alias) gevolgd door de naam van de alias die we aan de index willen toewijzen.
Hier is het cURL-commando daarvoor:
curl -X PUT "localhost:9200/my_index/_alias/my_alias_1?mooi"Deze opdracht moet reageren met de 200 OK-status en "bevestigd":
“erkend”: waar
U kunt ook een methode tegenkomen om een alias aan een index toe te voegen als:
curl -X POST "localhost:9200/_aliases?pretty" -H 'Inhoudstype: application/json' -d'"acties" : [
"add" : "index" : "my_index", "alias" : "my_alias_1"
]
Met behulp van Elasticsearch index alias API kunt u naar eigen inzicht indexaliassen toevoegen, bijwerken en verwijderen.
Hoe u Index Alias Info kunt krijgen
Wanneer u geavanceerde aliassen maakt, zoals aliassen die zijn gefilterd op een specifieke gebruiker, wilt u misschien informatie over de index krijgen. U kunt de informatie met behulp van de GET-methode als volgt bekijken:
GET /mijn_index/_alias/mijn_alias_1Hier is het cURL-commando:
curl -X GET "localhost:9200/my_index/_alias/my_alias_1"?mooi"Met deze opdracht wordt de informatie over de alias weergegeven. Aangezien we geen informatie hebben toegevoegd, zal het er meestal op lijken:.
"mijn_index":
"aliassen":
"mijn_alias_1":
Zorg ervoor dat de alias bestaat om te voorkomen dat u een 404-fout krijgt, zoals hieronder wordt weergegeven:
curl -X GET “localhost:9200/my_index/_alias/does_not_exist?mooi"Het resultaat is een "alias bestaat niet of ontbreekt" als:
"error": "alias [does_not_exist] ontbreekt",
"status": 404
Een indexalias verwijderen
Om een bestaande alias uit een index te verwijderen, gebruiken we de methode die we hebben gebruikt om een alias toe te voegen, maar in plaats daarvan met een DELETE-verzoek. Bijvoorbeeld:
localhost:9200/mijn_index/_alias/mijn_alias_1Het equivalente cURL-commando is:
curl -X DELETE "localhost:9200/my_index /_alias/my_alias_1?mooi"Elasticsearch zou moeten antwoorden met 200 OK en bevestigd: waar
“erkend”: waar
Er zijn andere manieren om aliassen bij te werken en te verwijderen uit een index in Elasticsearch. Voor de eenvoud hebben we het echter bij één verzoek gehouden.
Conclusie
In deze eenvoudige zelfstudie hebben we gekeken naar het maken van een Elasticsearch-index en vervolgens een alias. We hebben ook besproken hoe u een alias verwijdert.
Het is vermeldenswaard dat deze gids niet de meest definitieve ter wereld is; het doel was om te dienen als een startersgids voor het maken van Elasticsearch, niet als een uitgebreide gids.
Als u meer wilt weten over de Elastic Index API, bekijk dan de onderstaande bronnen:.
We raden ook aan om basiskennis te hebben van het werken met Elasticsearch en API; het zal een grote hulp zijn bij het werken met de ELK-stack.
https://www.elastisch.co/guide/nl/elastisch zoeken/referentie/huidig/index-aliassen.html
https://www.elastisch.co/guide/nl/elastisch zoeken/referentie/huidig/indexen-add-alias.html
