starrocks-admin-storage-balancer

Balance StarRocks tablet distribution across BE nodes and disk paths.

14|1|Updated May 5, 2026
One-click install
npx skills add https://github.com/ivanshamaev/de-agent-skills --skill starrocks-admin-storage-balancer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: starrocks-admin-storage-balancer
Source: https://github.com/ivanshamaev/de-agent-skills/tree/main/group_skills/starrocks_group_skills/starrocks_admin_storage_balancer
Command: npx skills add https://github.com/ivanshamaev/de-agent-skills --skill starrocks-admin-storage-balancer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you administer StarRocks tablet placement so disk usage and tablet counts stay balanced across Backend (BE) nodes and disk paths, while avoiding unsafe operations during scaling and failure scenarios.

Core Features & Use Cases

  • Diagnose storage skew by inspecting per-BE disk utilization (including max per-disk path usage) and quantifying imbalance thresholds.
  • Administer rebalancing operations for adding new BEs, decommissioning BEs, and recovering from BE failures while monitoring repair vs balance workloads.
  • Tune balance behavior using dynamic FE parameters (e.g., balance_load_score_threshold, tablet scheduler strategy, concurrency/throttles) to control migration aggressiveness.
  • Monitor and forecast migration progress using SHOW PROC '/cluster_balance' and estimate days-to-full based on current and recent growth signals.

Quick Start

Ask the agent to help you add a new BE and then verify rebalancing completion by checking SHOW BACKENDS and SHOW PROC '/cluster_balance/overview'.

Frequently Asked Questions about starrocks-admin-storage-balancer

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

FAQPage Schema
How do I fix StarRocks disk skew and unbalanced tablet distribution across BE nodes?

To fix StarRocks disk skew, inspect per-BE disk utilization using SHOW BACKENDS to identify max per-disk path usage, then monitor tablet migration progress via SHOW PROC '/cluster_balance' to verify rebalancing completion across BE nodes.

What is the safest way to decommission a BE node in StarRocks without losing data?

Safe BE decommissioning requires applying safe decommission constraints to ensure tablet migration completes before node removal, while monitoring repair versus balance workloads through SHOW PROC endpoints to prevent data loss during StarRocks cluster scaling.

How do I tune StarRocks FE tablet scheduler parameters to control rebalancing throughput?

Tune StarRocks FE tablet scheduler rebalancing throughput by dynamically adjusting balance_load_score_threshold, scheduler strategy, and concurrency throttles to control migration aggressiveness and prevent resource exhaustion during tablet balancing operations.

How do I forecast StarRocks storage capacity and estimate days-to-full for BE disks?

Forecast StarRocks storage capacity and estimate days-to-full by querying information_schema metrics for current disk utilization, then calculating projected growth based on recent consumption signals to predict when BE storage will reach maximum capacity.

How do I monitor StarRocks tablet migration and repair progress during BE scaling?

Monitor StarRocks tablet migration and repair progress during BE scaling by querying SHOW PROC '/cluster_balance/overview' and checking cluster_balance views to track active workload states and verify migration completion across backend nodes.