neon
neon copied to clipboard
Add new compaction abstraction, simulator, and implementation.
Rebased version of #5234, part of #6768
This consists of three parts:
- A refactoring and new contract for implementing and testing compaction.
The logic is now in a separate crate, with no dependency on the 'pageserver' crate. It defines an interface that the real pageserver must implement, in order to call the compaction algorithm. The interface models things like delta and image layers, but just the parts that the compaction algorithm needs to make decisions. That makes it easier unit test the algorithm and experiment with different implementations.
I did not convert the current code to the new abstraction, however. When compaction algorithm is set to "Legacy", we just use the old code. It might be worthwhile to convert the old code to the new abstraction, so that we can compare the behavior of the new algorithm against the old one, using the same simulated cases. If we do that, have to be careful that the converted code really is equivalent to the old.
This inclues only trivial changes to the main pageserver code. All the new code is behind a tenant config option. So this should be pretty safe to merge, even if the new implementation is buggy, as long as we don't enable it.
- A new compaction algorithm, implemented using the new abstraction.
The new algorithm is tiered compaction. It is inspired by the PoC at PR #4539, although I did not use that code directly, as I needed the new implementation to fit the new abstraction. The algorithm here is less advanced, I did not implement partial image layers, for example. I wanted to keep it simple on purpose, so that as we add bells and whistles, we can see the effects using the included simulator.
One difference to #4539 and your typical LSM tree implementations is how we keep track of the LSM tree levels. This PR doesn't have a permanent concept of a level, tier or sorted run at all. There are just delta and image layers. However, when compaction starts, we look at the layers that exist, and arrange them into levels, depending on their shapes. That is ephemeral: when the compaction finishes, we forget that information. This allows the new algorithm to work without any extra bookkeeping. That makes it easier to transition from the old algorithm to new, and back again.
There is just a new tenant config option to choose the compaction algorithm. The default is "Legacy", meaning the current algorithm in 'main'. If you set it to "Tiered", the new algorithm is used.
- A simulator, which implements the new abstraction.
The simulator can be used to analyze write and storage amplification, without running a test with the full pageserver. It can also draw an SVG animation of the simulation, to visualize how layers are created and deleted.
To run the simulator:
cargo run --bin compaction-simulator run-suite
2418 tests run: 2297 passed, 0 failed, 121 skipped (full report)
Code coverage* (full report)
functions:28.4% (6811 of 23982 functions)lines:46.8% (41553 of 88730 lines)
* collected from Rust tests only
55de35c35b748246c7d4e1958e17f9092248db05 at 2024-02-23T16:49:08.832Z :recycle:
cc @hlinnaka
I pushed this with the last published state of #5234 . Have only spent 4-5 hours today rebasing it and adjusting it for the changes that happened since, not done anything else (large part was waiting for the compiler).
Next is to address the review comments on #5234 by @koivunej and me, or put them as followups.
Force pushed to get rid of the stray files