---

유형: readme 설명: StarRocks 클러스터 진단 및 문제 해결 기술

---

스타록스 디버그-skills

StarRocks 클러스터 진단 및 문제 해결 기술 시스템.

개요

이 기술 systematizes 문제 해결 경험 클러스터 문제에 대한 구조화 조사 지도를 제공, symptom에서 루트 원인에 대한 완전한 조사 경로와 일반적인 생산 문제를 다루는.

디렉토리 구조

각 기술 디렉토리 포함:

• **SKILL.md ** - 구조화 문제 해결 지침 (주요 항목) -references/ — Per-skill 집중된 참조 문서 및 사례 연구 -scripts/ — Skill-specific helper scripts (query/, node/, cpu-saturation/만)

스킬 카테고리

| 카테고리 | 키워드 | Description |—||||| | Query | , slow, profile, scan, join | Query 문제 해결, 느린 쿼리 분석 | | 수입 | 시동, RPC 고장, 출판 | 수입 문제 해결, 중개인/stream/routine 로드 | | 노드 | 충돌, OOM, deadlock, GC | FE/BE 노드 문제, 메모리 분석 | | Materialized-view | 새로 고침, 타임아웃, 다시 작성 | MV 새로 고침 실패, 쿼리 다시 작성 | | 데이터레이크 | HMS, Kerberos, External | 외부 카탈로그, Hive, Iceberg, S3 |

---

type: readme description: StarRocks cluster diagnostics and troubleshooting skill

starrocks-debug-skills

StarRocks cluster diagnostics and troubleshooting skill system.

Overview

This 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.

Directory Structure

starrocks-debug-skills/
├── README.md
├── LICENSE
├── CONTRIBUTING.md
├── guides/                     # Cross-skill cascade guides
│   ├── cascade-cluster-degradation.md
│   └── cascade-import-rpc-failed.md
├── references/                 # Shared commands used across all skills
│   └── 01-common-commands.md
├── scripts/                    # Utility scripts
│   ├── install.sh              # Install skills to IDEs
│   ├── skill_converter.py      # Verify structure, convert to IDE formats
│   └── analyze_logs.py         # Audit log analysis script
├── query/                      # Query troubleshooting
│   ├── SKILL.md
│   ├── references/
│   │   ├── 02-profile-and-sql-toolkit.md
│   │   ├── 03-statistics-index.md
│   │   └── case-014-scan-skew.md
│   └── scripts/
│       └── analyze_logs.py
├── import/                     # Import troubleshooting
├── node/                       # BE/FE node issues
├── materialized-view/          # MV troubleshooting
├── data-lake/                  # External catalog issues
├── shared-data/                # Shared-data (lake-mode) architecture
├── tablet/                     # Tablet health issues
├── deployment/                 # FE/BE startup and configuration
├── high-concurrency/           # High QPS optimization
├── resource-isolation/         # Resource groups and query queues
├── balance/                    # Tablet scheduler and cluster balance
├── compaction/                 # Compaction issues
├── cpu-saturation/             # CPU triage and attribution
├── .claude/
├── .cursor/
└── .idea/

Each skill directory contains:

• SKILL.md — Structured troubleshooting instructions (main entry point)
• references/ — Per-skill focused reference docs and case studies
• scripts/ — Skill-specific helper scripts (query/, node/, cpu-saturation/ only)

Skills Categories