Elasticsearch Lag alias

Siden du leser en tutorial om Elasticsearch Index, er sjansen stor for at jeg ikke trenger å dykke dypt inn i hva Elastisearch er, men en kort påminnelse vil gjøre deg ingen skade.

Hva er Elasticsearch?

Elasticsearch er et gratis og åpen kildekode-søk og analytisk motor som brukes til å samle, administrere og analysere data.

Elasticsearch er et omfattende verktøy som bruker Apache Lucene for å behandle tekst, numeriske, strukturerte og ustrukturerte geospatiale data. Elasticsearch bruker et enkelt og veldig kraftig REST API som lar brukere konfigurere og administrere det. Når det er kombinert med andre verktøy som Kibana og Logstash, er det en av de mest populære sanntids- og dataanalysemotorene.

Når data er samlet inn fra kilder som systemlogger, beregninger, applikasjonsdata osv., Det blir lagt til Elasticsearch og indeksert, slik at du kan utføre komplekse dataterier og lage sammendrag og informative dashbord ved hjelp av visualiseringsverktøy som Kibana.

Hva er Elasticsearch Index?

Etter å ha strøket ut hva Elasticsearch er, la oss snakke om en av de viktigste tingene med Elastic: en indeks.

I Elasticsearch refererer en indeks til en samling av nært beslektede dokumenter i form av JSON -data. JSON -dataene korrelerer nøklene med tilsvarende verdier til tastene sine.

Her er et eksempel på et JSON -dokument:

"@Timestamp": "2099-11-15T13: 12: 00",
"melding": "få /søk http /1.1 200 1070000 ",
"Bruker":
"id": "JSON_DOC"

Elasticsearch-indekser er i form av en omvendt indeks, som Elasticsearch Search ved hjelp av fulltekst. En omvendt indeks fungerer ved å liste opp alle de unike ordene i et hvilket som helst Elasticsearch -dokument og samsvarer nøyaktig med dokumentet som ordet viser seg.

Den omvendte indekseringsfunksjonen levert av Elasticsearch gir også mulighet for sanntidssøk og kan oppdateres ved hjelp av Elasticsearch Indexing API.

Hvordan lage et indeksalias

Elasticsearch avslører sine tjenester og funksjonalitet ved hjelp av et veldig kraftig REST API. Ved å bruke denne API -en kan vi lage et alias for en Elasticsearch Index.

Hva er et indeksalias?

Et Elastisearch Index -alias er et sekundært navn eller identifikator vi kan bruke til å referere til ett eller flere indekser.

Når du har opprettet et indeksalias, kan du referere til indeksen eller indeksene i Elasticsearch -apis.

Et eksempel på en passende indeks vil være indekser som butikksystemlogger for Apache. Hvis du regelmessig spør Apache -logger, kan du opprette et alias for apache_logs, og spørre og oppdatere den spesifikke indeksen.

For å lage et alias for en bestemt indeks, bruker vi put -forespørselen etterfulgt av indeksens vei og aliaset for å opprette.

I hvile bruker vi en PUT -metode for å be om den beståtte enheten eller verdien for å bli lagret på forespørselsadressen. Enkelt sagt, en HTTP -put -metode lar deg oppdatere informasjon om en ressurs eller opprette en ny oppføring hvis ingen eksisterer.

For denne opplæringen antar jeg at du har installert Elasticsearch, og du har en API -klient eller et verktøy for å sende HTTP -forespørsler som Curl.

La oss starte med å lage en enkel indeks uten alias eller parametere.

For enkelhets skyld vil vi bruke Curl, da vi antar at du bare har installert Elasticsearch uten Kibana. Imidlertid, hvis du har kibana installert eller støter på feil når du bruker Curl, kan du vurdere å bruke Kibana -konsollen fordi den er bedre egnet for Elasticsearch API -forespørsler.

Curl -x Put "Localhost: 9200/my_index?ganske"

Denne kommandoen oppretter en enkel indeks ved hjelp av standardinnstillinger og returnerer følgende.

“Erkjent”: True,
“Shards_acknowleded”: True,
"Indeks": "my_index"

Nå som vi har en indeks i Elasticsearch, kan vi opprette et alias ved å bruke den samme putforespørselen som:

Sett Localhost: 9200/my_index/_alias/my_alias_1

Vi starter med å spesifisere metoden, i dette tilfellet, en PUT etterfulgt av nettadressen til indeksen som vi ønsker å legge til et alias. Den neste er API vi ønsker å bruke, i dette tilfellet, Index Alias ​​API (_alias) etterfulgt av navnet på aliaset vi ønsker å tilordne indeksen.

Her er Curl -kommandoen for det:

Curl -x Put "Localhost: 9200/my_index/_alias/my_alias_1?ganske"

Denne kommandoen skal svare med 200 OK -status og "anerkjent":

“Erkjent”: True

Du kan også komme over en metode for å legge til et alias i en indeks som:

Curl -x Post "Localhost: 9200/_aliases?pen "-h 'innholdstype: applikasjon/json' -d '

"Handlinger": [
"Legg til": "Index": "my_index", "alias": "my_alias_1"
]

Ved hjelp av Elasticsearch Index Alias ​​API, kan du legge til, oppdatere og fjerne indeksaliaser som du synes passer.

Hvordan få indeks aliasinfo

Når du lager sofistikerte aliaser som de som filtreres til en bestemt bruker, kan det være lurt å få informasjon om indeksen. Du kan se informasjonen ved hjelp av get -metoden som:

Få/my_index/_alias/my_alias_1

Her er Curl -kommandoen:

Curl -x Get "localhost: 9200/my_index/_alias/my_alias_1?ganske"

Denne kommandoen vil vise informasjonen om aliaset. Siden vi ikke har lagt til informasjon, vil den vanligvis ligne.

"my_index":
"aliaser":
"my_alias_1":

Forsikre deg om at aliaset eksisterer for å unngå å få en 404 -feil som vist nedenfor:

Curl -x Get “Localhost: 9200/my_index/_alias/does_not_exist?ganske"

Resultatet vil være et "alias eksisterer ikke eller mangler" som:

"Feil": "alias [does_not_exist] mangler",
"Status": 404

Hvordan slette et indeksalias

For å fjerne et eksisterende alias fra en indeks, bruker vi metoden vi har brukt til å legge til et alias, men med en slettforespørsel i stedet. For eksempel:

Localhost: 9200/my_index/_alias/my_alias_1

Den tilsvarende Curl -kommandoen er:

Curl -x slett "localhost: 9200/my_index/_alias/my_alias_1?ganske"

Elasticsearch bør svare med 200 OK og erkjent: Sann

“Erkjent”: True

Det er andre måter å oppdatere og fjerne aliaser fra en indeks i Elasticsearch. Imidlertid har vi for enkelhets skyld fast med en enkelt forespørsel.

Konklusjon

I denne enkle opplæringen har vi sett på å lage en Elasticsearch -indeks og deretter et alias. Vi har også dekket hvordan du sletter et alias.

Det er verdt å merke seg at denne guiden ikke er den mest definitive i verden; Hensikten var å tjene som en startguide for å lage Elasticsearch, ikke en omfattende guide.

Hvis du ønsker å lære mer om Elastic Index API, bør du vurdere ressursene nedenfor.

Vi anbefaler også å ha en grunnleggende kunnskap om å jobbe med Elasticsearch og API; Det vil være til stor hjelp når du jobber med Elk Stack.

https: // www.elastisk.CO/Guide/EN/Elasticsearch/Reference/Current/Indices-Aliases.html

https: // www.elastisk.CO/Guide/EN/Elasticsearch/Reference/Current/Indices-Add-Alias.html