Elasticsearch
Elasticsearch-Konfiguration

Bemerkungen

$ bin/elasticsearch -Des.cluster.name=my_cluster -Des.node.name=`hostname`

$ bin/elasticsearch -Ecluster.name=my_cluster -Enode.name=`hostname`

Statische Elasticsearch-Einstellungen

Elasticsearch verwendet eine YAML-Konfigurationsdatei (Yet Another Another Markup Language), die sich im Standard-Elasticsearch-Verzeichnis befindet ( RPM- und DEB-Installationen ändern diesen Speicherort unter anderem ).

Sie können grundlegende Einstellungen in config/elasticsearch.yml vornehmen:

# Change the cluster name. All nodes in the same cluster must use the same name!
cluster.name: my_cluster_name

# Set the node's name using the hostname, which is an environment variable!
# This is a convenient way to uniquely set it per machine without having to make
#  a unique configuration file per node.
node.name: ${HOSTNAME}

# ALL nodes should set this setting, regardless of node type
path.data: /path/to/store/data

# This is a both a master and data node (defaults)
node.master: true
node.data: true

# This tells Elasticsearch to bind all sockets to only be available
#  at localhost (default)
network.host: _local_

Permanente dynamische Clustereinstellungen

Wenn Sie eine Einstellung dynamisch anwenden müssen, nachdem der Cluster bereits gestartet wurde und tatsächlich dynamisch festgelegt werden kann, können Sie sie mit der _cluster/settings API _cluster/settings .

Persistente Einstellungen sind eine der zwei Arten von clusterweiten Einstellungen, die angewendet werden können. Eine hartnäckige Einstellung wird einen vollständigen Cluster - Neustart überleben.

Hinweis: Nicht alle Einstellungen können dynamisch angewendet werden. Beispielsweise kann der Name des Clusters nicht dynamisch umbenannt werden. Die meisten Einstellungen auf Knotenebene können auch nicht dynamisch festgelegt werden (da sie nicht einzeln anvisiert werden können).

Dies ist nicht die API, die zum Einstellen der Einstellungen auf Indexebene verwendet wird. Sie können erkennen, dass es sich bei der Einstellung um eine Indexebene handelt, da sie mit dem index. . Einstellungen, deren Name in Form von indices. vorliegt indices. sind clusterweite Einstellungen, da sie für alle Indizes gelten.

POST /_cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.enable": "none"
  }
}

Warnung : In Elasticsearch 1.x und 2.x können Sie eine permanente Einstellung nicht aufheben .

Glücklicherweise wurde dies in Elasticsearch 5.x verbessert und Sie können eine Einstellung jetzt entfernen, indem Sie sie auf null :

POST /_cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.enable": null
  }
}

Eine nicht festgelegte Einstellung wird auf den Standardwert oder einen Wert zurückgesetzt, der auf einer niedrigeren Prioritätsstufe definiert ist (z. B. Befehlszeileneinstellungen).

Einstellungen für transiente dynamische Cluster

Wenn Sie eine Einstellung dynamisch anwenden müssen, nachdem der Cluster bereits gestartet wurde und tatsächlich dynamisch festgelegt werden kann, können Sie sie mit der _cluster/settings API _cluster/settings .

Transiente Einstellungen sind eine der zwei Arten von clusterweiten Einstellungen, die angewendet werden können. Eine vorübergehende Einstellung wird keinen vollständigen Cluster - Neustart überleben.

Hinweis: Nicht alle Einstellungen können dynamisch angewendet werden. Beispielsweise kann der Name des Clusters nicht dynamisch umbenannt werden. Die meisten Einstellungen auf Knotenebene können auch nicht dynamisch festgelegt werden (da sie nicht einzeln anvisiert werden können).

Dies ist nicht die API, die zum Einstellen der Einstellungen auf Indexebene verwendet wird. Sie können erkennen, dass es sich bei der Einstellung um eine Indexebene handelt, da sie mit dem index. . Einstellungen, deren Name in Form von indices. vorliegt indices. sind clusterweite Einstellungen, da sie für alle Indizes gelten.

POST /_cluster/settings
{
  "transient": {
    "cluster.routing.allocation.enable": "none"
  }
}

Warnung : In Elasticsearch 1.x und 2.x können Sie keine Übergangseinstellungen ohne einen vollständigen Neustart des Clusters aufheben.

Glücklicherweise wurde dies in Elasticsearch 5.x verbessert und Sie können eine Einstellung jetzt entfernen, indem Sie sie auf null setzen:

POST /_cluster/settings
{
  "transient": {
    "cluster.routing.allocation.enable": null
  }
}

Eine nicht festgelegte Einstellung wird auf den Standardwert oder einen Wert zurückgesetzt, der auf einer niedrigeren Prioritätsstufe definiert ist (z. B. persistent Einstellungen).

Indexeinstellungen

Indexeinstellungen sind Einstellungen, die für einen einzelnen Index gelten. Solche Einstellungen beginnen mit dem index. . Die Ausnahme von dieser Regel sind number_of_shards und number_of_replicas , die auch in der Form index.number_of_shards und index.number_of_replicas .

Wie der Name vermuten lässt, gelten die Einstellungen auf Indexebene für einen einzelnen Index. Einige Einstellungen müssen zum Zeitpunkt der Erstellung angewendet werden, da sie nicht dynamisch geändert werden können, z. B. die Einstellung index.number_of_shards , die die Anzahl der primären Shards für den Index steuert.

PUT /my_index
{
  "settings": {
    "index.number_of_shards": 1,
    "index.number_of_replicas": 1
  }
}

oder, in einem übersichtlicheren Format, können Sie die Schlüsselpräfixe jeweils miteinander kombinieren . :

PUT /my_index
{
  "settings": {
    "index": {
      "number_of_shards": 1,
      "number_of_replicas": 1
    }
  }
}

Die obigen Beispiele erstellen einen Index mit den angegebenen Einstellungen. Sie können die Einstellungen pro Index dynamisch ändern, indem Sie den Endpunkt des Index _settings . Zum Beispiel ändern wir hier die Slowlog-Einstellungen nur für die Warnstufe :

PUT /my_index/_settings
{
  "index": {
    "indexing.slowlog.threshold.index.warn": "1s",
    "search.slowlog.threshold": {
      "fetch.warn": "500ms",
      "query.warn": "2s"
    }
  }
}

Warnung : Elasticsearch 1.x und 2.x haben die Einstellungsnamen auf Indexebene nicht sehr streng überprüft. Wenn Sie einen Tippfehler hätten oder einfach eine Einstellung vorgenommen hätten, würde er diese blind akzeptieren, ansonsten aber ignorieren. Elasticsearch 5.x überprüft die Namen der Einstellungen streng und lehnt jeden Versuch ab, Indexeinstellungen mit unbekannten Einstellungen anzuwenden (aufgrund von Tippfehlern oder fehlendem Plug-In). Beide Anweisungen gelten für dynamisch sich ändernde Indexeinstellungen und zum Zeitpunkt der Erstellung.

Dynamische Indexeinstellungen für mehrere Indizes gleichzeitig

Sie können die gleiche Änderung in der gezeigten Anwendung Index Settings - Index Settings Beispiel für alle vorhandenen Indizes mit einer Anfrage oder sogar eine Teilmenge von ihnen:

PUT /*/_settings
{
  "index": {
    "indexing.slowlog.threshold.index.warn": "1s",
    "search.slowlog.threshold": {
      "fetch.warn": "500ms",
      "query.warn": "2s"
    }
  }
}

oder

PUT /_all/_settings
{
  "index": {
    "indexing.slowlog.threshold.index.warn": "1s",
    "search.slowlog.threshold": {
      "fetch.warn": "500ms",
      "query.warn": "2s"
    }
  }
}

oder

PUT /_settings
{
  "index": {
    "indexing.slowlog.threshold.index.warn": "1s",
    "search.slowlog.threshold": {
      "fetch.warn": "500ms",
      "query.warn": "2s"
    }
  }
}

Wenn Sie es vorziehen, es auch selektiver zu machen, können Sie mehrere auswählen, ohne alle zu liefern:

PUT /logstash-*,my_other_index,some-other-*/_settings
{
  "index": {
    "indexing.slowlog.threshold.index.warn": "1s",
    "search.slowlog.threshold": {
      "fetch.warn": "500ms",
      "query.warn": "2s"
    }
  }
}