Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Increase max number of dimensions from 16 to 21 #95340

Merged
Original file line number Diff line number Diff line change
@@ -0,0 +1,200 @@
/*
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
* or more contributor license agreements. Licensed under the Elastic License
* 2.0 and the Server Side Public License, v 1; you may not use this file except
* in compliance with, at your election, the Elastic License 2.0 or the Server
* Side Public License, v 1.
*/

package org.elasticsearch.timeseries.support;

import org.elasticsearch.action.index.IndexResponse;
import org.elasticsearch.cluster.metadata.IndexMetadata;
import org.elasticsearch.common.settings.Settings;
import org.elasticsearch.core.CheckedConsumer;
import org.elasticsearch.index.IndexMode;
import org.elasticsearch.index.IndexSettings;
import org.elasticsearch.index.mapper.DocumentParsingException;
import org.elasticsearch.index.mapper.MapperService;
import org.elasticsearch.rest.RestStatus;
import org.elasticsearch.test.ESIntegTestCase;
import org.elasticsearch.xcontent.XContentBuilder;
import org.elasticsearch.xcontent.json.JsonXContent;

import java.io.IOException;
import java.time.Instant;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.function.Supplier;

import static org.hamcrest.Matchers.equalTo;

public class TimeSeriesDimensionsLimitIT extends ESIntegTestCase {

public void testDimensionFieldNameLimit() throws IOException {
int dimensionFieldLimit = 21;
final String dimensionFieldName = randomAlphaOfLength(randomIntBetween(513, 1024));
createTimeSeriesIndex(mapping -> {
mapping.startObject("routing_field").field("type", "keyword").field("time_series_dimension", true).endObject();
mapping.startObject(dimensionFieldName).field("type", "keyword").field("time_series_dimension", true).endObject();
},
mapping -> mapping.startObject("gauge").field("type", "integer").field("time_series_metric", "gauge").endObject(),
() -> List.of("routing_field"),
dimensionFieldLimit
);
final Exception ex = expectThrows(
DocumentParsingException.class,
() -> client().prepareIndex("test")
.setSource(
"routing_field",
randomAlphaOfLength(10),
dimensionFieldName,
randomAlphaOfLength(1024),
"gauge",
randomIntBetween(10, 20),
"@timestamp",
Instant.now().toEpochMilli()
)
.get()
);
assertThat(
ex.getCause().getMessage(),
equalTo(
"Dimension name must be less than [512] bytes but [" + dimensionFieldName + "] was [" + dimensionFieldName.length() + "]."
)
);
}

public void testDimensionFieldValueLimit() throws IOException {
int dimensionFieldLimit = 21;
createTimeSeriesIndex(
mapping -> mapping.startObject("field").field("type", "keyword").field("time_series_dimension", true).endObject(),
mapping -> mapping.startObject("gauge").field("type", "integer").field("time_series_metric", "gauge").endObject(),
() -> List.of("field"),
dimensionFieldLimit
);
long startTime = Instant.now().toEpochMilli();
client().prepareIndex("test")
.setSource("field", randomAlphaOfLength(1024), "gauge", randomIntBetween(10, 20), "@timestamp", startTime)
.get();
final Exception ex = expectThrows(
DocumentParsingException.class,
() -> client().prepareIndex("test")
.setSource("field", randomAlphaOfLength(1025), "gauge", randomIntBetween(10, 20), "@timestamp", startTime + 1)
.get()
);
assertThat(ex.getCause().getMessage(), equalTo("Dimension fields must be less than [1024] bytes but was [1025]."));
}

public void testTotalNumberOfDimensionFieldsLimit() {
int dimensionFieldLimit = 21;
final Exception ex = expectThrows(IllegalArgumentException.class, () -> createTimeSeriesIndex(mapping -> {
mapping.startObject("routing_field").field("type", "keyword").field("time_series_dimension", true).endObject();
for (int i = 0; i < dimensionFieldLimit; i++) {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe I'm reading this incorrectly. This creates a mapping with 21 dimension fields. But this should succeed? Only if there are 22 dimensions this should fail?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is the routing_field that is a dimension so it is actually 22. I need to include something in the routing path otherwise the test fails because there is no routing path.

mapping.startObject(randomAlphaOfLength(10)).field("type", "keyword").field("time_series_dimension", true).endObject();
}
},
mapping -> mapping.startObject("gauge").field("type", "integer").field("time_series_metric", "gauge").endObject(),
() -> List.of("routing_field"),
dimensionFieldLimit
));

assertThat(ex.getMessage(), equalTo("Limit of total dimension fields [" + dimensionFieldLimit + "] has been exceeded"));
}

public void testTotalNumberOfDimensionFieldsDefaultLimit() {
int dimensionFieldLimit = 21;
final Exception ex = expectThrows(IllegalArgumentException.class, () -> createTimeSeriesIndex(mapping -> {
mapping.startObject("routing_field").field("type", "keyword").field("time_series_dimension", true).endObject();
for (int i = 0; i < dimensionFieldLimit; i++) {
mapping.startObject(randomAlphaOfLength(10)).field("type", "keyword").field("time_series_dimension", true).endObject();
}
},
mapping -> mapping.startObject("gauge").field("type", "integer").field("time_series_metric", "gauge").endObject(),
() -> List.of("routing_field"),
null // NOTE: using default field limit
));

assertThat(ex.getMessage(), equalTo("Limit of total dimension fields [" + dimensionFieldLimit + "] has been exceeded"));
}

public void testTotalDimensionFieldsSizeLuceneLimit() throws IOException {
int dimensionFieldLimit = 21;
final List<String> dimensionFieldNames = new ArrayList<>();
createTimeSeriesIndex(mapping -> {
for (int i = 0; i < dimensionFieldLimit; i++) {
String dimensionFieldName = randomAlphaOfLength(512);
dimensionFieldNames.add(dimensionFieldName);
mapping.startObject(dimensionFieldName).field("type", "keyword").field("time_series_dimension", true).endObject();
}
},
mapping -> mapping.startObject("gauge").field("type", "integer").field("time_series_metric", "gauge").endObject(),
() -> List.of(dimensionFieldNames.get(0)),
dimensionFieldLimit
);

final Map<String, Object> source = new HashMap<>();
source.put("gauge", randomIntBetween(10, 20));
source.put("@timestamp", Instant.now().toEpochMilli());
for (int i = 0; i < dimensionFieldLimit; i++) {
source.put(dimensionFieldNames.get(i), randomAlphaOfLength(1024));
}
final IndexResponse indexResponse = client().prepareIndex("test").setSource(source).get();
assertEquals(RestStatus.CREATED.getStatus(), indexResponse.status().getStatus());
}

public void testTotalDimensionFieldsSizeLuceneLimitPlusOne() throws IOException {
int dimensionFieldLimit = 22;
final List<String> dimensionFieldNames = new ArrayList<>();
createTimeSeriesIndex(mapping -> {
for (int i = 0; i < dimensionFieldLimit; i++) {
String dimensionFieldName = randomAlphaOfLength(512);
dimensionFieldNames.add(dimensionFieldName);
mapping.startObject(dimensionFieldName).field("type", "keyword").field("time_series_dimension", true).endObject();
}
},
mapping -> mapping.startObject("gauge").field("type", "integer").field("time_series_metric", "gauge").endObject(),
() -> List.of(dimensionFieldNames.get(0)),
dimensionFieldLimit
);

final Map<String, Object> source = new HashMap<>();
source.put("routing_field", randomAlphaOfLength(1024));
source.put("gauge", randomIntBetween(10, 20));
source.put("@timestamp", Instant.now().toEpochMilli());
for (int i = 0; i < dimensionFieldLimit; i++) {
source.put(dimensionFieldNames.get(i), randomAlphaOfLength(1024));
}
final Exception ex = expectThrows(DocumentParsingException.class, () -> client().prepareIndex("test").setSource(source).get());
assertEquals("_tsid longer than [32766] bytes [33903].", ex.getCause().getMessage());
}

private void createTimeSeriesIndex(
final CheckedConsumer<XContentBuilder, IOException> dimensions,
final CheckedConsumer<XContentBuilder, IOException> metrics,
final Supplier<List<String>> routingPaths,
final Integer dimensionsFieldLimit
) throws IOException {
XContentBuilder mapping = JsonXContent.contentBuilder();
mapping.startObject().startObject("properties");
mapping.startObject("@timestamp").field("type", "date").endObject();
metrics.accept(mapping);
dimensions.accept(mapping);
mapping.endObject().endObject();

Settings.Builder settings = Settings.builder()
.put(IndexSettings.MODE.getKey(), IndexMode.TIME_SERIES)
.putList(IndexMetadata.INDEX_ROUTING_PATH.getKey(), routingPaths.get())
.put(IndexSettings.TIME_SERIES_START_TIME.getKey(), "2000-01-08T23:40:53.384Z")
.put(IndexSettings.TIME_SERIES_END_TIME.getKey(), "2106-01-08T23:40:53.384Z");

if (dimensionsFieldLimit != null) {
settings.put(MapperService.INDEX_MAPPING_DIMENSION_FIELDS_LIMIT_SETTING.getKey(), dimensionsFieldLimit);
}

client().admin().indices().prepareCreate("test").setSettings(settings.build()).setMapping(mapping).get();
}

}
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ public enum MergeReason {
);
public static final Setting<Long> INDEX_MAPPING_DIMENSION_FIELDS_LIMIT_SETTING = Setting.longSetting(
"index.mapping.dimension_fields.limit",
16,
21,
0,
Property.Dynamic,
Property.IndexScope
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -325,7 +325,7 @@ public void testTooManyDimensionFields() {
int max;
Settings settings;
if (randomBoolean()) {
max = 16; // By default no more than 16 dimensions per document are supported
max = 21; // By default no more than 21 dimensions per document are supported
settings = getIndexSettings();
} else {
max = between(1, 10000);
Expand Down