Phenquestions
Was ist Elasticsearch??
Elasticsearch ist eine kostenlose Open-Source-Such- und Analysemaschine zum Sammeln, Verwalten und Analysieren von Daten.
Elasticsearch ist ein umfassendes Tool, das Apache Lucene verwendet, um Text-, numerische, strukturierte und unstrukturierte Geodaten zu verarbeiten. Elasticsearch verwendet eine einfache und sehr leistungsstarke REST-API, mit der Benutzer sie konfigurieren und verwalten können. In Verbindung mit anderen Tools wie Kibana und Logstash ist es eine der beliebtesten Echtzeit- und Datenanalyse-Engines.
Sobald Daten aus Quellen wie Systemprotokollen, Metriken, Anwendungsdaten usw. gesammelt wurden., Es wird zu Elasticsearch hinzugefügt und indiziert, sodass Sie komplexe Datenabfragen durchführen und mit Visualisierungstools wie Kibana Zusammenfassungen und informative Dashboards erstellen können.
Was ist der Elasticsearch-Index??
Nachdem wir herausgefunden haben, was Elasticsearch ist, sprechen wir über eines der wichtigsten Dinge über Elastic: ein Index.
In Elasticsearch bezieht sich ein Index auf eine Sammlung eng verwandter Dokumente in Form von JSON-Daten. Die JSON-Daten korrelieren die Schlüssel mit entsprechenden Werten zu ihren Schlüsseln.
Hier ist ein Beispiel für ein JSON-Dokument:
"@timestamp": "2099-11-15T13:12:00",
"message": "GET /search HTTP/1.1 200 1070000",
"Benutzer":
"id": "json_doc"
Elasticsearch-Indizes liegen in Form eines invertierten Index vor, den Elasticsearch mit Volltexten durchsucht. Ein invertierter Index funktioniert, indem er alle eindeutigen Wörter in jedem Elasticsearch-Dokument auflistet und genau mit dem Dokument übereinstimmt, in dem das Wort vorkommt.
Die von Elasticsearch bereitgestellte invertierte Indexierungsfunktion ermöglicht auch eine Echtzeitsuche und kann mit der Elasticsearch-Indexierungs-API aktualisiert werden.
So erstellen Sie einen Index-Alias
Elasticsearch stellt seine Dienste und Funktionen mithilfe einer sehr leistungsstarken REST-API bereit. Mit dieser API können wir einen Alias für einen Elasticsearch-Index erstellen.
Was ist ein Index-Alias??
Ein Elastisearch-Indexalias ist ein sekundärer Name oder eine sekundäre Kennung, mit der wir auf einen oder mehrere Indizes verweisen können.
Nachdem Sie einen Indexalias erstellt haben, können Sie auf den Index oder die Indizes in Elasticsearch-APIs verweisen.
Ein Beispiel für einen geeigneten Index wären Indizes, die Systemprotokolle für Apache speichern. Wenn Sie regelmäßig Apache-Logs abfragen, können Sie einen Alias für apache_logs erstellen und diesen spezifischen Index abfragen und aktualisieren.
Um einen Alias für einen bestimmten Index zu erstellen, verwenden wir die PUT-Anfrage gefolgt vom Pfad des Index und dem zu erstellenden Alias.
In REST verwenden wir eine PUT-Methode, um anzufordern, dass die übergebene Entität oder der Wert unter der Anforderungs-URL gespeichert wird. Einfach gesagt, eine HTTP-PUT-Methode ermöglicht es Ihnen, Informationen zu einer Ressource zu aktualisieren oder einen neuen Eintrag zu erstellen, falls keiner vorhanden ist.
Für dieses Tutorial gehe ich davon aus, dass Sie Elasticsearch installiert haben und über einen API-Client oder ein Tool zum Senden von HTTP-Anfragen wie cURL . verfügen.
Beginnen wir damit, einen einfachen Index ohne Alias oder Parameter zu erstellen.
Der Einfachheit halber verwenden wir cURL, da wir davon ausgehen, dass Sie Elasticsearch nur ohne Kibana installiert haben. Wenn Sie jedoch Kibana installiert haben oder bei der Verwendung von curl auf Fehler stoßen, sollten Sie die Verwendung der Kibana-Konsole in Betracht ziehen, da sie besser für Elasticsearch-API-Anfragen geeignet ist.
curl -X PUT "localhost:9200/my_index"?ziemlich"Dieser Befehl erstellt einen einfachen Index mit den Standardeinstellungen und gibt Folgendes zurück.
„bestätigt“: wahr,
„shards_acknowledged“: wahr,
"index": "mein_index"
Da wir nun einen Index in Elasticsearch haben, können wir einen Alias mit derselben PUT-Anfrage erstellen wie:
PUT localhost:9200/my_index/_alias/my_alias_1Wir beginnen mit der Angabe der Methode, in diesem Fall ein PUT gefolgt von der URL des Index, dem wir einen Alias hinzufügen möchten. Das nächste ist die API, die wir verwenden möchten, in diesem Fall die Index-Alias-API (_alias), gefolgt vom Namen des Alias, den wir dem Index zuweisen möchten.
Hier ist der cURL-Befehl dafür:
curl -X PUT "localhost:9200/my_index/_alias/my_alias_1?ziemlich"Dieser Befehl sollte mit 200 OK-Status und „quittiert“ antworten:
„bestätigt“: wahr
Möglicherweise stoßen Sie auch auf eine Methode zum Hinzufügen eines Alias zu einem Index als:
curl -X POST "localhost:9200/_aliases?hübsch" -H 'Inhaltstyp: application/json' -d'"Aktionen" : [
"hinzufügen" : "index" : "my_index", "alias" : "my_alias_1"
]
Mit der Elasticsearch Index-Alias-API können Sie Index-Aliasnamen nach Belieben hinzufügen, aktualisieren und entfernen.
So erhalten Sie Index-Alias-Informationen
Wenn Sie ausgeklügelte Aliasnamen erstellen, die beispielsweise auf einen bestimmten Benutzer gefiltert wurden, möchten Sie möglicherweise Informationen über den Index erhalten. Sie können die Informationen mit der GET-Methode anzeigen als:
GET /my_index/_alias/my_alias_1Hier ist der cURL-Befehl:
curl -X GET "localhost:9200/my_index/_alias/my_alias_1?ziemlich"Dieser Befehl zeigt die Informationen zum Alias an. Da wir keine Informationen hinzugefügt haben, wird es normalerweise ähneln.
"mein_index":
"Aliasnamen":
"my_alias_1":
Stellen Sie sicher, dass der Alias vorhanden ist, um einen 404-Fehler wie unten gezeigt zu vermeiden:
curl -X GET „localhost:9200/my_index/_alias/does_not_exist“?ziemlich"Das Ergebnis ist ein "Alias existiert nicht oder fehlt" als:
"error": "alias [does_not_exist] fehlt",
"status": 404
So löschen Sie einen Index-Alias
Um einen vorhandenen Alias aus einem Index zu entfernen, verwenden wir die Methode, die wir zum Hinzufügen eines Alias verwendet haben, jedoch stattdessen mit einer DELETE-Anfrage. Beispielsweise:
localhost:9200/my_index/_alias/my_alias_1Der entsprechende cURL-Befehl lautet:
curl -X DELETE "localhost:9200/my_index /_alias/my_alias_1?ziemlich"Elasticsearch sollte mit 200 OK antworten und bestätigen: true
„bestätigt“: wahr
Es gibt andere Möglichkeiten zum Aktualisieren und Entfernen von Aliasen aus einem Index in Elasticsearch. Der Einfachheit halber sind wir jedoch bei einer einzigen Anfrage geblieben.
Fazit
In diesem einfachen Tutorial haben wir uns das Erstellen eines Elasticsearch-Index und dann eines Alias angesehen. Wir haben auch behandelt, wie man einen Alias löscht.
Es ist erwähnenswert, dass dieser Leitfaden nicht der definitivste der Welt ist; sein Zweck war es, als Einstiegsleitfaden für die Erstellung von Elasticsearch zu dienen, nicht als umfassender Leitfaden.
Wenn Sie mehr über die Elastic Index API erfahren möchten, beachten Sie die folgenden Ressourcen.
Wir empfehlen außerdem, über Grundkenntnisse in der Arbeit mit Elasticsearch und API zu verfügen; es wird eine große Hilfe bei der Arbeit mit dem ELK-Stack sein.
https://www.elastisch.co/guide/en/elasticsearch/reference/current/indices-aliases.html
https://www.elastisch.co/guide/en/elasticsearch/reference/current/indices-add-alias.html
