› › ›

API статистики потоков данных

Получает статистику для одного или нескольких потоков данных.

GET /_data_stream/my-data-stream/_stats

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

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

Запрос

GET /_data_stream/<data-stream>/_stats

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

<data-stream>

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

Для обращения ко всем потокам данных в кластере опустите этот параметр или используйте *.

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

expand_wildcards

(Необязательно, строка) Тип потока данных, которому могут соответствовать шаблоны с подстановкой. Поддерживаются значения, разделенные запятыми, такие как open,hidden. Допустимые значения:

all, hidden: Соответствует любому потоку данных, включая скрытые.
open, closed: Соответствует любому нескрытому потоку данных. Потоки данных не могут быть закрыты.
none: Шаблоны с подстановкой не принимаются.

По умолчанию open.

human

(Необязательно, логическое значение) Если true, ответ включает статистику в читаемом формате с единицами измерения байтов. По умолчанию false.

Тело ответа

_shards

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

Свойства _shards

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

data_stream_count

(целое число) Общее количество выбранных потоков данных.

backing_indices

(целое число) Общее количество баз данных для выбранных потоков данных.

total_store_size

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

total_store_size_bytes

(целое число) Общий размер в байтах всех фрагментов для выбранных потоков данных.

data_streams

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

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

data_stream

(строка) Имя потока данных.

backing_indices

(целое число) Текущее количество баз данных для потока данных.

store_size

(значение байта) Общий размер всех фрагментов для индексов поддержки потока данных. Этот параметр возвращается только если параметр запроса human равен true.

store_size_bytes

(целое число) Общий размер в байтах всех фрагментов для индексов поддержки потока данных.

maximum_timestamp

(целое число) Максимальное значение @timestamp потока данных, преобразованное в миллисекунды с момента эпохи Unix.

Эта метка времени предоставляется как наилучшая оценка. Поток данных может содержать значения @timestamp, превышающие это значение, если выполняются одно или несколько из следующих условий:

Поток содержит закрытые индексы поддержки.
Индексы поддержки с более низкой генерацией содержат более высокие значения @timestamp.

Примеры

GET /_data_stream/my-data-stream*/_stats?human=true

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

{
  "_shards": {
    "total": 10,
    "successful": 5,
    "failed": 0
  },
  "data_stream_count": 2,
  "backing_indices": 5,
  "total_store_size": "7kb",
  "total_store_size_bytes": 7268,
  "data_streams": [
    {
      "data_stream": "my-data-stream",
      "backing_indices": 3,
      "store_size": "3.7kb",
      "store_size_bytes": 3772,
      "maximum_timestamp": 1607512028000
    },
    {
      "data_stream": "my-data-stream-two",
      "backing_indices": 2,
      "store_size": "3.4kb",
      "store_size_bytes": 3496,
      "maximum_timestamp": 1607425567000
    }
  ]
}

© 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/data-stream-stats-api.html