Kaip sukurti Elasticsearch indeksus

„Elasticsearch“ yra viena iš populiaraus ELK kamino, naudojamo žurnalų analizei ir paieškai, dalis. Programos ir sistemos nuolat registruoja duomenis, kurie gali būti labai naudingi trikčių šalinimui ir problemų stebėjimui. Naudodamiesi ELK kaminu, turite geriausius įrankius greitai ir labai lengvai atlikti šias užduotis.

Šioje greitoje pamokoje apžvelgsime „Elasticsearch“, ypač kaip sukurti indeksus „Elasticsearch“ variklyje. Nors jums nereikia išsamių žinių apie ELK kaminą, kad galėtumėte sekti šią pamoką, gali būti naudinga gerai suprasti šias temas:

Naudodamas terminalą, konkrečiai, cURL
Pagrindinės žinios apie API ir JSON
Pateikti HTTP užklausą

PASTABA: Šioje pamokoje taip pat daroma prielaida, kad jūsų sistemoje yra įdiegta ir veikia „Elasticsearch“.

Kas yra „Elasticsearch“ indeksai?

Per daug nesupaprastinus ir nesudėtinus dalykų, „Elasticsearch“ indeksas yra susijusių JSON dokumentų rinkinys.

Kaip minėta ankstesniame įraše, „Elasticsearch“ indeksai yra JSON objektai, laikomi pagrindiniu „Elasticsearch“ saugyklos vienetu. Šie susiję JSON dokumentai saugomi vienete, sudarančiame indeksą. Galvokite apie „Elasticsearch“ dokumentus kaip lenteles reliacinėje duomenų bazėje.

Susiekime „Elasticsearch“ indeksą kaip duomenų bazę SQL pasaulyje.

MySQL => Duomenų bazės => Lentelės => Stulpeliai / eilutės
Elasticsearch => Indeksai => Tipai => JSON dokumentai su ypatybėmis

Kaip sukurti Elasticsearch indeksą

Elasticsearch naudoja galingą ir intuityvų REST API, kad atskleistų savo paslaugas. Ši funkcija leidžia naudoti HTTP užklausas atliekant operacijas „Elasticsearch“ grupėje. Todėl, norėdami sukurti naują indeksą, naudosime „index index API“.

Šiame vadove mes naudosime cURL užklausoms siųsti ir išsaugosime vientisumą bei tinkamumą visiems vartotojams. Tačiau, jei susiduriate su „cURL“ klaidomis, apsvarstykite galimybę naudoti „Kibana Console“.

Naujo indekso kūrimo „Elasticsearch“ grupėje sintaksė yra tokia:

PUT /

Norėdami sukurti indeksą, tereikia perduoti indekso pavadinimą be kitų parametrų, kuris sukuria indeksą naudodamas numatytuosius nustatymus.

Taip pat galite nurodyti įvairias indekso funkcijas, pvz., Indekso turinį:

Rodyklės nustatymai
Rodykliniai slapyvardžiai
Rodyklės laukų susiejimai

Indekso pavadinimas yra būtinas parametras; priešingu atveju gausite klaidą dėl URIL (/)

„curl -X PUT“ „localhost: 9200“
"error": "Neteisingas HTTP metodas uri [/] ir metodui [PUT], leidžiamas: [DELETE, HEAD, GET]", "status": 405

Norėdami sukurti naują indeksą pavadinimu single_index, mes perduodame užklausą:

PUT / single_index

Norėdami naudoti „CURL“, naudokite komandą:

„curl -X PUT“ vietinis kompiuteris: 9200 / single_index?graži"

Ši komanda turėtų sukelti HTTP būseną 200 OK ir pranešimą su patvirtinimu: true kaip:

„Pripažino“: tiesa,
"shards_acknowledged": tiesa,
"index": "single_index"

Aukščiau pateikta užklausa sukuria indeksą „single_index“ su numatytaisiais nustatymais, nes nenurodėme jokių konfigūracijų.

Rodyklės pavadinimo taisyklės

Kurdami „Elasticsearch“ indeksų pavadinimus, turite laikytis šių pavadinimo standartų:

Indekso pavadinimas turi būti tik mažosiomis raidėmis.
Rodyklės pavadinimai negali prasidėti brūkšneliu (-), pabraukimu (_) arba papildymo ženklu (+)
Vardai negali būti . arba…
Rodyklių pavadinimuose negali būti specialių simbolių, tokių kaip: \, /, *, ?, „, <, >, |, "(tarpo ženklas), ,, #
Indeksų pavadinimų ilgis turi būti mažesnis nei 255 baitai. Kelių baitų simboliai bus skaičiuojami bendrame indekso pavadinimo ilgyje. Pvz., Jei vieno simbolio ilgis yra 8 baitai, bendras likęs vardo ilgis yra 255–8
Naujausioje „Elasticsearch“ versijoje vardai, prasidedantys a . yra rezervuoti paslėptiems rodikliams ir vidiniams indeksams, kuriuos naudoja „Elasticsearch“ papildiniai.

Kaip sukurti rodyklės turinį

Naudodami PUT užklausą indeksui sukurti, galite perduoti įvairius argumentus, apibrėžiančius norimo sukurti indekso parametrus. Vertės, kurias galite nurodyti turinyje:

Slapyvardžiai: Nurodo slapyvardžius vardams, kuriuos norite sukurti; šis parametras yra neprivalomas.
Nustatymai: Tai apibrėžia norimo sukurti indekso konfigūravimo parinktis. Jei nepavyksta nurodyti jokių parametrų, indeksas sukuriamas naudojant numatytąsias konfigūracijas.
Susiejimai: Tai apibrėžia indekso laukų susiejimą. Specifikacijos, kurias galite įtraukti į žemėlapius:
- Lauko pavadinimas
- Duomenų tipas
- Žemėlapio parametras

Jei norite sukurti indekso su kūno konfigūracijomis sukūrimo pavyzdį, apsvarstykite toliau pateiktą užklausą:

„PUT“ / „single_index_with_body“

„nustatymai“:
"Skardžių skaičius": 2,
"Replikų skaičius": 2
,
„Susiejimai“:
„savybės“:
"field1": "type": "object"

Jei norite gauti lygiavertę CURL užklausą:

garbanos -XPUT "http: // localhost: 9200 / single_index_with_body" -H 'Content-Type: application / json' -d '"settings": "number_of_shards": 2, "number_of_replicas": 2, "susiejimai" : "properties": "field1": "type": "object" '

Pirmiau pateikta užklausa sukuria naują indeksą pavadinimu single_index_with_body su 2 skeveldrų skaičiais ir 2 kopijomis. Taip pat sukuriamas susiejimas su pavadinimo lauko1 lauku ir tipo kaip JSON objektu.

Išsiuntę užklausą, gausite atsakymą su užklausos būsena:

„Pripažino“: tiesa,
"shards_acknowledged": tiesa,
"index": "single_index_with_body"

„Pripažinta“ parodo, ar indeksas buvo sėkmingai sukurtas klasteryje, o „shards_acknowledged“ parodo, ar prieš nurodytą laiką kiekvienam nurodytos rodyklės fragmentui buvo pradėtas reikiamas fragmentų kopijų skaičius.

Kaip peržiūrėti „Elasticsearch Index“

Norėdami peržiūrėti informaciją apie sukurtą indeksą, naudokite panašią užklausą kaip kuriant rodyklę, tačiau naudokite HTTP metodą, o ne PUT kaip:

GET / single_index_w_kūnas

Dėl CURL,

garbanos -XGET „http: // localhost: 9200 / single_index_with_body“

Ši komanda suteiks jums išsamią informaciją apie prašomą indeksą kaip:

"single_index_with_body":
„slapyvardžiai“: ,
„susiejimai“:
„savybės“:
"laukas1":
"type": "object"

,
„nustatymai“:
"indeksas" :
„maršrutas“:
„paskirstymas“:
„įtraukti“:
"_tier_preference": "data_content"

,
"sh_s__skaičius": "2",
"numatytas_pavadinimas": "vienas_indeksas_su_kūnu",
"creation_date": "1611045687208",
"replikų skaičius": "2",
„uuid“: „3TRkO7xmQcSUOOGtb6pXVA“,
„versija“:
„sukurtas“: „7100299“

Išvada

Šiame vadove aptarta, kaip dirbti su „Elasticsearch“ kuriant indekso API, kuriant naujus indeksus. Mes taip pat aptarėme, kaip sukurti tinkamus indeksų pavadinimus ir konfigūracijos parametrus.

Naudodamiesi šiuo vadovu, dabar galite kurti ir peržiūrėti indeksus naudodami „Elasticsearch“ API.