Elasticsearch
弾性検索構成

備考

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

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

静的な弾性検索設定

ElasticsearchはYAML（Yet Another Markup Language）設定ファイルを使用します。このファイルは、デフォルトのElasticsearchディレクトリ（ RPMとDEBインストールではこの場所が変更されます）内にあります。

config/elasticsearch.ymlで基本設定を行うことができます：

# 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_

永続的な動的クラスタ設定

クラスターがすでに開始した後に動的に設定を適用する必要があり、実際に動的に設定できる場合は、 _cluster/settings APIを使用して_cluster/settingsできます。

永続的な設定は、適用可能な2つのタイプのクラスター全体の設定の1つです。永続的な設定は 、完全なクラスタの再起動後も存続します。

注：すべての設定を動的に適用できるわけではありません。たとえば、クラスターの名前を動的に変更することはできません。ほとんどのノードレベル設定は、個別にターゲティングすることはできないため、動的に設定することもできません。

これは、インデックスレベルの設定に使用するAPIではありません 。設定はインデックスで始まる必要があるため、インデックスレベルの設定であることがわかりindex. 。名前がindices.形式の設定indices.彼らはすべてのインデックスに適用されるため、クラスタ全体の設定です 。

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

警告 ：Elasticsearch 1.xおよび2.xでは、永続的な設定を解除できません。

幸運なことに、これはElasticsearch 5.xで改善されました。これで、 null設定することで設定を削除できるようになりました。

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

未設定の設定は、デフォルト値、または優先度の低いレベルで定義された値（コマンドライン設定など）に戻ります。

一時的な動的クラスタ設定

クラスターがすでに開始した後に動的に設定を適用する必要があり、実際に動的に設定できる場合は、 _cluster/settings APIを使用して_cluster/settingsできます。

一時的な設定は、適用可能な2つのタイプのクラスター全体の設定の1つです。一時的な設定は、完全なクラスタ再起動では存続しません 。

注：すべての設定を動的に適用できるわけではありません。たとえば、クラスターの名前を動的に変更することはできません。ほとんどのノードレベル設定は、個別にターゲティングすることはできないため、動的に設定することもできません。

これは、インデックスレベルの設定に使用するAPIではありません 。設定はインデックスで始まる必要があるため、インデックスレベルの設定であることがわかりindex. 。名前がindices.形式の設定indices.彼らはすべてのインデックスに適用されるため、クラスタ全体の設定です 。

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

警告 ：Elasticsearch 1.xおよび2.xでは、クラスタを完全に再起動せずに一時的な設定を解除することはできません。

幸運なことに、これはElasticsearch 5.xで改善されました。これで、nullに設定することで設定を削除できるようになりました。

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

設定を解除すると、デフォルト値、またはより低い優先度で定義された値（たとえば、 persistent設定）に戻ります。

インデックスの設定

インデックス設定は、単一のインデックスに適用される設定です。このような設定はindex.始まりindex. 。この規則の例外はnumber_of_shardsとnumber_of_replicasであり、 index.number_of_shardsとindex.number_of_replicas形式でも存在します。

名前が示すように、インデックスレベルの設定は単一のインデックスに適用されます。一部の設定は、インデックスのプライマリ断片の数を制御するindex.number_of_shards設定など、動的に変更できないため、作成時に適用する必要があります。

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

より簡潔な形式で、キープレフィックスをそれぞれ組み合わせることができます. ：

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

上記の例では、指定された設定でインデックスが作成されます。 index _settingsエンドポイントを使用して、インデックスごとの設定を動的に変更することができます。例えば、ここでは、動的に変化slowlog設定を 唯一の警告レベルのために：

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

警告 ：Elasticsearch 1.xおよび2.xでは、インデックスレベルの設定名を厳密に検証していませんでした。タイプミスがあった場合や、単に設定を行った場合は、それを盲目的に受け入れるでしょうが、そうでなければ無視します。 Elasticsearch 5.xは厳密に設定名を検証し、不明な設定（タイプミスまたはプラグインがないため）のインデックス設定を適用しようとする試みを拒否します。両方のステートメントは、動的に変更されるインデックス設定および作成時に適用されます。

複数のインデックスの動的インデックス設定を同時に

「 Index Settings例に示されている同じ変更を、 すべての既存のインデックスに1回のリクエストで適用することも、それらのサブセットを適用することもできます。

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

または

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

または

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

より選択的に選択したい場合は、すべてを使用せずに複数を選択することができます。

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