Phenquestions
Dieses Tutorial führt Sie durch die Besonderheiten von Elasticsearch-Indexvorlagen, mit denen Sie Vorlagen oder Blaupausen für gängige Indizes definieren können. Wenn Sie beispielsweise ständig Daten aus externen Quellen protokollieren, können Sie einen Blueprint für alle Protokollierungsindizes definieren.
HINWEIS: Bevor wir beginnen, ist es gut zu beachten, dass sich das Tutorial auf die neueste Version von Elasticsearch-7 konzentriert.8 zum Zeitpunkt des Schreibens - und kann von anderen Versionen abweichen. Wir gehen auch davon aus, dass Elasticsearch irgendwo auf einem System läuft.
Beginnen wir mit der Arbeit mit Elasticsearch-Indexvorlagen.
Was ist eine Elasticsearch-Indexvorlage??
Eine Elasticsearch-Indexvorlage ist eine Methode, mit der Elasticsearch angewiesen wird, Indizes bei der Erstellung zu konfigurieren. Beispielsweise konfiguriert eine in einem Datenstrom verwendete Indexvorlage die Backing-Indizes des Streams bei der Erstellung. Eine Indexvorlage wird vor der Indexerstellung manuell erstellt. Beim Erstellen eines Index wendet die Vorlage die Konfigurationseinstellungen für den Index an.
Die neueste Version von Elasticsearch bietet zwei Arten von verwendbaren Vorlagen. Einer ist der Indexvorlage, und das andere ist Komponentenvorlagen. Wie wir bereits festgestellt haben, helfen Indexvorlagen bei der Erstellung von Elasticsearch-Indizes.
Komponentenvorlagen sind wiederverwendbare Module oder Blöcke, die zum Konfigurieren von Einstellungen, Zuordnungen und Aliasen verwendet werden. Komponentenvorlagen werden nicht direkt auf die erstellten Indizes angewendet, können jedoch beim Erstellen von Indexvorlagen helfen help.
Einige von Elasticsearch verwendete Standardindexvorlagen umfassen: metrics-*-*, logs-*-* .
So erstellen Sie eine Indexvorlage
Um neue Indexvorlagen zu erstellen oder bestehende zu aktualisieren, verwenden wir die PUT-Vorlagen-API. Mit dem Endpunkt _index_template können wir eine HTTP-Anfrage senden, um eine Vorlage hinzuzufügen.
Die allgemeine Syntax zum Erstellen einer Vorlage lautet:
PUT _index_template/template_nameBeachten Sie, dass der Vorlagenname ein erforderlicher Parameter ist. Betrachten Sie die folgende Anfrage, die eine Indexvorlage als template_1 erstellt
PUT _index_template/template_1/* Definiere das Indexmuster */
"index_patterns" : ["te*"],
"Priorität" : 1,
/* Einstellungen für die Indizes festlegen*/
"Vorlage":
"die Einstellungen" :
"number_of_shards" : 2
Für cURL-Benutzer lautet der Befehl:
curl -XPUT "http://localhost:9200/_index_template/template_1" -H 'Content-Type: application/json' -d' /* Definiere das Indexmuster */ "index_patterns" : ["te*"], "priority" : 1, /* Definiere Einstellungen für die Indizes*/ "template": "settings" : "number_of_shards" : 2 'Elasticsearch verwendet ein Platzhaltermuster, um Indexnamen abzugleichen, auf die die Vorlagen angewendet werden. Das Ändern oder Aktualisieren einer Indexvorlage wirkt sich nicht auf bereits erstellte Indizes aus, sondern nur auf diejenigen, die nach Verwendung dieser Vorlage erstellt werden.
Von oben können Sie Ihre Vorlagen mit der C-Language-Kommentarmethode kommentieren. Sie können beliebig viele Kommentare an einer beliebigen Stelle im Text hinzufügen, außer an der Öffnung der geschweiften Klammern.
In den Textkörper einer Indexvorlage können Sie verschiedene Definitionen aufnehmen, wie z
- Vorlage: Die Vorlageneigenschaft (Objekt) definiert, welche Vorlage angewendet werden soll; Es kann Aliase, Zuordnungen und Einstellungen enthalten – dies ist ein optionaler Parameter.
- Zusammengesetzt aus: Diese Eigenschaft definiert eine Liste von Namen für Komponentenvorlagen. Nach der Definition werden Komponentenvorlagen in ihrer Spezifikationsreihenfolge zusammengesetzt. Das bedeutet, dass die zuletzt definierte Komponentenvorlage die höchste Priorität hat.
- Priorität: Die Eigenschaft priorität definiert die Priorität der Indexvorlage beim Erstellen eines Index. Wenn eine Priorität den höchsten Wert hat, erhält sie eine höhere Priorität im Vergleich zu niedrigeren Werten. Der Prioritätswert ist nicht erforderlich und hat den Typ Integer. 0 ist der Standardwert für nicht angegebene Vorlagen.
- Ausführung: Der Parameter version gibt die Version der Indexvorlage an, die bei der Verwaltung der Vorlagen hilft.
Es gibt andere Eigenschaften, die Sie in den Indexvorlagenkörper aufnehmen können. Betrachten Sie die Dokumentation, um mehr zu erfahren.
https://www.elastisch.co/guide/de/elasticsearch/reference/7.10/Index-Vorlagen.html
Unten ist eine Beispielanfrage zum Erstellen einer neuen Vorlage mit Version 1.0
PUT /_index_template/template_2"index_patterns" : ["remp*", "re*"],
"Priorität" : 1,
"Vorlage":
"die Einstellungen" :
"number_of_shards" : 2,
"number_of_replicas": 0
,
"Version 1.0
Sie können nicht mehr als eine Indexvorlage mit einem übereinstimmenden Muster und derselben Priorität haben. Stellen Sie daher sicher, dass Sie den Mustervorlagen unterschiedliche Prioritäten zuweisen.
So erhalten Sie eine Indexvorlage
Um Informationen zu einer Indexvorlage anzuzeigen, senden Sie eine GET-Anfrage an die _index_template-API. Um beispielsweise Informationen zu template_2 anzuzeigen, verwenden Sie die Anfrage:
GET _index_template/template_2Der cURL-Befehl lautet:
curl -XGET "http://localhost:9200/_index_template/template_2"Dieser Befehl sollte Informationen zu template_2 anzeigen
"index_templates": [
"name" : "template_2",
"index_template":
"index_muster" : [
"remp*",
"Re*"
],
"Vorlage" :
"die Einstellungen" :
"Index" :
"number_of_shards" : "2",
"Anzahl_der_Replikate" : "0"
,
"zusammengesetzt aus" : [ ],
"Priorität" : 1,
"Version 1
]
Sie können auch Platzhalter verwenden, um passende Vorlagen zu erhalten. Betrachten Sie zum Beispiel die folgende Anfrage, um alle Vorlagen in Elasticsearch anzuzeigen.
GET _index_template/*Der cURL-Befehl ist.
curl -XGET http://localhost:9200/_index_template/*Dieser Befehl sollte Ihnen Informationen zu allen Vorlagen in Elasticsearch geben give
"index_templates": [
"name" : "ilm-historie",
"index_template":
"index_muster" : [
"ilm-history-3*"
],
"Vorlage" :
"die Einstellungen" :
"Index" :
"formatieren" : "1",
"Lebenszyklus" :
"name" : "ilm-historie-ilm-policy",
"rollover_alias" : "ilm-history-3"
,
"versteckt" : "wahr",
"number_of_shards" : "1",
"auto_expand_replicas" : "0-1",
"Anzahl_der_Replikate" : "0"
,
"Zuordnungen":
"dynamisch" : falsch,
"Eigenschaften" :
"index_age":
"typ" : "lang"
,
"@timestamp" :
"format" : "epoch_millis",
"Typ" : "Datum"
,
"Fehlerdetails" :
"Text eingeben"
,
"Erfolg":
"type" : "boolean"
,
"Index" :
"Typ" : "Schlüsselwort"
,
"Zustand" :
"dynamisch" : wahr,
"Typ" : "Objekt",
--------------------------AUSGANG ABGESCHNITTEN-----------------------------------
So löschen Sie Vorlagen
Das Löschen einer Vorlage ist genauso einfach wie die GET-Vorlage, aber mit der DELETE-Anfrage wie folgt:
LÖSCHEN _index_template/template_2Sie können den cURL-Befehl verwenden:
curl -XDELETE "http://localhost:9200/_index_template/template_2"Dieser Befehl löscht automatisch die angegebene Vorlage.
Fazit
In diesem Tutorial wurde beschrieben, was Elasticsearch-Indexvorlagen sind, wie sie funktionieren und wie Sie Indexvorlagen erstellen, anzeigen und löschen. Diese grundlegenden Informationen sollen Ihnen den Einstieg in die Verwendung von Elasticsearch-Indexvorlagen erleichtern.
