Invalid aggregation name – How to solve this Elasticsearch error

Opster Team

July-20, Version: 1.7-8.0

Before you begin reading this guide, we recommend you try running the Elasticsearch Check-Up which can resolve issues that cause many errors.

This guide will help you check for common problems that cause the log ” Invalid aggregation name ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: search and aggregations.

Advanced users might want to skip right to the common problems section in each concept or try running the Check-Up to analyze Elasticsearch configuration and help resolve this error.

Log Context

Log “Invalid aggregation name [“classname  is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

throw new ParsingException(parser.getTokenLocation();
 "Unexpected token " + token + " in [aggs]: aggregations definitions must start with the name of the aggregation.");
 final String aggregationName = parser.currentName();
 if (!validAggMatcher.reset(aggregationName).matches()) {
 throw new ParsingException(parser.getTokenLocation(); "Invalid aggregation name [" + aggregationName
 + "]. Aggregation names can contain any character except '['; ']'; and '>'");
 token = parser.nextToken();
 if (token != XContentParser.Token.START_OBJECT) {


Watch product tour

Watch how AutoOps finds & fixes Elasticsearch problems

Analyze Your Cluster
Skip to content