API состояния кластера

GET /_cluster/state/<metrics>/<target>

Состояние кластера — это внутренняя структура данных, которая отслеживает различные сведения, необходимые каждому узлу, включая:

Избранный мастер-узел гарантирует, что каждый узел в кластере имеет копию одного и того же состояния кластера. API состояния кластера позволяет получить представление об этом внутреннем состоянии для отладки или диагностики. Возможно, вам потребуется обратиться к исходному коду Elasticsearch, чтобы определить точный смысл ответа.

По умолчанию API состояния кластера будет перенаправлять запросы на избранный мастер-узел, так как этот узел является авторитетным источником состояния кластера. Вы также можете получить состояние кластера, хранящееся на узле, обрабатывающем запрос API, добавив параметр запроса ?local=true.

Elasticsearch может потребовать значительных усилий для вычисления ответа на этот API в больших кластерах, и ответ может содержать очень большое количество данных. Если вы используете этот API многократно, ваш кластер может стать нестабильным.

Состояние кластера может быть очень большим, и Elasticsearch может потреблять значительные ресурсы при вычислении ответа на этот API. Чтобы уменьшить размер ответа, вы можете запросить только интересующую вас часть состояния кластера:

Следующий пример возвращает только metadata и routing_table данные для потоков данных или индексов foo и bar:

resp = client.cluster.state(
    metric="metadata,routing_table",
    index="foo,bar",
)
print(resp)

response = client.cluster.state(
  metric: 'metadata,routing_table',
  index: 'foo,bar'
)
puts response

const response = await client.cluster.state({
  metric: "metadata,routing_table",
  index: "foo,bar",
});
console.log(response);

GET /_cluster/state/metadata,routing_table/foo,bar

Следующий пример возвращает все доступные метаданные для foo и bar:

resp = client.cluster.state(
    metric="_all",
    index="foo,bar",
)
print(resp)

response = client.cluster.state(
  metric: '_all',
  index: 'foo,bar'
)
puts response

const response = await client.cluster.state({
  metric: "_all",
  index: "foo,bar",
});
console.log(response);

GET /_cluster/state/_all/foo,bar

Этот пример возвращает только метаданные blocks:

resp = client.cluster.state(
    metric="blocks",
)
print(resp)

response = client.cluster.state(
  metric: 'blocks'
)
puts response

const response = await client.cluster.state({
  metric: "blocks",
});
console.log(response);

GET /_cluster/state/blocks