StarRocksOfficial·13 Agent Skills Included

starrocks-debug-skills

StarRocks cluster diagnostics, troubleshooting, and root-cause investigation

Diagnoses StarRocks production issues across queries, imports, nodes, tablets, compaction, materialized views, and shared-data deployments. Guides investigations from symptom to root cause using logs, metrics, profiles, and ready-to-run SQL and shell commands. Eliminates guesswork with decision trees, real incident case studies, and step-by-step recovery actions for faster cluster restoration.

73|12

↗

npx skills add StarRocks/starrocks-debug-skills --all -g -y

All Skills in This Repository (13)

Pure Emerald Level Indicators

📦 In Repo

StarRocks

cpu-saturation

Attribute high CPU saturation on StarRocks FE or BE nodes to process, module, and workload.

materialized-view

Diagnose StarRocks materialized view refresh and rewrite failures.

tablet

Diagnose StarRocks tablet health, skew, and balance failures.

shared-data

Diagnose StarRocks shared-data cluster failures from BE and FE logs.

high-concurrency

Diagnose high-QPS StarRocks throughput bottlenecks and latency spikes.

compaction

Diagnose StarRocks compaction backlog and version-explosion failures using metrics, SQL, and logs.

balance

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

data-lake

Diagnose StarRocks external catalog query failures and stale data.

resource-isolation

Diagnose StarRocks resource isolation failures via audit logs and metrics.

deployment

Diagnose StarRocks FE and BE startup failures from logs.

node

Diagnose StarRocks BE and FE node crashes, OOM, deadlocks, and Full GC pauses.

query

Diagnose slow or incorrect StarRocks queries from FE logs to BE execution profiles.

Official

Advanced

Frequently Asked Questions

FAQPage Schema

How to install starrocks-debug-skills?▼

Run `npx skills add StarRocks/starrocks-debug-skills --all -g -y` in your terminal to install all diagnostic skills globally.

How to troubleshoot slow StarRocks queries?▼

The query skill walks you through audit log analysis, profile collection, and bottleneck detection for scan skew, join OOM, and missing predicate pushdown.

How to fix StarRocks BE OOM or FE deadlock?▼

The node skill covers BE out-of-memory analysis via mem_tracker and dmesg, plus FE deadlock detection using jstack and LockManager logs.

Does it cover shared-data and S3 deployments?▼

Yes. Dedicated skills handle DataCache corruption, S3 rate limiting, FE leader switch issues, and cloud-native compaction for lake-mode clusters.

Can non-experts use these debugging skills?▼

Yes. Each skill provides copy-paste SQL and shell commands with clear decision trees, so your agent can run structured investigations from plain-English problem descriptions.