Настройка Elasticsearch

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

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

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

Эти файлы находятся в каталоге config, местоположение которого по умолчанию зависит от того, устанавливается ли Elasticsearch из архива (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"

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