Briefly, this error occurs when Elasticsearch is unable to find the ‘doccount’ key in the response. This key is usually part of an aggregation query and its absence could be due to a malformed query or a change in the data structure. To resolve this issue, you can 1) Review your aggregation query to ensure it’s correctly formed. 2) Check your data structure to ensure it matches the query. 3) Update your Elasticsearch version if it’s outdated, as older versions may not support certain features. 4) Reindex your data if it has changed significantly.
This guide will help you check for common problems that cause the log ” Key [{}]; doc_count [{}] ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: aggregations.
Aggregation in Elasticsearch
Overview
In Elasticsearch an aggregation is a collection or the gathering of related things together. The aggregation framework collects all the data based on the documents that match a search request which helps in building summaries of the data. Unlike Elasticsearch facets, aggregations can be nested. So aggregations can have sub-aggregations that operated on the documents which are generated by parent aggregation. Below are the different types of aggregations, each aggregation has its own purpose:
Metrics Aggregations: Metric Aggregation mainly refers to the mathematical calculations performed on the documents present in the bucket based upon given search criteria. For example, if you choose a number field; then the metric calculations you can perform on it are COUNT, SUM, MIN, MAX, AVERAGE etc.
Bucket Aggregations: Bucket aggregations create buckets or sets of documents based on given criteria in query. When the aggregation is performed, the documents are placed in the respective bucket, at the end we get a list of buckets, each with a list of documents. Example of bucket aggregation is Histogram Aggregation, Range Aggregation, Terms Aggregation, Filter(s) Aggregations, Geo Distance Aggregation and IP Range Aggregation.
Pipeline Aggregations: These aggregations allow you to aggregate over the result of another aggregation rather than from document sets.
Matrix Aggregations: Unlike Metric and Bucket aggregations, this aggregation work on more than one field and produce a matrix result based on the values from the requested document fields.
Examples
This aggregation is used to get the average of any numeric field present in the aggregated documents. For example below query computes the average fees over all documents
POST /schools/_search
{
"aggs":{
"avg_fees":{"avg":{"field":"fees"}}
}
}In query “aggs” object holds the aggregation to be computed. “avg_fees” is the name of the aggregation, “avg_fees” can be referred in scripts also and “avg” is the type of aggregation applied on fees field. The above will return the following:
{
...
"aggregations" : {
"avg_fees" : {
"value" : 2650.0
}
}
}Log Context
Log “Key [{}]; doc_count [{}]” classname is tophits-aggregation.asciidoc.
We extracted the following from Elasticsearch source code for those seeking an in-depth context :
// For each entry
for (Terms.Bucket entry : agg.getBuckets()) {
String key = entry.getKey(); // bucket key
long docCount = entry.getDocCount(); // Doc count
logger.info("key [{}]; doc_count [{}]"; key; docCount);
// We ask for top_hits for each bucket
TopHits topHits = entry.getAggregations().get("top");
for (SearchHit hit : topHits.getHits().getHits()) {
logger.info(" -> id [{}]; _source [{}]"; hit.getId(); hit.getSourceAsString());
