Skip to content

Clarify automatic shard rebalancing - #2602

Open
abdonpijpelink wants to merge 2 commits into
masterfrom
clarify-rebalancing
Open

Clarify automatic shard rebalancing#2602
abdonpijpelink wants to merge 2 commits into
masterfrom
clarify-rebalancing

Conversation

@abdonpijpelink

Copy link
Copy Markdown
Member

@ihorponom reported that, in the docs, three things could be more clear about automatic shard rebalancing:

  • Rebalancing works constantly in the background; not just when scaling a cluster.
  • Rebalancing is not per collection, but globally.
  • When manually moving shards, the rebalancer may move your shard back. Disable the rebalancer if you want to manually assign shards.

This PR addresses that by making the following changes:

  • cloud/configure-cluster.md — Rebalancing is continuous, not scaling-only; balances per-node across all collections; added warning that manual moves can be reverted.
  • scaling/distributed_deployment.md — Same "continuous, not just on node add/remove" clarification; added a note that manual shard moves can be reverted.
  • cloud/cluster-monitoring.md — Two FAQ entries updated to explain rebalancing is continuous and per-node-across-collections.
  • hybrid-cloud/configure-scale-upgrade.md — Reworded to say rebalancing is continuous, not just tied to scaling.
  • private-cloud/qdrant-cluster-management.md — Same continuous-rebalancing clarification plus the manual-move-reverted warning.

@netlify

netlify Bot commented Aug 6, 2026

Copy link
Copy Markdown

Deploy Preview for condescending-goldwasser-91acf0 ready!

Name Link
🔨 Latest commit 1eb6cfe
🔍 Latest deploy log https://app.netlify.com/projects/condescending-goldwasser-91acf0/deploys/6a7462cabeccd60008b3c525
😎 Deploy Preview https://deploy-preview-2602--condescending-goldwasser-91acf0.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@ihorponom ihorponom left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Looks good overall; I would just change this part
deactivate automatic shard rebalancing by not selecting a value for the Shard Rebalance Strategy option.
Because to deactivate, we need to click the 'cross' and then save. (we can rephrase but it's the same sense)

#upd
I see in development we have changed it to Disable option in dropdown
image

@generall

generall commented Aug 6, 2026

Copy link
Copy Markdown
Member

Because to deactivate, we need to click the 'cross' and then save.

This doesn't work for me, it just goes back to default.

@ihorponom

Copy link
Copy Markdown

Because to deactivate, we need to click the 'cross' and then save.

This doesn't work for me, it just goes back to default.

Yes, you are right, just checked on Prod.

But 'Disabled' option seems to work on Development

@abdonpijpelink

Copy link
Copy Markdown
Member Author

I've pushed a change that changes the wording into "deactivate automatic shard rebalancing by selecting Disabled for the Shard Rebalance Strategy option", to match the new option in Dev. We can wait with merging this PR until that's been released to Prod.

@abdonpijpelink abdonpijpelink added the do not merge For release on a specified date label Aug 6, 2026
@ihorponom
ihorponom self-requested a review August 6, 2026 11:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do not merge For release on a specified date

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants