starrocks-admin-cluster-health

Diagnose StarRocks cluster health via SHOW, ADMIN, and Information_Schema queries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of diagnosing StarRocks cluster instability by helping you quickly assess FE/BE/CN liveness, tablet health, replica status, compaction backlog, and storage imbalance.

Core Features & Use Cases

  • FE quorum and metadata health checks: identifies down frontends, validates quorum availability, and checks metadata edit-log replay lag to catch control-plane issues early.
  • BE health, disk pressure, and capacity risk: reports dead backends and evaluates disk utilization thresholds to predict write stalls and emergencies.
  • Tablet, replica, compaction, and balance triage: finds unhealthy tablets/replicas, surfaces compaction backlog pressure, and checks ongoing balance operations to confirm whether rebalancing is working.
  • Prometheus alert readiness: provides metric names and alert rules to turn health signals into actionable monitoring.

Example use case: after a BE crash you need to confirm which replicas are missing, whether repair is in progress, and whether compaction and disk usage are likely to degrade query performance.

Quick Start

Use the starrocks-admin-cluster-health skill to run FE and BE health checks and return a prioritized diagnosis for FE quorum, disk usage, unhealthy tablets, replica problems, compaction pressure, and cluster balance status.

Frequently Asked Questions about starrocks-admin-cluster-health

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

FAQPage Schema
How do I check StarRocks cluster health after a node crash?

To check StarRocks cluster health after a node crash, you need to verify BE liveness, detect under-replicated tablets, and confirm whether replica repair and storage rebalancing are actively in progress.

What is the best way to monitor StarRocks FE quorum and metadata health?

Monitoring StarRocks FE quorum involves identifying down frontends, validating quorum availability, and checking metadata edit-log replay lag to catch control-plane issues early.

How do I detect compaction backlog and disk pressure in StarRocks?

Detecting compaction backlog and disk pressure in StarRocks requires evaluating disk utilization thresholds and surfacing compaction backlog to predict potential write stalls or storage emergencies.

Can I generate Prometheus alert rules from StarRocks tablet and replica states?

Yes, you can generate Prometheus alert rules from StarRocks tablet and replica states by using read-only SHOW and ADMIN queries to produce threshold-based health metrics suitable for dashboards and alerting.

Does StarRocks health triage require write access to the database?

No, StarRocks health triage satisfies safe, read-only inspection requirements by using Information_Schema, SHOW, and ADMIN queries to diagnose cluster instability without performing write operations.