Elasticsearch
탄성 검색 구성

비고

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

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

정적 탄성 검색 설정

Elasticsearch는 기본 Elasticsearch 디렉토리 ( RPM 및 DEB 설치가이 위치를 다른 것으로 변경 함)에서 찾을 수있는 YAML (Yet Another Markup Language) 구성 파일을 사용 합니다 .

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를 사용하여 설정할 수 있습니다.

영구 설정은 적용 할 수있는 두 가지 유형의 클러스터 전체 설정 중 하나입니다. 영구적 인 설정 은 전체 클러스터를 재시작 해도 지속 됩니다 .

참고 : 모든 설정을 동적으로 적용 할 수있는 것은 아닙니다. 예를 들어 클러스터의 이름을 동적으로 바꿀 수는 없습니다. 대부분의 노드 레벨 설정은 동적으로 설정 될 수 없습니다 (개별적으로 대상을 지정할 수 없기 때문에).

이것은 인덱스 레벨 설정을 설정하는 데 사용하는 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를 사용하여 설정할 수 있습니다.

일시적 설정은 적용 할 수있는 두 가지 유형의 클러스터 전체 설정 중 하나입니다. 일시적인 설정은 전체 클러스터를 재시작 해도 지속 되지 않습니다 .

참고 : 모든 설정을 동적으로 적용 할 수있는 것은 아닙니다. 예를 들어 클러스터의 이름을 동적으로 바꿀 수는 없습니다. 대부분의 노드 레벨 설정은 동적으로 설정 될 수 없습니다 (개별적으로 대상을 지정할 수 없기 때문에).

이것은 인덱스 레벨 설정을 설정하는 데 사용하는 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 수를 제어하는 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
    }
  }
}

위의 예는 제공된 설정으로 색인을 작성합니다. 인덱스 _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 예제에 표시된 것과 동일한 변경 사항을 하나의 요청 또는 이들의 서브 세트로 기존의 모든 Index Settings 에 적용 할 수 있습니다.

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"
    }
  }
}