› › ›

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

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

Запрос

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 здесь.

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

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

Цены Google Cloud Storage здесь.

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

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

Amazon Web Services Simple Storage Service цены.

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

END_OF_DOCUMENT_MARKER