API перенаправления кластера

POST /_cluster/reroute?metric=none

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

Важно отметить, что после обработки любых команд перенаправления Elasticsearch выполнит перебалансировку, как обычно (учитывая значения настроек, таких как cluster.routing.rebalance.enable), чтобы сохранить состояние баланса. Например, если запрошенное распределение включает перемещение фрагмента с node1 на node2, это может привести к перемещению фрагмента с node2 обратно на node1 для выравнивания.

Кластер может быть настроен на отключение распределения с помощью настройки cluster.routing.allocation.enable. Если распределение отключено, единственные распределения, которые будут выполняться, — это явные, заданные с помощью команды reroute, и последующие распределения из-за перебалансировки.

Возможна запуск команд reroute в режиме «сухого запуска» с помощью параметра запроса URI ?dry_run или передачей "dry_run": true в теле запроса. Это позволит рассчитать результат применения команд к текущему состоянию кластера и вернуть результирующее состояние кластера после применения команд (и перебалансировки), но фактически не выполнит запрошенные изменения.

Если включен параметр URI ?explain, в ответ будет включено подробное объяснение, почему команды могут быть или не могут быть выполнены.

Кластер попытается распределить фрагмент максимум index.allocation.max_retries раз подряд (по умолчанию 5), прежде чем отказаться и оставить фрагмент нераспределённым. Такая ситуация может быть вызвана структурными проблемами, такими как наличие анализатора, который ссылается на файл стоп-слов, которого нет на всех узлах.

После исправления проблемы распределение можно вручную повторить, вызвав API reroute с параметром URI ?retry_failed, что позволит выполнить одну попытку повторной обработки для этих фрагментов.

Вот короткий пример простого вызова API для перенаправления:

POST /_cluster/reroute?metric=none
{
  "commands": [
    {
      "move": {
        "index": "test", "shard": 0,
        "from_node": "node1", "to_node": "node2"
      }
    },
    {
      "allocate_replica": {
        "index": "test", "shard": 1,
        "node": "node3"
      }
    }
  ]
}