/* * SPDX-License-Identifier: Apache-2.0 * * The OpenSearch Contributors require contributions made to * this file be licensed under the Apache-2.0 license or a * compatible open source license. */ /* * Licensed to Elasticsearch under one or more contributor * license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright * ownership. Elasticsearch licenses this file to you under * the Apache License, Version 2.0 (the "License"); you may * not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ /* * Modifications Copyright OpenSearch Contributors. See * GitHub history for details. */ package org.opensearch.index.translog; import org.opensearch.common.UUIDs; import org.opensearch.common.bytes.ReleasableBytesReference; import org.opensearch.common.collect.Tuple; import org.opensearch.common.io.stream.BytesStreamOutput; import org.opensearch.common.util.BigArrays; import org.opensearch.common.util.io.IOUtils; import org.opensearch.common.lease.Releasable; import org.opensearch.core.index.shard.ShardId; import org.opensearch.test.OpenSearchTestCase; import org.mockito.Mockito; import java.io.IOException; import java.nio.channels.FileChannel; import java.nio.file.Files; import java.nio.file.Path; import java.util.ArrayList; import java.util.List; import static java.lang.Math.min; import static org.hamcrest.Matchers.equalTo; public class TranslogDeletionPolicyTests extends OpenSearchTestCase { private static long TOTAL_OPS_IN_GEN = 10L; public void testNoRetention() throws IOException { long now = System.currentTimeMillis(); Tuple, TranslogWriter> readersAndWriter = createReadersAndWriter(now); List allGens = new ArrayList<>(readersAndWriter.v1()); allGens.add(readersAndWriter.v2()); try { TranslogDeletionPolicy deletionPolicy = new MockDeletionPolicy(now, 0, 0, 0); assertMinGenRequired(deletionPolicy, readersAndWriter, allGens.get(allGens.size() - 1).generation); } finally { IOUtils.close(readersAndWriter.v1()); IOUtils.close(readersAndWriter.v2()); } } public void testBytesRetention() throws IOException { long now = System.currentTimeMillis(); Tuple, TranslogWriter> readersAndWriter = createReadersAndWriter(now); List allGens = new ArrayList<>(readersAndWriter.v1()); allGens.add(readersAndWriter.v2()); try { final int selectedReader = randomIntBetween(0, allGens.size() - 1); final long selectedGeneration = allGens.get(selectedReader).generation; long size = allGens.stream().skip(selectedReader).map(BaseTranslogReader::sizeInBytes).reduce(Long::sum).get(); assertThat( TranslogDeletionPolicy.getMinTranslogGenBySize(readersAndWriter.v1(), readersAndWriter.v2(), size), equalTo(selectedGeneration) ); assertThat( TranslogDeletionPolicy.getMinTranslogGenBySize(readersAndWriter.v1(), readersAndWriter.v2(), -1), equalTo(Long.MIN_VALUE) ); } finally { IOUtils.close(readersAndWriter.v1()); IOUtils.close(readersAndWriter.v2()); } } public void testAgeRetention() throws IOException { long now = System.currentTimeMillis(); Tuple, TranslogWriter> readersAndWriter = createReadersAndWriter(now); List allGens = new ArrayList<>(readersAndWriter.v1()); allGens.add(readersAndWriter.v2()); try { final int selectedReader = randomIntBetween(0, allGens.size() - 1); final long selectedGeneration = allGens.get(selectedReader).generation; long maxAge = now - allGens.get(selectedReader).getLastModifiedTime(); assertThat( TranslogDeletionPolicy.getMinTranslogGenByAge(readersAndWriter.v1(), readersAndWriter.v2(), maxAge, now), equalTo(selectedGeneration) ); assertThat( TranslogDeletionPolicy.getMinTranslogGenByAge(readersAndWriter.v1(), readersAndWriter.v2(), -1, now), equalTo(Long.MIN_VALUE) ); } finally { IOUtils.close(readersAndWriter.v1()); IOUtils.close(readersAndWriter.v2()); } } public void testTotalFilesRetention() throws Exception { Tuple, TranslogWriter> readersAndWriter = createReadersAndWriter(System.currentTimeMillis()); List allGens = new ArrayList<>(readersAndWriter.v1()); allGens.add(readersAndWriter.v2()); try { assertThat( TranslogDeletionPolicy.getMinTranslogGenByTotalFiles( readersAndWriter.v1(), readersAndWriter.v2(), randomIntBetween(Integer.MIN_VALUE, 1) ), equalTo(readersAndWriter.v2().generation) ); assertThat( TranslogDeletionPolicy.getMinTranslogGenByTotalFiles( readersAndWriter.v1(), readersAndWriter.v2(), randomIntBetween(allGens.size(), Integer.MAX_VALUE) ), equalTo(allGens.get(0).generation) ); int numFiles = randomIntBetween(1, allGens.size()); long selectedGeneration = allGens.get(allGens.size() - numFiles).generation; assertThat( TranslogDeletionPolicy.getMinTranslogGenByTotalFiles(readersAndWriter.v1(), readersAndWriter.v2(), numFiles), equalTo(selectedGeneration) ); } finally { IOUtils.close(readersAndWriter.v1()); IOUtils.close(readersAndWriter.v2()); } } /** * Tests that age trumps size but recovery trumps both. */ public void testRetentionHierarchy() throws IOException { long now = System.currentTimeMillis(); Tuple, TranslogWriter> readersAndWriter = createReadersAndWriter(now); List allGens = new ArrayList<>(readersAndWriter.v1()); allGens.add(readersAndWriter.v2()); try { DefaultTranslogDeletionPolicy deletionPolicy = new MockDeletionPolicy(now, Long.MAX_VALUE, Long.MAX_VALUE, Integer.MAX_VALUE); int selectedReader = randomIntBetween(0, allGens.size() - 1); final long selectedGenerationByAge = allGens.get(selectedReader).generation; long maxAge = now - allGens.get(selectedReader).getLastModifiedTime(); selectedReader = randomIntBetween(0, allGens.size() - 1); final long selectedGenerationBySize = allGens.get(selectedReader).generation; long size = allGens.stream().skip(selectedReader).map(BaseTranslogReader::sizeInBytes).reduce(Long::sum).get(); selectedReader = randomIntBetween(0, allGens.size() - 1); final long selectedGenerationByTotalFiles = allGens.get(selectedReader).generation; deletionPolicy.setRetentionAgeInMillis(maxAge); deletionPolicy.setRetentionSizeInBytes(size); final int totalFiles = allGens.size() - selectedReader; deletionPolicy.setRetentionTotalFiles(totalFiles); assertMinGenRequired( deletionPolicy, readersAndWriter, max3(selectedGenerationByAge, selectedGenerationBySize, selectedGenerationByTotalFiles) ); // make a new policy as committed gen can't go backwards (for now) deletionPolicy = new MockDeletionPolicy(now, size, maxAge, totalFiles); assertMinGenRequired( deletionPolicy, readersAndWriter, max3(selectedGenerationByAge, selectedGenerationBySize, selectedGenerationByTotalFiles) ); long viewGen = randomFrom(allGens).generation; try (Releasable ignored = deletionPolicy.acquireTranslogGen(viewGen)) { assertMinGenRequired( deletionPolicy, readersAndWriter, min(viewGen, max3(selectedGenerationByAge, selectedGenerationBySize, selectedGenerationByTotalFiles)) ); // disable age deletionPolicy.setRetentionAgeInMillis(-1); assertMinGenRequired( deletionPolicy, readersAndWriter, min(viewGen, Math.max(selectedGenerationBySize, selectedGenerationByTotalFiles)) ); // disable size deletionPolicy.setRetentionAgeInMillis(maxAge); deletionPolicy.setRetentionSizeInBytes(-1); assertMinGenRequired( deletionPolicy, readersAndWriter, min(viewGen, Math.max(selectedGenerationByAge, selectedGenerationByTotalFiles)) ); // disable age and zie deletionPolicy.setRetentionAgeInMillis(-1); deletionPolicy.setRetentionSizeInBytes(-1); assertMinGenRequired(deletionPolicy, readersAndWriter, viewGen); // disable total files deletionPolicy.setRetentionTotalFiles(0); assertMinGenRequired(deletionPolicy, readersAndWriter, viewGen); } } finally { IOUtils.close(readersAndWriter.v1()); IOUtils.close(readersAndWriter.v2()); } } private void assertMinGenRequired( TranslogDeletionPolicy deletionPolicy, Tuple, TranslogWriter> readersAndWriter, long expectedGen ) throws IOException { assertThat(deletionPolicy.minTranslogGenRequired(readersAndWriter.v1(), readersAndWriter.v2()), equalTo(expectedGen)); } private Tuple, TranslogWriter> createReadersAndWriter(final long now) throws IOException { final Path tempDir = createTempDir(); Files.createFile(tempDir.resolve(Translog.CHECKPOINT_FILE_NAME)); TranslogWriter writer = null; List readers = new ArrayList<>(); final int numberOfReaders = randomIntBetween(0, 10); final String translogUUID = UUIDs.randomBase64UUID(random()); for (long gen = 1; gen <= numberOfReaders + 1; gen++) { if (writer != null) { final TranslogReader reader = Mockito.spy(writer.closeIntoReader()); Mockito.doReturn(writer.getLastModifiedTime()).when(reader).getLastModifiedTime(); readers.add(reader); } writer = TranslogWriter.create( new ShardId("index", "uuid", 0), translogUUID, gen, tempDir.resolve(Translog.getFilename(gen)), FileChannel::open, TranslogConfig.DEFAULT_BUFFER_SIZE, 1L, 1L, () -> 1L, () -> 1L, randomNonNegativeLong(), new TragicExceptionHolder(), seqNo -> {}, BigArrays.NON_RECYCLING_INSTANCE, null ); writer = Mockito.spy(writer); Mockito.doReturn(now - (numberOfReaders - gen + 1) * 1000).when(writer).getLastModifiedTime(); BytesStreamOutput out = new BytesStreamOutput(4); final long startSeqNo = (gen - 1) * TOTAL_OPS_IN_GEN; final long endSeqNo = startSeqNo + TOTAL_OPS_IN_GEN - 1; for (long ops = endSeqNo; ops >= startSeqNo; ops--) { out.reset(); out.writeInt((int) ops); writer.add(ReleasableBytesReference.wrap(out.bytes()), ops); } } return new Tuple<>(readers, writer); } private static class MockDeletionPolicy extends DefaultTranslogDeletionPolicy { long now; MockDeletionPolicy(long now, long retentionSizeInBytes, long maxRetentionAgeInMillis, int maxRetentionTotalFiles) { super(retentionSizeInBytes, maxRetentionAgeInMillis, maxRetentionTotalFiles); this.now = now; } @Override protected long currentTime() { return now; } } private static long max3(long x1, long x2, long x3) { return Math.max(Math.max(x1, x2), x3); } }