Skip to content

docs: Recommend Overlord-based auto-compaction and mark useIncrementalCache production ready#19252

Merged
cecemei merged 20 commits intoapache:masterfrom
cecemei:auto
Apr 10, 2026
Merged

docs: Recommend Overlord-based auto-compaction and mark useIncrementalCache production ready#19252
cecemei merged 20 commits intoapache:masterfrom
cecemei:auto

Conversation

@cecemei
Copy link
Copy Markdown
Contributor

@cecemei cecemei commented Apr 1, 2026

Description

  • Rename CoordinatorRunStats to DruidRunStats
  • Some changes in automatic compaction documentation and default configuration settings.

Release note

Automatic Compaction

  • Overlord-based compaction supervisors are now the recommended and default approach for automatic compaction. This method provides better reactivity, MSQ task engine support, and easier management through the supervisor framework. Coordinator-based auto-compaction remains available as an alternative.
  • Automatic compaction tasks are now prefixed with auto instead of coordinator-issued.

Incremental cache

  • Incremental segment metadata cache (useIncrementalCache) is no longer experimental and defaults to ifSynced.

This PR has:

  • been self-reviewed.
  • added documentation for new or modified features or behaviors.
  • a release note entry in the PR description.
  • added Javadocs for most classes and all non-trivial methods. Linked related entities via Javadoc links.
  • added or updated version, license, or notice information in licenses.yaml
  • added comments explaining the "why" and the intent of the code wherever would not be obvious for an unfamiliar reader.
  • added unit tests or modified existing tests to cover new code paths, ensuring the threshold for code coverage is met.
  • added integration tests.
  • been tested in a test Druid cluster.

@cecemei cecemei changed the title Auto docs: Recommend Overlord-based auto-compaction and mark useIncrementalCache production ready Apr 1, 2026
@cecemei cecemei marked this pull request as ready for review April 1, 2026 23:52
@capistrant
Copy link
Copy Markdown
Contributor

The default for useSupervisors should be true in the cluster compaction config if we are recommending it going forward. that way all new deploys will get the recommended config

@cecemei
Copy link
Copy Markdown
Contributor Author

cecemei commented Apr 7, 2026

useSupervisors

updated default to true, PTAL!

@cecemei cecemei added this to the 37.0.0 milestone Apr 7, 2026
private static final Logger LOG = new Logger(CompactSegments.class);

private static final String TASK_ID_PREFIX = "coordinator-issued";
private static final String TASK_ID_PREFIX = "auto";
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

should we also update KillUnusedSegments/UnusedSegmentsKiller prefix to match to be more consistent?

Also might be nice to mention these cosmetic changes in release notes

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

updated release notes, i can open another pr to update KillUnusedSegments/UnusedSegmentsKiller as a follow up.

@cecemei cecemei merged commit bfb46e8 into apache:master Apr 10, 2026
39 checks passed
cecemei added a commit to cecemei/druid that referenced this pull request Apr 10, 2026
…lCache production ready (apache#19252)

* auto

* DruidRunStats

* doc

* check

* default

* legacy

* default-native

* format

* Revert "DruidRunStats"

This reverts commit d375136.

* format

* cascading

* doc

* link

* spell

* test

* style
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants