{"id":51580879,"url":"https://github.com/starrocks/starrocks-debug-skills","last_synced_at":"2026-07-11T06:02:44.797Z","repository":{"id":360397182,"uuid":"1219715308","full_name":"StarRocks/starrocks-debug-skills","owner":"StarRocks","description":"The official repository for StarRocks debug skills. Includes structured workflows and case studies for diagnosing performance bottlenecks, OOMs, and data lake integration issues.","archived":false,"fork":false,"pushed_at":"2026-05-26T07:40:03.000Z","size":308,"stargazers_count":45,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-05-26T09:27:21.927Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/StarRocks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-24T06:38:40.000Z","updated_at":"2026-05-26T07:40:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/StarRocks/starrocks-debug-skills","commit_stats":null,"previous_names":["starrocks/starrocks-debug-skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/StarRocks/starrocks-debug-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StarRocks%2Fstarrocks-debug-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StarRocks%2Fstarrocks-debug-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StarRocks%2Fstarrocks-debug-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StarRocks%2Fstarrocks-debug-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/StarRocks","download_url":"https://codeload.github.com/StarRocks/starrocks-debug-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StarRocks%2Fstarrocks-debug-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35352623,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-11T06:02:40.904Z","updated_at":"2026-07-11T06:02:44.791Z","avatar_url":"https://github.com/StarRocks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\ntype: readme\ndescription: StarRocks cluster diagnostics and troubleshooting skill\n---\n\n# starrocks-debug-skills\n\nStarRocks cluster diagnostics and troubleshooting skill system.\n\n## Overview\n\nThis skill systematizes troubleshooting experience to help provide structured investigation guidance for cluster issues, covering common production problems with complete investigation paths from symptom to root cause.\n\n## Directory Structure\n\n```\nstarrocks-debug-skills/\n├── README.md\n├── LICENSE\n├── CONTRIBUTING.md\n├── guides/                     # Cross-skill cascade guides\n│   ├── cascade-cluster-degradation.md\n│   └── cascade-import-rpc-failed.md\n├── references/                 # Shared commands used across all skills\n│   └── 01-common-commands.md\n├── scripts/                    # Utility scripts\n│   ├── install.sh              # Install skills to IDEs\n│   ├── skill_converter.py      # Verify structure, convert to IDE formats\n│   └── analyze_logs.py         # Audit log analysis script\n├── query/                      # Query troubleshooting\n│   ├── SKILL.md\n│   ├── references/\n│   │   ├── 02-profile-and-sql-toolkit.md\n│   │   ├── 03-statistics-index.md\n│   │   └── case-014-scan-skew.md\n│   └── scripts/\n│       └── analyze_logs.py\n├── import/                     # Import troubleshooting\n├── node/                       # BE/FE node issues\n├── materialized-view/          # MV troubleshooting\n├── data-lake/                  # External catalog issues\n├── shared-data/                # Shared-data (lake-mode) architecture\n├── tablet/                     # Tablet health issues\n├── deployment/                 # FE/BE startup and configuration\n├── high-concurrency/           # High QPS optimization\n├── resource-isolation/         # Resource groups and query queues\n├── balance/                    # Tablet scheduler and cluster balance\n├── compaction/                 # Compaction issues\n├── cpu-saturation/             # CPU triage and attribution\n├── .claude/\n├── .cursor/\n└── .idea/\n```\n\nEach skill directory contains:\n- **SKILL.md** — Structured troubleshooting instructions (main entry point)\n- **references/** — Per-skill focused reference docs and case studies\n- **scripts/** — Skill-specific helper scripts (query/, node/, cpu-saturation/ only)\n\n## Skills Categories\n\n| Category | Keywords | Description |\n|---|---|---|\n| query | hang, slow, profile, scan, join | Query troubleshooting, slow query analysis |\n| import | timeout, RPC failed, publish | Import troubleshooting, broker/stream/routine load |\n| node | crash, OOM, deadlock, GC | FE/BE node issues, memory analysis |\n| materialized-view | refresh, timeout, rewrite | MV refresh failures, query rewrite |\n| data-lake | HMS, Kerberos, external | External catalog, Hive, Iceberg, S3 |\n| shared-data | DataCache, S3, leader switch | Shared-data (lake-mode) deployments only |\n| tablet | health, balance, skew | Tablet health, disk balancing |\n| deployment | startup, port, BDB, JDK | FE/BE startup failures, configuration |\n| high-concurrency | QPS, connection pool | High QPS optimization, throughput plateaus |\n| resource-isolation | resource group, queue | Resource groups, query queues, circuit breakers |\n| balance | scheduler, clone, decommission | Tablet scheduler, cluster balance |\n| compaction | version, score, rowset | Compaction issues, version count |\n| cpu-saturation | CPU, load average, attribution | CPU triage — identify which workload is consuming CPU |\n\n## Core Methodology\n\n**\"Restore in 10 minutes, root-cause within hours\"**\n\n1. **Top-down investigation** — Client → FE → BE → Storage/Network\n2. **Data-driven** — Backed by logs, metrics, stack traces\n3. **Mitigate first** — Service recovery via parameter tuning\n4. **Binary exclusion** — Disable features via session variables\n\n## Quick Diagnosis Commands\n\n```sql\n-- Cluster status\nSHOW BACKENDS;\nSHOW FRONTENDS;\nSHOW PROC '/current_queries';\nSHOW LOAD;\n```\n\n```bash\n# Log search\ngrep \"\u003cquery_id\u003e\" fe.log\ngrep \"\u003cinstance_id\u003e\" be.INFO\ngrep -E \"ERROR|WARN\" fe.log | tail -100\n\n# Analyze audit logs for large queries (also available per-skill under \u003cskill\u003e/scripts/)\npython3 scripts/analyze_logs.py \"2025-04-15 00:00:00\" \"2025-04-15 01:00:00\" \"MemCostBytes\" 3 fe.audit.log\n```\n\n## Installation\n\n### Claude Code\n\n```bash\n./scripts/install.sh --tool claude-code --target ~/.claude/skills/\n```\n\n### Cursor IDE\n\n```bash\n./scripts/install.sh --tool cursor --target .cursor/rules/\n```\n\n### JetBrains IDEs\n\n```bash\n./scripts/install.sh --tool jetbrains --target .idea/\n```\n\n## Trigger Conditions\n\nTriggered when conversation contains:\n- Investigation terms: debug, troubleshoot, diagnose, root cause\n- Symptoms: slow query, import failure, OOM, crash, timeout, hang\n- Tool terms: jstack, pstack, profile, Grafana\n\n## Cross-Skill Guides\n\nMulti-skill cascade scenarios that span more than one troubleshooting domain:\n\n| Guide | Pattern |\n|---|---|\n| [Cluster Degradation Cascade](guides/cascade-cluster-degradation.md) | Compaction backlog → Import slow → BE OOM → FE Deadlock |\n| [Import RPC Failed from Statistics](guides/cascade-import-rpc-failed.md) | Statistics collection → BRPC starvation → Import/Query failure |\n\n## Maintenance\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for how to add:\n- New skills → `\u003ccategory\u003e/SKILL.md`\n- New cases → `\u003ccategory\u003e/references/case-\u003cnumber\u003e-\u003cname\u003e.md`\n- New focused reference docs → `\u003ccategory\u003e/references/\u003cname\u003e.md`\n- New cross-skill guides → `guides/\u003cname\u003e.md`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarrocks%2Fstarrocks-debug-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstarrocks%2Fstarrocks-debug-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarrocks%2Fstarrocks-debug-skills/lists"}