org.graylog2.indexer.rotation.strategies.TimeBasedRotationStrategy Maven / Gradle / Ivy
/*
* Copyright (C) 2020 Graylog, Inc.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the Server Side Public License, version 1,
* as published by MongoDB, Inc.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* Server Side Public License for more details.
*
* You should have received a copy of the Server Side Public License
* along with this program. If not, see
* .
*/
package org.graylog2.indexer.rotation.strategies;
import com.google.common.base.MoreObjects;
import org.apache.commons.lang3.tuple.ImmutablePair;
import org.apache.commons.lang3.tuple.Pair;
import org.graylog2.audit.AuditEventSender;
import org.graylog2.configuration.ElasticsearchConfiguration;
import org.graylog2.indexer.IndexSet;
import org.graylog2.indexer.indexset.IndexSetConfig;
import org.graylog2.indexer.indices.Indices;
import org.graylog2.plugin.Tools;
import org.graylog2.plugin.indexer.rotation.RotationStrategyConfig;
import org.graylog2.plugin.system.NodeId;
import org.joda.time.DateTime;
import org.joda.time.DateTimeField;
import org.joda.time.DateTimeFieldType;
import org.joda.time.DateTimeZone;
import org.joda.time.Duration;
import org.joda.time.Instant;
import org.joda.time.Period;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import javax.annotation.Nullable;
import javax.inject.Inject;
import javax.inject.Singleton;
import java.text.MessageFormat;
import java.util.Locale;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import static com.google.common.base.Preconditions.checkState;
import static com.google.common.base.Strings.isNullOrEmpty;
import static java.util.Objects.requireNonNull;
import static org.joda.time.DateTimeFieldType.dayOfMonth;
import static org.joda.time.DateTimeFieldType.hourOfDay;
import static org.joda.time.DateTimeFieldType.minuteOfHour;
import static org.joda.time.DateTimeFieldType.monthOfYear;
import static org.joda.time.DateTimeFieldType.secondOfMinute;
import static org.joda.time.DateTimeFieldType.weekOfWeekyear;
import static org.joda.time.DateTimeFieldType.year;
@Singleton
public class TimeBasedRotationStrategy extends AbstractRotationStrategy {
private static final Logger log = LoggerFactory.getLogger(TimeBasedRotationStrategy.class);
public static final String NAME = "time";
public static final String OVERRIDE_HINT = "(elasticsearch_max_write_index_age overrides configured period)";
private Map anchor;
@Inject
public TimeBasedRotationStrategy(Indices indices, NodeId nodeId,
AuditEventSender auditEventSender,
ElasticsearchConfiguration elasticsearchConfiguration) {
super(auditEventSender, nodeId, elasticsearchConfiguration, indices);
this.anchor = new ConcurrentHashMap<>();
}
@Override
public Class configurationClass() {
return TimeBasedRotationStrategyConfig.class;
}
@Override
public RotationStrategyConfig defaultConfiguration() {
return TimeBasedRotationStrategyConfig.builder()
.maxRotationPeriod(elasticsearchConfiguration.getMaxWriteIndexAge())
.build();
}
/**
* Resets internal state. After a reset, the rotation strategy will behave like it would after a server restart.
* I.e. no previous anchor points will be available, so rotation uses the index creation dates as reference points.
*/
public void reset() {
this.anchor.clear();
}
/**
* Determines the starting point ("anchor") for a period.
*
* To produce repeatable rotation points in time, the period is "snapped" to a "grid" of time.
* For example, an hourly index rotation would be anchored to the last full hour, instead of happening at whatever minute
* the first rotation was started.
*
* This "snapping" is done accordingly with the other parts of a period.
*
* For highly irregular periods (those that do not have a small zero component)
*
* @param period the rotation period
* @return the anchor DateTime to calculate rotation periods from
*/
static DateTime determineRotationPeriodAnchor(@Nullable DateTime lastAnchor, Period period) {
final Period normalized = period.normalizedStandard();
int years = normalized.getYears();
int months = normalized.getMonths();
int weeks = normalized.getWeeks();
int days = normalized.getDays();
int hours = normalized.getHours();
int minutes = normalized.getMinutes();
int seconds = normalized.getSeconds();
if (years == 0 && months == 0 && weeks == 0 && days == 0 && hours == 0 && minutes == 0 && seconds == 0) {
throw new IllegalArgumentException("Invalid rotation period specified");
}
// find the largest non-zero stride in the period. that's our anchor type. statement order matters here!
DateTimeFieldType largestStrideType = null;
if (seconds > 0) {
largestStrideType = secondOfMinute();
}
if (minutes > 0) {
largestStrideType = minuteOfHour();
}
if (hours > 0) {
largestStrideType = hourOfDay();
}
if (days > 0) {
largestStrideType = dayOfMonth();
}
if (weeks > 0) {
largestStrideType = weekOfWeekyear();
}
if (months > 0) {
largestStrideType = monthOfYear();
}
if (years > 0) {
largestStrideType = year();
}
if (largestStrideType == null) {
throw new IllegalArgumentException("Could not determine rotation stride length.");
}
final DateTime anchorTime = anchorTimeFrom(lastAnchor);
final DateTimeField field = largestStrideType.getField(anchorTime.getChronology());
// use normalized here to make sure we actually have the largestStride type available! see https://github.com/Graylog2/graylog2-server/issues/836
int periodValue = normalized.get(largestStrideType.getDurationType());
final long fieldValue = field.roundFloor(anchorTime.getMillis());
final int fieldValueInUnit = field.get(fieldValue);
if (periodValue == 0) {
// https://github.com/Graylog2/graylog2-server/issues/836
log.warn("Determining stride length failed because of a 0 period. Defaulting back to 1 period to avoid crashing, but this is a bug!");
periodValue = 1;
}
final long difference = fieldValueInUnit % periodValue;
final long newValue = field.add(fieldValue, -1 * difference);
return new DateTime(newValue, DateTimeZone.UTC);
}
private static DateTime anchorTimeFrom(@Nullable DateTime lastAnchor) {
if (lastAnchor != null && !lastAnchor.getZone().equals(DateTimeZone.UTC)) {
return lastAnchor.withZone(DateTimeZone.UTC);
}
return MoreObjects.firstNonNull(lastAnchor, Tools.nowUTC());
}
private static boolean isLonger(Period p1, Period p2) {
Instant now = Instant.now();
Duration d1 = p1.toDurationTo(now);
Duration d2 = p2.toDurationTo(now);
return d1.isLongerThan(d2);
}
@Nullable
@Override
protected Result shouldRotate(String index, IndexSet indexSet) {
final IndexSetConfig indexSetConfig = requireNonNull(indexSet.getConfig(), "Index set configuration must not be null");
final String indexSetId = indexSetConfig.id();
checkState(!isNullOrEmpty(index), "Index name must not be null or empty");
checkState(!isNullOrEmpty(indexSetId), "Index set ID must not be null or empty");
checkState(indexSetConfig.rotationStrategy() instanceof TimeBasedRotationStrategyConfig,
"Invalid rotation strategy config <%s> for index set <%s>"
, indexSetConfig.rotationStrategy().getClass().getCanonicalName(), indexSet);
final TimeBasedRotationStrategyConfig config = (TimeBasedRotationStrategyConfig) indexSetConfig.rotationStrategy();
final Pair normalizedRotationPeriod = getNormalizedRotationPeriod(config);
final Period normalizedPeriod = normalizedRotationPeriod.getLeft();
final boolean overriding = normalizedRotationPeriod.getRight();
// when first started, we might not know the last rotation time, look up the creation time of the index instead.
if (!anchor.containsKey(indexSetId)) {
indices.indexCreationDate(index).ifPresent(creationDate -> {
final DateTime currentAnchor = determineRotationPeriodAnchor(creationDate, normalizedPeriod);
anchor.put(indexSetId, currentAnchor);
});
// still not able to figure out the last rotation time, we'll rotate forcibly
if (!anchor.containsKey(indexSetId)) {
return createResult(true, "No known previous rotation time, forcing index rotation now.");
}
}
final DateTime now = Tools.nowUTC();
final DateTime currentAnchor = anchor.get(indexSetId);
final DateTime nextRotation = currentAnchor.plus(normalizedPeriod);
if (nextRotation.isAfter(now)) {
final String message = new MessageFormat("Next rotation at {0} {1}", Locale.ENGLISH)
.format(new Object[]{nextRotation,
overriding ? OVERRIDE_HINT : ""});
return createResult(false, message);
}
// determine new anchor (push it to within less then one period before now) in case we missed one or more periods
final DateTime nextAnchor = calculateNextAnchor(currentAnchor, normalizedPeriod, now);
anchor.put(indexSetId, nextAnchor);
if (!config.rotateEmptyIndexSet() && isEmptyIndexSet(indexSet)) {
log.debug("Index set {} contains no messages, skipping rotation!", indexSet);
final String message = new MessageFormat("Index set contains no messages, skipping rotation! Next rotation at {0} {1}", Locale.ENGLISH)
.format(new Object[]{
nextAnchor,
overriding ? OVERRIDE_HINT : ""});
return createResult(false, message);
}
final String message = new MessageFormat("Rotation period {0} elapsed, next rotation at {1} {2}", Locale.ENGLISH)
.format(new Object[]{now,
nextAnchor,
overriding ? OVERRIDE_HINT : ""});
return createResult(true, message);
}
private boolean isEmptyIndexSet(IndexSet indexSet) {
return indices.getIndices(indexSet)
.stream()
.filter(indices::isOpen)
.noneMatch(indexName -> indices.numberOfMessages(indexName) > 0);
}
private Pair getNormalizedRotationPeriod(TimeBasedRotationStrategyConfig config) {
Period rotationPeriod = config.rotationPeriod();
Period maxPeriod = elasticsearchConfiguration.getMaxWriteIndexAge();
boolean overriding = false;
if (maxPeriod != null && isLonger(rotationPeriod, maxPeriod)) {
log.debug("Max rotation limit {} overrides configured period {}", maxPeriod, rotationPeriod);
rotationPeriod = maxPeriod;
overriding = true;
}
final Period normalizedPeriod = rotationPeriod.normalizedStandard();
return new ImmutablePair<>(normalizedPeriod, overriding);
}
private DateTime calculateNextAnchor(DateTime currentAnchor, Period normalizedPeriod, DateTime now) {
DateTime tmpAnchor;
int multiplicator = 0;
do {
tmpAnchor = currentAnchor.withPeriodAdded(normalizedPeriod, ++multiplicator);
} while (tmpAnchor.isBefore(now));
return currentAnchor.withPeriodAdded(normalizedPeriod, multiplicator - 1);
}
@Override
public String getStrategyName() {
return NAME;
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy