Настройки OpenSearch - Настройки кластера, индекса и узла

В OpenSearch можно настроить параметры на уровне кластера, на уровне узла и на уровне индекса. Ниже приводится краткое описание каждого уровня.

Содержание

Настройки кластера

Эти настройки могут быть:

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

При сбросе переходных настроек применяется первое из заданных значений:

Постоянная настройка
Значение в конфигурационном файле
Значение по умолчанию

Порядок приоритета для настроек кластера следующий:

Переходные настройки кластера
Постоянные настройки кластера
Настройки в конфигурационном файле opensearch.yml

Примеры

Пример обновления настроек постоянного кластера:

PUT /_cluster/settings
{
"persistent" : {
"indices.recovery.max_bytes_per_sec" : "500mb"
}
}

PUT /_cluster/settings

{

"persistent" : {

"indices.recovery.max_bytes_per_sec" : "500mb"

}

Пример переходного обновления:

PUT /_cluster/settings
{
"transient" : {
"indices.recovery.max_bytes_per_sec" : "40mb"
}
}

PUT /_cluster/settings

{

"transient" : {

"indices.recovery.max_bytes_per_sec" : "40mb"

}

Настройки индексов

Это настройки, которые применяются к отдельным индексам. Для обновления настроек на уровне индексов существует API.

Примеры

Следующий вызов API установит для индекса my_index число шардов-реплик равным 5.

PUT /my_index/_settings
{
"index" : {
"number_of_replicas" : 5 
}
}

PUT /my_index/_settings

{

"index" : {

"number_of_replicas" : 5

}

Чтобы вернуть настройку к значению по умолчанию, используйте null.

PUT /my_index/_settings
{
"index" : {
"refresh_interval" : null
}
}

PUT /my_index/_settings

{

"index" : {

"refresh_interval" : null

}

Настройки узла

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

Примеры

Установка узла в качестве узла данных (в файле opensearch.yml):

node.data: true

1	node.data: true

Отключение роли ingest для узла (которая включена по умолчанию):

node.ingest: false

1	node.ingest: false

Для производственных кластеров необходимо запускать каждый тип узлов на выделенной машине с двумя или более экземплярами каждого из них для обеспечения HA (минимум три для мастер-узлов).

Примечания и полезные сведения

Изучение настроек кластера и индекса очень важно - это может избавить вас от многих проблем. Например, если вы собираетесь поместить в индекс огромное количество данных, а число реплик шардов установлено, скажем, на 5, то процесс индексирования будет очень медленным, поскольку данные будут реплицироваться одновременно с индексированием. Для ускорения индексирования можно установить число шардов-реплик в 0 путем обновления настроек, а по окончании индексирования вернуть его к исходному числу, используя API настроек.
Другим полезным примером использования настроек на уровне кластера является ситуация, когда узел только что присоединился к кластеру, а кластер не назначил ему ни одного шарда. Хотя распределение шардов включено по умолчанию на всех узлах, кто-то мог отключить распределение шардов в какой-то момент (например, для выполнения скользящего перезапуска) и забыть включить его снова. Чтобы включить выделение шардов, можно обновить API настроек кластера:

PUT /_cluster/settings {"transient":{"cluster.routing.allocation.enable": "all"}}

1
2

PUT /_cluster/settings
{"transient":{"cluster.routing.allocation.enable": "all"}}
Лучше задавать общекластерные настройки с помощью Settings API, а не в файле opensearch.yml, и использовать этот файл только для локальных изменений. Это позволит сохранить одинаковые настройки на всех узлах. Однако если случайно задать разные настройки на разных узлах с помощью конфигурационного файла opensearch.yml, то заметить эти несоответствия будет сложно.