Тип: readme Описание: Кластерная диагностика StarRocks и навыки устранения неполадок

#starrocks-debug-skills

Кластерная диагностика StarRocks и система навыков устранения неполадок.

Обзор

Этот навык систематизирует опыт устранения неполадок, чтобы помочь обеспечить структурированное руководство по исследованию кластерных проблем, охватывая общие производственные проблемы с полными путями исследования от симптома до первопричины.

Структура каталога

Каждый каталог навыков содержит: SKILL.md - Структурированные инструкции по устранению неполадок (основная точка входа) ** ссылки/** — ориентированные на конкретные навыки справочные документы и тематические исследования

• скрипты/ - Скрипты помощи для конкретных навыков (запрос/, узел/, cpu-насыщение/только)

Навыки категории

| Категория | Ключевые слова | Описание [править править код] | запрос | повесить, медленно, профиль, сканировать, присоединиться | Устранение неполадок запроса, медленный анализ запроса | | импорт | тайм-аут, RPC не удалось, опубликовать | Устранение неполадок импорта, брокер / поток / рутинная нагрузка | | узел | крах, OOM, тупик, GC | проблемы узлов FE/BE, анализ памяти | | материализованный просмотр | обновление, тайм-аут, перезапись | отказы обновления MV, перезапись запроса | | дата-лейк | HMS, Kerberos, внешний | Внешний каталог, 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