Настройка Elasticsearch

Elasticsearch поставляется с хорошими значениями по умолчанию и требует минимальной настройки. Большинство параметров можно изменить в работающем кластере с помощью API обновления настроек кластера.

Файлы конфигурации должны содержать настройки, специфичные для узла (например, node.name и пути), или настройки, необходимые узлу для присоединения к кластеру, такие как cluster.name и network.host.

Elasticsearch имеет три файла конфигурации:

Эти файлы находятся в каталоге config, расположение которого зависит от того, была ли установка из архива (tar.gz или zip) или из пакетированного дистрибутива (пакеты Debian или RPM).

Для дистрибутивов из архива расположение каталога config по умолчанию — $ES_HOME/config. Расположение каталога config можно изменить с помощью переменной среды ES_PATH_CONF следующим образом:

ES_PATH_CONF=/path/to/my/config ./bin/elasticsearch

В качестве альтернативы, вы можете export переменную среды ES_PATH_CONF через командную строку или профиль оболочки.

Для дистрибутивов из пакетов расположение каталога config по умолчанию — /etc/elasticsearch. Расположение каталога config также можно изменить с помощью переменной среды ES_PATH_CONF, но обратите внимание, что установка этой переменной в вашей оболочке недостаточна. Вместо этого эта переменная считывается из /etc/default/elasticsearch (для пакета Debian) и /etc/sysconfig/elasticsearch (для пакета RPM). Вам нужно будет отредактировать запись ES_PATH_CONF=/etc/elasticsearch в одном из этих файлов, чтобы изменить расположение каталога config.

Формат конфигурации — YAML. Вот пример изменения путей к каталогам данных и логов:

path:
    data: /var/lib/elasticsearch
    logs: /var/log/elasticsearch

Параметры также могут быть представлены в плоском формате:

path.data: /var/lib/elasticsearch
path.logs: /var/log/elasticsearch

В YAML вы можете форматировать нескалярные значения как последовательности:

discovery.seed_hosts:
   - 192.168.1.10:9300
   - 192.168.1.11
   - seeds.mydomain.com

Хотя это менее распространено, вы также можете форматировать нескалярные значения как массивы:

discovery.seed_hosts: ["192.168.1.10:9300", "192.168.1.11", "seeds.mydomain.com"]

Переменные окружения, указанные с помощью ${...} в файле конфигурации, будут заменены значением переменной окружения. Например:

node.name:    ${HOSTNAME}
network.host: ${ES_NETWORK_HOST}

Значения для переменных окружения должны быть простыми строками. Используйте строку, разделенную запятыми, для предоставления значений, которые Elasticsearch будет интерпретировать как список. Например, Elasticsearch разделит следующую строку на список значений для переменной среды ${HOSTNAME}:

export HOSTNAME="host1,host2"

Настройки кластера и узлов можно разделить по способу их настройки: