› › ›

Настройки обнаружения и формирования кластера

Обнаружение и формирование кластера зависят от следующих настроек:

discovery.seed_hosts

(Статический) Предоставляет список адресов узлов кластера, имеющих право быть мастерами. Также может быть одной строкой, содержащей адреса, разделенные запятыми. Каждый адрес имеет формат host:port или host. host — это имя хоста для разрешения по DNS, IPv4-адрес или IPv6-адрес. IPv6-адреса должны быть заключены в квадратные скобки. Если имя хоста разрешается по DNS до нескольких адресов, Elasticsearch использует все из них. Поиск по DNS подвержен влиянию кеширования DNS в JVM. Если port не задано, оно определяется путем проверки следующих настроек в порядке:

transport.profiles.default.port
transport.port

Если ни одна из них не задана, используется порт по умолчанию — 9300. Значение по умолчанию для discovery.seed_hosts — ["127.0.0.1", "[::1]"]. См. discovery.seed_hosts.

discovery.seed_providers

(Статический) Указывает, какие типы поставщиков узлов-семян использовать для получения адресов узлов-семян, используемых для запуска процесса обнаружения. По умолчанию используется поставщик на основе настроек, который получает адреса узлов-семян из настройки discovery.seed_hosts.

discovery.type

(Статический) Указывает, должен ли Elasticsearch формировать кластер из нескольких узлов. По умолчанию значение — multi-node, что означает, что Elasticsearch обнаруживает другие узлы при формировании кластера и позволяет другим узлам присоединиться к кластеру позже. Если значение установлено как single-node, Elasticsearch формирует одноузловой кластер и подавляет таймаут, установленный в cluster.publish.timeout. Более подробную информацию о ситуациях, когда может потребоваться использовать эту настройку, см. в Раздел об обнаружении в одноузловом режиме.

cluster.initial_master_nodes

(Статический) Устанавливает начальный набор узлов, имеющих право быть мастерами, в новом кластере. По умолчанию этот список пустой, что означает, что этот узел ожидает присоединения к кластеру, который уже был запущен. Удалите эту настройку после того, как кластер сформируется, и не устанавливайте ее для этого кластера больше никогда. Не настраивайте эту настройку на узлах, не имеющих права быть мастерами. Не настраивайте эту настройку на узлах, присоединяющихся к существующему кластеру. Не настраивайте эту настройку на перезапускаемых узлах. Не настраивайте эту настройку при полном перезапуске кластера. См. cluster.initial_master_nodes.

Экспертные настройки

На обнаружение и формирование кластера также влияют следующие экспертные настройки, хотя изменение их значений с установок по умолчанию не рекомендуется.

Если вы измените эти настройки, ваш кластер может не сформироваться должным образом или может стать нестабильным или непереносимым к определенным сбоям.

discovery.cluster_formation_warning_timeout: (Статический) Устанавливает, как долго узел будет пытаться сформировать кластер, прежде чем вывести предупреждение о том, что кластер не сформировался. По умолчанию значение равно 10s. Если кластер не сформировался после истечения discovery.cluster_formation_warning_timeout, то узел выведет сообщение с предупреждением, начинающееся с фразы master not discovered, которая описывает текущее состояние процесса обнаружения.
discovery.find_peers_interval: (Статический) Устанавливает, как долго узел будет ждать, прежде чем попытаться выполнить еще один раунд обнаружения. По умолчанию значение равно 1s.
discovery.probe.connect_timeout: (Статический) Устанавливает время ожидания при попытке подключения к каждому адресу. По умолчанию значение равно 30s.
discovery.probe.handshake_timeout: (Статический) Устанавливает время ожидания при попытке идентификации удаленного узла с помощью рукопожатия. По умолчанию значение равно 30s.
discovery.request_peers_timeout: (Статический) Устанавливает время ожидания узла после повторного запроса к его узлам-пирам, прежде чем считать запрос неудавшимся. По умолчанию значение равно 3s.
discovery.find_peers_warning_timeout: (Статический) Устанавливает время ожидания узла при попытке обнаружить своих узлов-пиров перед началом вывода подробных сообщений, описывающих причины неудачных попыток подключения. По умолчанию значение равно 3m.
discovery.seed_resolver.max_concurrent_resolvers: (Статический) Указывает количество одновременных запросов DNS для разрешения адресов узлов-семян. По умолчанию значение равно 10.
discovery.seed_resolver.timeout: (Статический) Указывает время ожидания для каждого запроса DNS при разрешении адресов узлов-семян. По умолчанию значение равно 5s.
cluster.auto_shrink_voting_configuration: (Динамический) Управляет тем, удаляет ли настройка голосования ушедшие узлы автоматически, при условии, что в ней по-прежнему содержится не менее 3 узлов. Значение по умолчанию — true. Если установлено значение false, настройка голосования никогда не уменьшается автоматически, и вам необходимо вручную удалить ушедшие узлы с помощью API исключений конфигурации голосования.
cluster.election.back_off_time: (Статический) Устанавливает величину увеличения верхней границы ожидания перед выборами при каждой неудачной попытке выборов. Обратите внимание, что это линейное отложенное выполнение. По умолчанию значение равно 100ms. Изменение этого параметра от значения по умолчанию может привести к тому, что ваш кластер не выберет узла-мастера.
cluster.election.duration: (Статический) Устанавливает, как долго каждый этап выборов может длиться, прежде чем узел сочтет его неудачным и запланирует повторную попытку. По умолчанию значение равно 500ms. Изменение этого параметра от значения по умолчанию может привести к тому, что ваш кластер не выберет узла-мастера.
cluster.election.initial_timeout: (Статический) Устанавливает верхнюю границу времени, которое узел будет ожидать первоначально или после отказа выбранного узла-мастера, прежде чем попытаться провести свои первые выборы. По умолчанию значение равно 100ms. Изменение этого параметра от значения по умолчанию может привести к тому, что ваш кластер не выберет узла-мастера.
cluster.election.max_timeout: (Статический) Устанавливает максимальную верхнюю границу времени, которое узел будет ожидать, прежде чем попытаться провести первые выборы, чтобы сетевой разрыв, длившийся долгое время, не приводил к чрезмерно редким выборам. По умолчанию значение равно 10s. Изменение этого параметра от значения по умолчанию может привести к тому, что ваш кластер не выберет узла-мастера.
cluster.fault_detection.follower_check.interval: (Статический) Устанавливает время ожидания выбранного узла-мастера между проверками подчиненных узлов друг другу в кластере. По умолчанию значение равно 1s. Изменение этого параметра от значения по умолчанию может привести к нестабильности вашего кластера.
cluster.fault_detection.follower_check.timeout: (Статический) Устанавливает время ожидания выбранного узла-мастера ответа от подчиненного узла, прежде чем считать его проваленным. По умолчанию значение равно 10s. Изменение этого параметра от значения по умолчанию может привести к нестабильности вашего кластера.
cluster.fault_detection.follower_check.retry_count: (Статический) Устанавливает количество последовательных неудач в проверке подчиненных узлов каждому узлу, прежде чем выбранный узел-мастер сочтет этот узел неисправным и удалит его из кластера. По умолчанию значение равно 3. Изменение этого параметра от значения по умолчанию может привести к нестабильности вашего кластера.
cluster.fault_detection.leader_check.interval: (Статический) Устанавливает время ожидания каждого узла между проверками выбранного узла-мастера. По умолчанию значение равно 1s. Изменение этого параметра от значения по умолчанию может привести к нестабильности вашего кластера.
cluster.fault_detection.leader_check.timeout: (Статический) Устанавливает время ожидания каждого узла ответа на проверку лидера от выбранного узла-мастера, прежде чем считать его неудачным. По умолчанию значение равно 10s. Изменение этого параметра от значения по умолчанию может привести к нестабильности вашего кластера.
cluster.fault_detection.leader_check.retry_count: (Статический) Устанавливает количество последовательных сбоев проверки лидера, которое должно произойти, прежде чем узел сочтет выбранного узла-мастера неисправным и попытается найти или выбрать нового мастера. По умолчанию значение равно 3. Изменение этого параметра от значения по умолчанию может привести к нестабильности вашего кластера.
cluster.follower_lag.timeout: (Статический) Устанавливает время ожидания узла-мастера для получения подтверждений обновлений состояния кластера от отстающих узлов. Значение по умолчанию равно 90s. Если узел не успешно применяет обновление состояния кластера в течение этого периода времени, он считается неисправным и удаляется из кластера. См. Опубликование состояния кластера.
cluster.max_voting_config_exclusions: (Динамический) Устанавливает ограничение на количество исключений конфигурации голосования в любой момент времени. Значение по умолчанию равно 10. См. Добавление и удаление узлов в кластере.
cluster.publish.info_timeout: (Статический) Устанавливает время ожидания узла-мастера для завершения публикации каждого обновления состояния кластера для всех узлов, прежде чем выводить сообщение о том, что некоторые узлы реагируют медленно. Значение по умолчанию — 10s.
cluster.publish.timeout: (Статический) Устанавливает время ожидания узла-мастера для завершения публикации каждого обновления состояния кластера для всех узлов, если discovery.type не установлено значение single-node. Значение по умолчанию равно 30s. См. Опубликование состояния кластера.
cluster.discovery_configuration_check.interval: (Статический) Устанавливает интервал некоторых проверок, которые будут выводить предупреждения об ошибочной конфигурации обнаружения. Значение по умолчанию — 30s.
cluster.join_validation.cache_timeout: (Статический) Когда узел запрашивает присоединение к кластеру, выбранный узел-мастер отправляет ему копию недавнего состояния кластера для обнаружения определенных проблем, которые могут помешать новому узлу присоединиться к кластеру. Мастер кэширует отправляемое состояние и использует кэшированное состояние, если другой узел присоединяется к кластеру вскоре после этого. Этот параметр управляет тем, как долго мастер ожидает, прежде чем очистить этот кэш. По умолчанию значение равно 60s.

cluster.no_master_block

(Динамический) Определяет, какие операции отклоняются, когда в кластере нет активного лидера. Это свойство имеет три допустимых значения:

all: Все операции на узле (как чтение, так и запись) отклоняются. Это также относится к операциям чтения или записи состояния кластера API, например, чтение настроек индекса, обновление отображения и API состояния кластера.
write: (по умолчанию) Операции записи отклоняются. Операции чтения завершаются успешно на основе последней известной конфигурации кластера. В этом случае могут произойти частичные чтения устаревших данных, так как этот узел может быть изолирован от остальной части кластера.
metadata_write: Отклоняются только операции записи метаданных (например, обновления отображения, изменения таблицы маршрутизации), но обычные операции индексирования продолжают работать. Операции чтения и записи завершаются успешно на основе последней известной конфигурации кластера. В этом случае могут произойти частичные чтения устаревших данных, так как этот узел может быть изолирован от остальной части кластера.

Параметр cluster.no_master_block не применяется к API, основанным на узлах (например, API статистики кластера, информации об узле и статистике узла). Запросы к этим API не блокируются и могут выполняться на любом доступном узле.
Для полной работоспособности кластера требуется активный мастер.

monitor.fs.health.enabled

(Динамический) Если true, узел выполняет периодические проверки состояния файловой системы. По умолчанию true.

monitor.fs.health.refresh_interval

(Статический) Интервал между последовательными проверками состояния файловой системы. По умолчанию 2m.

monitor.fs.health.slow_path_logging_threshold

(Динамический) Если проверка состояния файловой системы занимает больше времени, чем этот порог, Elasticsearch записывает предупреждение в журналы. По умолчанию 5s.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/modules-discovery-settings.html