tablet

Diagnose StarRocks tablet health, skew, and balance failures.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose StarRocks tablet-level storage and balance problems that cause slow queries, write blocks, replica errors, excessive metadata overhead, and disk migration loops.

Core Features & Use Cases

  • Tablet health analysis: Inspect tablet counts, version buildup, rowset pressure, and unhealthy replica states to isolate the failing layer.
  • Skew and balance troubleshooting: Detect extreme data-size variance, over-sharding, and replica distribution imbalance that create scan skew or FE pressure.
  • Root-cause recovery guidance: Match symptoms to causes such as compaction lag, bucket key skew, bad replicas, or disk balance retry loops and recommend the next corrective action.
  • Use case: A table shows one tablet far larger than the others and queries are uneven, so this Skill traces the imbalance, confirms the skew pattern, and suggests a safer bucket key redesign.

Quick Start

Ask for a tablet-health investigation of a StarRocks table and include any symptoms such as skew, too many versions, replica errors, or disk balance retries so the Skill can identify the likely cause and next remediation steps.

Frequently Asked Questions about tablet

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

FAQPage Schema
How do I diagnose StarRocks tablet health issues causing slow queries and write blocks?

Diagnose StarRocks tablet health by inspecting tablet counts, version buildup, rowset pressure, and unhealthy replica states to isolate the failing storage layer causing slow queries. This process matches symptoms to root causes like compaction lag or bad replicas.

What causes data skew and replica distribution imbalance in StarRocks tablets?

Data skew and replica distribution imbalance in StarRcks tablets stem from extreme data-size variance, over-sharding, and poor bucket key design. Detect these conditions by analyzing tablet distribution checks to identify uneven scan patterns and FE pressure.

How do I fix StarRocks compaction lag and too many tablet versions?

Fix StarRocks compaction lag and excessive tablet versions by evaluating version and rowset thresholds against unhealthy replica states. Apply root-cause recovery guidance to resolve metadata overhead and clear version buildup blocking tablet operations.

Why are StarRocks disk balance retry loops stuck and how do I recover?

StarRocks disk balance retry loops get stuck due to replica distribution imbalance and error-state replicas. Recover by tracing the disk migration failures, verifying replica repair actions, and confirming balanced tablet distribution across disks.

When should I redesign bucket keys to resolve StarRcks tablet skew?

Redesign bucket keys to resolve StarRocks tablet skew when one tablet is far larger than others, creating uneven query scans. Confirm the skew pattern through tablet distribution checks and apply a safer bucket key redesign for balanced data.