› › ›

Агрегирование временных рядов

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

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

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

Данные могут быть добавлены в индекс временных рядов, как и в другие индексы:

PUT /my-time-series-index-0/_bulk
{ "index": {} }
{ "key": "a", "val": 1, "@timestamp": "2022-01-01T00:00:10Z" }
{ "index": {}}
{ "key": "a", "val": 2, "@timestamp": "2022-01-02T00:00:00Z" }
{ "index": {} }
{ "key": "b", "val": 2, "@timestamp": "2022-01-01T00:00:10Z" }
{ "index": {}}
{ "key": "b", "val": 3, "@timestamp": "2022-01-02T00:00:00Z" }

Для выполнения агрегирования временных рядов укажите «time_series» в качестве типа агрегирования. Когда логическое значение «keyed» равно true, каждой корзине присваивается уникальный ключ.

GET /_search
{
  "aggs": {
    "ts": {
      "time_series": { "keyed": false }
    }
  }
}

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

Размер

По умолчанию агрегации time series возвращают 10000 результатов. Параметр «size» может быть использован для дальнейшего ограничения результатов. В качестве альтернативы, использование под-агрегаций может ограничить количество возвращаемых значений как агрегация временных рядов.

Ключевое

Параметр keyed определяет, возвращаются ли корзины в виде карты с уникальными ключами для каждой корзины. По умолчанию, при keyed установленном в false, корзины возвращаются в виде массива.

Ограничения

Агрегация time_series имеет множество ограничений. Многие оптимизации производительности агрегаций отключены при использовании агрегации time_series. Например, оптимизация фильтрации по фильтру или режим сбора breath first (terms и multi_terms агрегация принудительно использует режим сбора depth first).

Следующие агрегации также не работают, если используются в сочетании с агрегацией time_series: auto_date_histogram, variable_width_histogram, rare_terms, global, composite, sampler, random_sampler и diversified_sampler.

© 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/search-aggregations-bucket-time-series-aggregation.html