› › ›

Агрегация подсчета значений

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

Агрегация подсчета значений не удаляет дубликаты, поэтому даже если поле содержит дубликаты, каждое значение будет учитываться индивидуально.

POST /sales/_search?size=0
{
  "aggs" : {
    "types_count" : { "value_count" : { "field" : "type" } }
  }
}

Ответ:

{
  ...
  "aggregations": {
    "types_count": {
      "value": 7
    }
  }
}

Имя агрегации (types_count выше) также служит ключом, по которому результат агрегации можно получить из возвращенного ответа.

Скрипт

Если вам нужно подсчитать что-то более сложное, чем значения в одном поле, вы должны выполнить агрегацию по полю runtime.

POST /sales/_search
{
  "size": 0,
  "runtime_mappings": {
    "tags": {
      "type": "keyword",
      "script": """
        emit(doc['type'].value);
        if (doc['promoted'].value) {
          emit('hot');
        }
      """
    }
  },
  "aggs": {
    "tags_count": {
      "value_count": {
        "field": "tags"
      }
    }
  }
}

Поля гистограмм

Когда агрегация подсчета значений вычисляется по полям гистограмм, результатом агрегации является сумма всех чисел в массиве counts гистограммы.

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

PUT metrics_index/_doc/1
{
  "network.name" : "net-1",
  "latency_histo" : {
      "values" : [0.1, 0.2, 0.3, 0.4, 0.5],
      "counts" : [3, 7, 23, 12, 6] 
   }
}

PUT metrics_index/_doc/2
{
  "network.name" : "net-2",
  "latency_histo" : {
      "values" :  [0.1, 0.2, 0.3, 0.4, 0.5],
      "counts" : [8, 17, 8, 7, 6] 
   }
}

POST /metrics_index/_search?size=0
{
  "aggs": {
    "total_requests": {
      "value_count": { "field": "latency_histo" }
    }
  }
}

Для каждого поля гистограммы агрегация подсчета значений просуммирует все числа в массиве counts <1>. В конечном итоге она добавит все значения для всех гистограмм и вернет следующий результат:

{
  ...
  "aggregations": {
    "total_requests": {
      "value": 97
    }
  }
}

© 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/search-aggregations-metrics-valuecount-aggregation.html