Агрегация автоинтервального гистограммы дат

Внутренне дата представлена как 64-битное число, представляющее отметку времени в миллисекундах с начала эпохи. Эти отметки времени возвращаются как значения полей корзин. key — это та же отметка времени, преобразованная в отформатированную строку даты с использованием формата, указанного с помощью параметра format:

POST /sales/_search?size=0
{
  "aggs": {
    "sales_over_time": {
      "auto_date_histogram": {
        "field": "date",
        "buckets": 5,
        "format": "yyyy-MM-dd" 
      }
    }
  }
}

Ответ:

{
  ...
  "aggregations": {
    "sales_over_time": {
      "buckets": [
        {
          "key_as_string": "2015-01-01",
          "key": 1420070400000,
          "doc_count": 3
        },
        {
          "key_as_string": "2015-02-01",
          "key": 1422748800000,
          "doc_count": 2
        },
        {
          "key_as_string": "2015-03-01",
          "key": 1425168000000,
          "doc_count": 2
        }
      ],
      "interval": "1M"
    }
  }
}

Интервал возвращаемых корзин выбирается на основе данных, собранных агрегацией, таким образом, что количество возвращенных корзин меньше или равно запрошенному значению. Возможные возвращаемые интервалы:

В худшем случае, когда количество ежедневных корзин слишком велико для запрошенного количества корзин, количество возвращенных корзин составит 1/7 от запрошенного количества корзин.

Даты и время хранятся в Elasticsearch в UTC. По умолчанию, все группирование и округление также выполняется в UTC. Параметр time_zone может быть использован для указания, что группирование должно использовать другую временную зону.

Временные зоны могут быть указаны как смещение UTC в формате ISO 8601 (например, +01:00 или -08:00) или как идентификатор временной зоны, используемый в базе данных TZ, например, America/Los_Angeles.

Рассмотрим следующий пример:

PUT my-index-00001/log/1?refresh
{
  "date": "2015-10-01T00:30:00Z"
}

PUT my-index-00001/log/2?refresh
{
  "date": "2015-10-01T01:30:00Z"
}

PUT my-index-00001/log/3?refresh
{
  "date": "2015-10-01T02:30:00Z"
}

GET my-index-00001/_search?size=0
{
  "aggs": {
    "by_day": {
      "auto_date_histogram": {
        "field":     "date",
        "buckets" : 3
      }
    }
  }
}

Если временная зона не указана, используется UTC, возвращаются три корзины по 1 часу, начиная с полуночи UTC 1 октября 2015 года:

{
  ...
  "aggregations": {
    "by_day": {
      "buckets": [
        {
          "key_as_string": "2015-10-01T00:00:00.000Z",
          "key": 1443657600000,
          "doc_count": 1
        },
        {
          "key_as_string": "2015-10-01T01:00:00.000Z",
          "key": 1443661200000,
          "doc_count": 1
        },
        {
          "key_as_string": "2015-10-01T02:00:00.000Z",
          "key": 1443664800000,
          "doc_count": 1
        }
      ],
      "interval": "1h"
    }
  }
}

Если указано time_zone в -01:00, то полуночь начинается за час до полуночи UTC:

GET my-index-00001/_search?size=0
{
  "aggs": {
    "by_day": {
      "auto_date_histogram": {
        "field":     "date",
        "buckets" : 3,
        "time_zone": "-01:00"
      }
    }
  }
}

Сейчас по-прежнему возвращаются три корзины по 1 часу, но первая корзина начинается в 23:00 30 сентября 2015 года, поскольку это местное время для корзины в указанной временной зоне.

{
  ...
  "aggregations": {
    "by_day": {
      "buckets": [
        {
          "key_as_string": "2015-09-30T23:00:00.000-01:00", 
          "key": 1443657600000,
          "doc_count": 1
        },
        {
          "key_as_string": "2015-10-01T00:00:00.000-01:00",
          "key": 1443661200000,
          "doc_count": 1
        },
        {
          "key_as_string": "2015-10-01T01:00:00.000-01:00",
          "key": 1443664800000,
          "doc_count": 1
        }
      ],
      "interval": "1h"
    }
  }
}

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

Допустимые единицы измерения для minimum_interval:

POST /sales/_search?size=0
{
  "aggs": {
    "sale_date": {
      "auto_date_histogram": {
        "field": "date",
        "buckets": 10,
        "minimum_interval": "minute"
      }
    }
  }
}

Параметр missing определяет, как обрабатывать документы, у которых отсутствует значение. По умолчанию они будут проигнорированы, но также можно рассматривать их как имеющие значение.

POST /sales/_search?size=0
{
  "aggs": {
    "sale_date": {
      "auto_date_histogram": {
        "field": "date",
        "buckets": 10,
        "missing": "2000/01/01" 
      }
    }
  }
}