mcpField
D
doris-debug

doris-debug

github.com/apacheデータ・データベース4772 回インストール4 週間前に更新
リポジトリ

doris-debug について

doris-debugは、Apache Dorisの運用担当者向けのトラブルシューティングスキルです。症状に応じた専門ガイドへ案内し、診断コマンド、ソースコードの対応表、メトリクス、設定資料、事例を用いて調査します。

主な機能

  1. 01Dorisの症状を専門スキルへ振り分け
  2. 02診断 SQL・API・CLIの資料
  3. 03症状とDorisソースコードの対応付け
  4. 04事例・メトリクス・設定の参照
  5. 05証拠に基づくトップダウン調査

活用シーン

  1. 01遅いクエリや停止したクエリの調査
  2. 02ロード・圧縮・Tabletの問題診断
  3. 03FE/BEのクラッシュや起動失敗の追跡
  4. 04カタログやリソース分離の問題調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/apache/doris-skills --skill doris-debug

インストール後、Claude Code で/doris-debugを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

cloud/references/
case-001-warmup-empty-batch.md
compaction/references/
case-001-too-many-versions.md
case-002-schema-change-base-score.md
data-lake/references/
case-001-glue-pagination.md
import/references/
case-001-group-commit-wal-pileup.md
case-002-rpc-timeout-heavy-work-pool.md
case-003-insert-job-fe-oom.md
materialized-view/references/
case-001-mtmv-rewrite-miss.md
node/references/
case-001-be-oom-memtracker.md
case-002-filecache-lru-leak.md
case-003-be-scanner-pileup-memory.md
case-004-fe-bdbje-corruption.md
query/references/
case-001-exchange-waitfordata.md
case-002-plan-time-iceberg-rpc.md
case-003-exchange-e11-fanout.md
resource-isolation/references/
case-001-workload-policy-cme.md
shared/guides/
cascade-import-wal-versions.md
cascade-query-timeout-exchange.md
shared/references/
01-common-commands.md
02-source-map.md
03-cir-case-index.md
04-metrics-guide.md
05-config-quick-ref.md

詳細

Doris Debug Router

使用方法

  1. 以下の表から症状の領域を特定します。
  2. 診断用 SQL と API コマンドについては、shared/references/01-common-commands.md を参照します。
  3. 症状を Apache Doris のソースコードの場所に対応付けるには、shared/references/02-source-map.md を参照します。
  4. 対象のスキル（<domain>/SKILL.md）を開き、原因の一覧表と判断ツリーに従います。
  5. 該当する本番環境のケースパターンについては、shared/references/03-case-index.md を確認します。

スキルのルーティング

症状スキル
クエリの遅延／タイムアウト／ハング、Profile 分析、Exchange WaitForDataquery/SKILL.md
Stream Load／Broker Load／Routine Load の失敗、Group Commit WAL の滞留import/SKILL.md
-235／バージョン数が多すぎる、compaction スコアが高い、compaction の遅延compaction/SKILL.md
BE/FE の OOM、クラッシュ、Alive の誤検知、メモリリークnode/SKILL.md
同期 MV の欠落、非同期 MTMV のリフレッシュ／リライトの問題materialized-view/SKILL.md
Tablet レプリカの欠落、クローン処理の滞留、ディスクの偏り、Tablet の修復tablet/SKILL.md
FE/BE の起動失敗、ポートの競合、priority_networks の設定ミスdeployment/SKILL.md
Hive/Iceberg/Paimon/Glue カタログのクエリ失敗、メタデータのリフレッシュ、S3/HDFS の接続性data-lake/SKILL.md
Workload Group のキューでの飢餓状態、CPU／メモリの分離漏れ、スピルの問題resource-isolation/SKILL.md
ストレージとコンピューティングの分離、meta-service のレイテンシ、ファイルキャッシュ、ウォームアップcloud/SKILL.md

共通リファレンス

ドキュメント内容
shared/references/01-common-commands.md診断用 SQL、HTTP API、CLI コマンド
shared/references/02-source-map.md症状から Doris のソースコードへの対応付け（バージョン注記付き）
shared/references/03-case-index.md8 つの領域にわたる本番環境のケース概要 45 件
shared/references/04-metrics-guide.md領域ごとの主要メトリクスとしきい値
shared/references/05-config-quick-ref.md領域ごとの主要な設定パラメーターとチューニングの指針
shared/guides/モジュールを横断する連鎖的なトラブルシューティング

関連スキル

  • doris-profile-reader：クエリのボトルネックを詳細に Profile 分析します（query/SKILL.md の原因 C — BE のコンピューティングボトルネックから参照されています）。
  • doris-best-practices：予防的なテーブル設計と設定の指針を提供します。
  • doris-architecture-advisor：ワークロードを考慮したアーキテクチャの判断を支援します。

手法

  1. クライアント → FE → BE → ディスク／ネットワークの順に上から調査します。
  2. まずログ／メトリクス／Profile／SHOW PROC の証拠を確認します。
  3. 根本原因を調べる前に、負荷を抑えます（スロットリング、強制終了、reset_rpc_channel）。
  4. Doris のソースコード（02-source-map.md）と照らし合わせて仮説を検証します。
  5. 既知のケースパターン（03-case-index.md）と照合し、同じ調査の繰り返しを避けます。

コメント

Markdown 対応