balance

Installation
SKILL.md

Balance & Tablet Scheduler Troubleshooting

Investigation guide for tablet scheduling, cluster balance, replica repair, and decommission issues.

Five root causes account for the vast majority of cases:

  • Cause A — balance throughput too low (clone tasks not progressing)
  • Cause B — balance too aggressive (impacting writes and queries)
  • Cause C — decommission BE stuck (replicas cannot be relocated)
  • Cause D — clone task repeated failure (destination path or disk issues)
  • Cause E — colocate group unstable (group marked Unstable, balance loops)

Metric Taxonomy — Read This First

Before using any metrics, understand the two-layer structure:

Installs
5
GitHub Stars
78
First Seen
Jun 3, 2026