› › ›

Получение информации об измерении репозиториев

Возвращает информацию об измерении репозиториев кластера.

Запрос

GET /_nodes/<node_id>/_repositories_metering

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

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

Описание

Вы можете использовать API измерения репозиториев кластера для получения информации об измерении репозиториев в кластере.

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

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

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

Все дополнительные параметры узлов подробно описаны здесь.

Тело ответа

_nodes

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

Свойства _nodes

total: (целое число) Общее количество узлов, выбранных запросом.
successful: (целое число) Количество узлов, успешно ответивших на запрос.
failed: (целое число) Количество узлов, отклонивших запрос или не ответивших. Если это значение не 0, причина отклонения или ошибки указана в ответе.

cluster_name

(строка) Название кластера. Основано на настройке названия кластера.

nodes

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

Свойства nodes

<node_id>

(массив) Массив с информацией о замерах репозитория для узла.

Свойства объектов в node_id

repository_name

(строка) Название репозитория.

repository_type

(строка) Тип репозитория.

repository_location

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

Свойства repository_location для типа репозитория Azure

base_path: (строка) Путь внутри контейнера, где репозиторий хранит данные.
container: (строка) Имя контейнера.

Свойства repository_location для типа репозитория GCP

base_path: (строка) Путь внутри ведра, где репозиторий хранит данные.
bucket: (строка) Имя ведра.

Свойства repository_location для типа репозитория S3

base_path: (строка) Путь внутри ведра, где репозиторий хранит данные.
bucket: (строка) Имя ведра.

repository_ephemeral_id

(строка) Идентификатор, меняющийся при каждом обновлении репозитория.

repository_started_at

(длинное целое число) Время создания или обновления репозитория. Записано в миллисекундах с момента эпохи Unix.

repository_stopped_at

(необязательно, длинное целое число) Время удаления или обновления репозитория. Записано в миллисекундах с момента эпохи Unix.

archived

(логическое значение) Флаг, указывающий, был ли данный объект архивирован. При закрытии или обновлении репозитория информация о замерах репозитория архивируется и хранится в течение определенного периода. Это позволяет извлечь информацию о замерах репозитория предыдущих инстанциаций.

cluster_version

(необязательно, длинное целое число) Версия состояния кластера, когда этот объект был архивирован; это поле может использоваться в качестве логического временного отметки для удаления всех архивированных метрик до наблюдаемой версии. Это поле присутствует только для архивированных объектов информации о замерах репозитория. Основное назначение этого поля — предотвратить возможные гонки при удалении информации о замерах репозитория, т. е. удаление архивированных метрик репозитория, которые мы еще не наблюдали.

request_counts

(объект) Объект с количеством запросов к репозиторию, сгруппированных по типу запроса.

Свойства request_counts для типа репозитория Azure

GetBlobProperties: (длинное целое число) Количество запросов Get Blob Properties.
GetBlob: (длинное целое число) Количество запросов Get Blob.
ListBlobs: (длинное целое число) Количество запросов List Blobs.
PutBlob: (длинное целое число) Количество запросов Put Blob.
PutBlock: (длинное целое число) Количество запросов Put Block.
PutBlockList: (длинное целое число) Количество запросов Put Block List.

Цены Azure Storage: https://azure.microsoft.com/en-us/pricing/details/storage/blobs/

Свойства request_counts для типа репозитория GCP

GetObject: (длинное целое число) Количество запросов get object.
ListObjects: (длинное целое число) Количество запросов list objects.
InsertObject: (длинное целое число) Количество запросов insert object, включая простые, многочастотные и поддерживающие возобновление загрузки. Загрузки с возобновлением могут выполнять несколько HTTP-запросов для добавления одного объекта, но они считаются одним запросом, поскольку они оплачиваются как отдельная операция.

Цены Google Cloud Storage: https://cloud.google.com/storage/pricing

Свойства request_counts для типа репозитория S3

GetObject: (длинное целое число) Количество запросов GetObject.
ListObjects: (длинное целое число) Количество запросов ListObjects.
PutObject: (длинное целое число) Количество запросов PutObject.
PutMultipartObject: (длинное целое число) Количество многочастотных запросов, включая CreateMultipartUpload, UploadPart и CompleteMultipartUpload.

Цены Amazon Web Services S3: https://aws.amazon.com/s3/pricing/

© 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/8.17/get-repositories-metering-api.html

END_OF_DOCUMENT_MARKER