› › ›

API получения емкости автомасштабирования

Данная функция предназначена для косвенного использования службой Elasticsearch Service, Elastic Cloud Enterprise и Elastic Cloud на Kubernetes. Прямое использование не поддерживается.

Получение емкости автомасштабирования.

Запрос

GET /_autoscaling/capacity/

Предварительные условия

Если включены функции безопасности Elasticsearch, необходимо иметь manage_autoscaling права доступа к кластеру. Дополнительная информация представлена в разделе Права доступа к безопасности.

Описание

Этот API получает текущую емкость автомасштабирования, основываясь на настроенной политике автомасштабирования. Этот API вернёт информацию для соответствующего масштабирования кластера текущей рабочей нагрузке.

required_capacity рассчитывается как максимальное значение из результата required_capacity всех включённых решающих механизмов для политики.

Оператор должен проверить, что current_nodes соответствуют его знаниям о кластере, чтобы избежать принятия решений об автомасштабировании на основе устаревшей или неполной информации.

Ответ содержит информацию, специфичную для решающих механизмов, которую можно использовать для диагностики того, как и почему автомасштабирование определило необходимую определённую емкость. Эта информация предоставляется только для диагностики. Не используйте эту информацию для принятия решений об автомасштабировании.

Тело ответа

policies

(объект) Содержит карту имени политики к результату емкости

Свойства policies

<policy_name>

(объект) Содержит информацию о емкости для политики

Свойства <policy_name>

required_capacity

(объект) Содержит необходимую емкость для политики.

Свойства required_capacity

node

(объект) Содержит минимальные размеры узлов, необходимые на узел, гарантируя, что отдельные фрагменты или задачи машинного обучения могут поместиться на один узел.

Свойства node

storage: (целое число) Объем хранилища, необходимый на узел.
memory: (целое число) Объем памяти, необходимый на узел.

total

(объект) Содержит общий размер, необходимый для политики.

Свойства total

storage: (целое число) Общий объем хранилища, необходимый для политики.
memory: (целое число) Общий объем памяти, необходимый для политики.

current_capacity

(объект) Содержит текущую емкость узлов, управляемых политикой, т.е. узлов, на основе которых Elasticsearch производит свои расчёты.

Свойства current_capacity

node

(объект) Содержит максимальные размеры узлов, управляемых политикой.

Свойства node

storage: (целое число) Максимальный объем хранилища узла.
memory: (целое число) Максимальный объем памяти узла.

total

(объект) Содержит текущие общие размеры хранилища и памяти для узлов, управляемых политикой.

Свойства total

storage: (целое число) Текущий объём хранилища, доступный для политики.
memory: (целое число) Текущий объём памяти, доступный для политики.

current_nodes

(массив объектов) Список узлов, используемых для расчета емкости.

Свойства элементов в current_nodes

name: (строка) Название узла.

deciders

(объект) Результаты емкости от отдельных решающих механизмов, позволяющие получить представление о том, как был рассчитан внешний уровень required_capacity.

Свойства deciders

<decider_name>

(объект) Результат емкости для определенного решающего механизма, включенного в политику.

Свойства <decider_name>

required_capacity

(объект) Необходимая емкость, определённая решающим механизмом.

Свойства required_capacity

node

Свойства node

storage: (целое число) Объем хранилища, необходимый на узел.
memory: (целое число) Объем памяти, необходимый на узел.

total

(объект) Содержит общий размер, необходимый для политики.

Свойства total

storage: (целое число) Общий объем хранилища, необходимый для политики.
memory: (целое число) Общий объем памяти, необходимый для политики.

reason_summary

(строка) Описание основы результата решающего механизма.

reason_details

(объект) Структура на уровне решающего механизма, содержащая подробности об основе результата решающих механизмов. Содержание не должно использоваться для приложений и не гарантирует обратной совместимости.

Примеры

В этом примере извлекается текущая емкость автомасштабирования.

GET /_autoscaling/capacity

API возвращает следующий результат:

{
  policies: {}
}

© 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/7.17/autoscaling-get-autoscaling-capacity.html