Elasticsearch
Конфигурация Elasticsearch

замечания

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

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

Настройки статического эластинга

Elasticsearch использует файл конфигурации YAML (еще один язык разметки), который можно найти внутри каталога 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 .

Постоянными настройками являются один из двух типов кластерного уровня, которые могут применяться. Устойчивая установка выживет полный перезапуск кластера.

Примечание. Не все настройки могут применяться динамически. Например, имя кластера не может быть переименовано динамически. Большинство настроек уровня узла нельзя установить динамически (поскольку они не могут быть нацелены индивидуально).

Это не API для установки параметров уровня индекса. Вы можете сказать, что это параметр уровня индекса, потому что он должен начинаться с index. , Настройки, имена которых указаны в виде 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 .

Параметры переходного процесса являются одним из двух типов кластерного уровня, которые могут применяться. Параметр переходного процесса не сможет полностью перезагрузить кластер.

Примечание. Не все настройки могут применяться динамически. Например, имя кластера не может быть переименовано динамически. Большинство настроек уровня узла нельзя установить динамически (поскольку они не могут быть нацелены индивидуально).

Это не API для установки параметров уровня индекса. Вы можете сказать, что это параметр уровня индекса, потому что он должен начинаться с index. , Настройки, имена которых указаны в виде 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. , Исключением из этого правила являются 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
    }
  }
}

В приведенных выше примерах будет создан индекс с предоставленными настройками. Вы можете динамически изменять настройки для каждого индекса, используя _settings точку _settings . Например, здесь мы динамически изменяем настройки медленного режима только для уровня предупреждения:

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 ко всем существующим индексам с одним запросом или даже подмножеством из них:

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