› › ›

API cat allocation

API cat предназначены только для использования человеком через командную строку или консоль Kibana. Они не предназначены для использования приложениями.

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

Запрос

GET /_cat/allocation/<node_id>

GET /_cat/allocation

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

Если функции безопасности Elasticsearch включены, у вас должно быть разрешение monitor или manage разрешение кластера для использования этого API.

Параметры пути

<node_id>: (Необязательно, строка) Список узлов через запятую, идентификаторы или имена узлов, используемые для ограничения возвращаемой информации.

Параметры запроса

bytes: (Необязательно, единицы измерения размера байтов) Единица измерения, используемая для отображения значений байтов.
format: (Необязательно, строка) Короткая версия заголовка HTTP accept. Допустимые значения включают JSON, YAML и т. д.
local: (Необязательно, логическое значение) Если true, запрос извлекает информацию только с локального узла. По умолчанию false, что означает, что информация извлекается с главного узла.
master_timeout: (Необязательно, единицы измерения времени) Время ожидания подключения к главному узлу. Если ответ не получен до истечения времени ожидания, запрос завершается ошибкой и возвращает ошибку. По умолчанию 30s.
h: (Необязательно, строка) Список столбцов через запятую, подлежащих отображению.
help: (Необязательно, логическое значение) Если true, в ответ включается справочная информация. По умолчанию false.
s: (Необязательно, строка) Список столбцов через запятую или псевдонимов столбцов, используемых для сортировки ответа.
v: (Необязательно, логическое значение) Если true, в ответ включаются заголовки столбцов. По умолчанию false.

Тело ответа

shards

Количество первичных и реплицированных фрагментов, назначенных узлу.

disk.indices

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

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

disk.used

Общее дисковое пространство, используемое. Elasticsearch получает эту метрику из операционной системы (ОС) узла. Метрика включает дисковое пространство для:

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

В отличие от disk.indices, эта метрика не удваивает дисковое пространство для жёстко связанных файлов.

disk.avail

Свободное дисковое пространство, доступное для Elasticsearch. Elasticsearch получает эту метрику из операционной системы узла. Распределение фрагментов на основе диска использует эту метрику для назначения фрагментов узлам на основе доступного дискового пространства.

disk.total

Общее дисковое пространство для узла, включая используемое и доступное пространство.

disk.percent

Общий процент используемого дискового пространства. Вычисляется как disk.used / disk.total.

host

Сетевой хост для узла. Устанавливается с помощью network.host.

ip

IP-адрес и порт узла.

node

Имя узла. Устанавливается с помощью node.name.

Примеры

GET /_cat/allocation?v=true

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

shards disk.indices disk.used disk.avail disk.total disk.percent host      ip        node
     1         260b    47.3gb     43.4gb    100.7gb           46 127.0.0.1 127.0.0.1 CSUXak2

Этот ответ показывает, что один фрагмент назначен одному доступному узлу.

© 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/cat-allocation.html