skills.rest
StarRocks
StarRocksOFFICIAL
Explore all skills by this author →
WebsiteGitHub

balance

Diagnose and resolve StarRocks tablet scheduling, balance, clone, and decommission failures.

73|12|Updated Apr 24, 2026
Search Tags:#balance#colocate#starrocks#decommission#tablet scheduler#clone repair
One-click install
npx skills add https://github.com/StarRocks/starrocks-debug-skills --skill balance-starrocks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: balance
Source: https://github.com/StarRocks/starrocks-debug-skills/tree/main/balance
Command: npx skills add https://github.com/StarRocks/starrocks-debug-skills --skill balance-starrocks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve StarRocks cluster balance and tablet scheduling failures, including missing replicas, stalled clone tasks, aggressive rebalancing, stuck decommissioning, and unstable colocate groups.

Core Features & Use Cases

  • Balance Health Diagnosis: Checks cluster-wide tablet health, scheduling queues, clone history, and disk skew to pinpoint the active failure mode.
  • Targeted Recovery Guidance: Recommends the right corrective actions for slow balance, saturated clone slots, repeated clone failures, decommission blockers, and colocate instability.
  • Operational Verification: Confirms recovery by tracking unhealthy tablets, cloning progress, scheduler statistics, and history outcomes until the cluster returns to steady state.

Quick Start

Ask the Skill to analyze your StarRocks cluster balance symptoms and tell you which tablet scheduler checks, configuration changes, and recovery steps to run next.

Frequently Asked Questions about balance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why are StarRocks tablet clone tasks failing repeatedly in my cluster?▼

StarRocks decommission gets stuck when remaining tablets fail to clone off the retiring BE nodes. Clear the stalled repair queues and saturated clone slots to allow the tablet scheduler to finish migrating replicas successfully.

How do I fix StarRocks colocate group instability and rebalancing issues?▼

StarRocks balance slows down when the tablet scheduler queue stalls or clone slots saturate. Inspect SHOW PROC statistics and schedule tables to identify disk skew, then apply configuration tuning to accelerate repair.

What is the best way to diagnose StarRocks unhealthy tablets and disk skew?▼

Verify StarRocks balance recovery by tracking unhealthy tablets, cloning progress, and scheduler statistics. Confirm history outcomes show successful repairs and the cluster returns to a steady state across all BE nodes.

Can I use SHOW PROC to troubleshoot StarRocks tablet scheduling failures?▼

StarRocks clone repair stalls when BE nodes have disk skew or saturated clone slots. Inspect schedule tables and history outcomes to find repeated errors, then apply configuration tuning to resume the tablet scheduler.

How do I verify StarRocks cluster balance recovery after fixing tablet errors?▼

StarRocks tablet scheduler repair stalls when clone slots saturate or disk skew blocks replica migration. Diagnose the active failure mode using SHOW PROC statistics and cluster balance views to apply targeted configuration tuning.

What causes StarRocks decommission to get stuck during node removal?▼

StarRocks colocate group instability arises from unbalanced replicas and stalled tablet scheduling. Inspect cluster balance views and scheduler statistics to apply configuration tuning that restores colocate group stability.

Related Skills

Explore More Software Engineering Skills→
ivanshamaevivanshamaev
14

starrocks-admin-storage-balancer

Balance StarRocks tablet distribution across BE nodes and disk paths.

Community
Advanced
NVIDIANVIDIA
8.1k

debug-openshell-cluster

Diagnose OpenShell cluster startup failures and unhealthy states.

Official
Advanced
StarRocksStarRocks
73

tablet

Diagnose StarRocks tablet health, skew, and balance failures.

Official
Advanced
ivanshamaevivanshamaev
14

starrocks-bucketing

Design StarRocks table bucketing with HASH or RANDOM distribution and bucket counts.

Community
Advanced