Phenquestions
Cos'è Elasticsearch??
Elasticsearch è un motore di ricerca e analisi gratuito e open source utilizzato per raccogliere, gestire e analizzare i dati.
Elasticsearch è uno strumento completo che utilizza Apache Lucene per elaborare dati geospaziali testuali, numerici, strutturati e non strutturati. Elasticsearch utilizza un'API REST semplice e molto potente che consente agli utenti di configurarla e gestirla. Se abbinato ad altri strumenti come Kibana e Logstash, è uno dei più popolari motori di analisi dei dati e in tempo reale.
Una volta raccolti i dati da fonti come registri di sistema, metriche, dati dell'applicazione, ecc., viene aggiunto a Elasticsearch e indicizzato, consentendo di eseguire query di dati complesse e creare riepiloghi e dashboard informativi utilizzando strumenti di visualizzazione come Kibana.
Che cos'è l'indice Elasticsearch??
Dopo aver chiarito cos'è Elasticsearch, parliamo di una delle cose più importanti di Elastic: un indice.
In Elasticsearch, un indice si riferisce a una raccolta di documenti strettamente correlati sotto forma di dati JSON. I dati JSON correlano le chiavi con i valori corrispondenti alle loro chiavi.
Ecco un esempio di un documento JSON:
"@timestamp": "2099-11-15T13:12:00",
"messaggio": "OTTIENI /cerca HTTP/1.1 200 1070000",
"utente":
"id": "json_doc"
Gli indici Elasticsearch hanno la forma di un indice invertito, che Elasticsearch cerca utilizzando i testi completi. Un indice invertito funziona elencando tutte le parole univoche in qualsiasi documento Elasticsearch e corrisponde con precisione al documento in cui la parola traspare.
La funzione di indicizzazione inversa fornita da Elasticsearch consente anche la ricerca in tempo reale e può essere aggiornata utilizzando l'API di indicizzazione Elasticsearch.
Come creare un alias indice
Elasticsearch espone i suoi servizi e funzionalità utilizzando un'API REST molto potente. Utilizzando questa API, possiamo creare un alias per un indice Elasticsearch.
Che cos'è un alias indice??
Un alias di indice Elastisearch è un nome o identificatore secondario che possiamo usare per fare riferimento a uno o più indici.
Una volta creato un alias indice, puoi fare riferimento all'indice o agli indici nelle API Elasticsearch.
Un esempio di indice appropriato sarebbero gli indici che memorizzano i log di sistema per apache. Se interroghi regolarmente i log di apache, puoi creare un alias per apache_logs e interrogare e aggiornare quell'indice specifico.
Per creare un alias per un determinato indice, utilizziamo la richiesta PUT seguita dal percorso dell'indice e dall'alias per creare.
In REST, utilizziamo un metodo PUT per richiedere che l'entità o il valore passati vengano archiviati nell'URL della richiesta. In poche parole, un metodo HTTP PUT consente di aggiornare le informazioni su una risorsa o creare una nuova voce se non ne esiste nessuna.
Per questo tutorial, presumo che tu abbia installato Elasticsearch e che tu abbia un client API o uno strumento per inviare richieste HTTP come cURL.
Iniziamo creando un semplice indice senza alias o parametri.
Per semplicità, utilizzeremo cURL poiché supponiamo che tu abbia installato solo Elasticsearch senza Kibana. Tuttavia, se hai installato Kibana o riscontri errori durante l'utilizzo di curl, considera l'utilizzo di Kibana Console perché è più adatto per le richieste API Elasticsearch.
curl -X PUT "localhost:9200/my_index?bella"Questo comando crea un indice semplice utilizzando le impostazioni predefinite e restituisce quanto segue.
“riconosciuto”: vero,
“shards_acknowledged”: vero,
"indice": "mio_indice"
Ora che abbiamo un indice in Elasticsearch, possiamo creare un alias usando la stessa richiesta PUT di:
PUT localhost:9200/my_index/_alias/my_alias_1Iniziamo specificando il metodo, in questo caso un PUT seguito dall'URL dell'indice a cui vogliamo aggiungere un alias. La prossima è l'API che vogliamo usare, in questo caso l'API Index Alias (_alias) seguita dal nome dell'alias che vogliamo assegnare all'indice.
Ecco il comando cURL per questo:
curl -X PUT "localhost:9200/my_index/_alias/my_alias_1?bella"Questo comando dovrebbe rispondere con lo stato 200 OK e "confermato":
“riconosciuto”: vero
Potresti anche imbatterti in un metodo per aggiungere un alias a un indice come:
curl -X POST "localhost:9200/_aliases?pretty" -H 'Content-Type: application/json' -d'"Azioni" : [
"aggiungi": "indice": "mio_indice", "alias": "mio_alias_1"
]
Utilizzando l'API di alias dell'indice Elasticsearch, puoi aggiungere, aggiornare e rimuovere gli alias dell'indice come meglio credi.
Come ottenere informazioni sull'alias dell'indice
Quando crei alias sofisticati come quelli filtrati per un utente specifico, potresti voler ottenere informazioni sull'indice. Puoi visualizzare le informazioni utilizzando il metodo GET come:
OTTIENI /mio_indice/_alias/mio_alias_1Ecco il comando cURL:
curl -X GET "localhost:9200/my_index/_alias/my_alias_1?bella"Questo comando visualizzerà le informazioni riguardanti l'alias. Poiché non abbiamo aggiunto alcuna informazione, in genere assomiglierà a.
"mio_indice":
"alias":
"mio_alias_1":
Assicurati che l'alias esista per evitare di ricevere un errore 404 come mostrato di seguito:
curl -X GET “localhost:9200/my_index/_alias/does_not_exist?bella"Il risultato sarà un "alias inesistente o mancante" come:
"errore": "alias [non_esiste] mancante",
"stato": 404
Come eliminare un alias indice Index
Per rimuovere un alias esistente da un indice, utilizziamo il metodo che abbiamo usato per aggiungere un alias ma con una richiesta DELETE. Per esempio:
localhost:9200/mio_indice/_alias/mio_alias_1Il comando cURL equivalente è:
curl -X DELETE "localhost:9200/my_index /_alias/my_alias_1?bella"Elasticsearch dovrebbe rispondere con 200 OK e confermato: vero
“riconosciuto”: vero
Esistono altri modi per aggiornare e rimuovere gli alias da un indice in Elasticsearch. Tuttavia, per semplicità, ci siamo fermati con una singola richiesta.
Conclusione
In questo semplice tutorial, abbiamo esaminato la creazione di un indice Elasticsearch e quindi di un alias. Abbiamo anche spiegato come eliminare un alias.
Vale la pena notare che questa guida non è la più definitiva al mondo; il suo scopo era quello di fungere da guida di partenza per la creazione di Elasticsearch, non una guida completa.
Se desideri saperne di più sull'API Elastic Index, prendi in considerazione le risorse di seguito.
Consigliamo inoltre di avere una conoscenza di base del lavoro con Elasticsearch e API; sarà di grande aiuto quando si lavora con lo stack ELK.
https://www.elastico.co/guide/it/elasticsearch/reference/current/indici-alias.html
https://www.elastico.co/guide/it/elasticsearch/reference/current/indici-add-alias.html
