mcpField
O
observe-trace

observe-trace

github.com/ruvnetエージェントワークフロー80.0k732 回インストール今日更新
リポジトリ

observe-trace について

observe-traceは、トレーススパンからタスクの分散実行を再構成するRufloスキルです。親子関係のある時間付きツリーを作り、クリティカルパスやボトルネックを特定して、エージェント間の連携を要約します。

主な機能

  1. 01タスクのスパン取得
  2. 02親子関係に基づくトレースツリー作成
  3. 03所要時間とクリティカルパスの算出
  4. 04遅いスパンと待機時間の検出
  5. 05実行フローの要約

活用シーン

  1. 01複数エージェントによるタスク実行の確認
  2. 02トレース内の遅い処理の特定
  3. 03エージェント連携と実行時間の確認

MCP 対応

Ruflo MCPツールでオブザーバビリティ名前空間からスパン記録を取得し、スパンのメタデータを物語形式の要約に統合します。

インストール

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

$npx skills add https://github.com/ruvnet/ruflo --skill observe-trace

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

詳細

オブザーブトレース

タスクの分散トレーススパンを収集し、実行フロー、所要時間、ボトルネックを示す視覚的なトレースツリーを作成します。

使用するタイミング

複数のエージェントにまたがってタスクがどのように実行されたか、どのスパンが実行されたか、それぞれにかかった時間、ボトルネックの発生箇所、エージェント間の連携方法を把握する必要がある場合に使用します。

手順

  1. スパンを収集する -- mcp__plugin_ruflo-core_ruflo__memory_search --namespace observability（または memory_list）を呼び出して、<task-id>に一致するすべてのスパンを取得します。memory_*ツールファミリーは名前空間でルーティングされます。agentdb_hierarchical-*は名前空間ではなく（working|episodic|semanticの）ティアでルーティングされるため、ここではmemory_*を使用してください。ruflo-agentdb ADR-0001 §"Namespace convention"を参照してください。
  2. トレースツリーを作成する -- parentSpanIdの参照を使ってスパンを親子階層に整理し、ルートスパンを最上位に配置します。
  3. タイミングを計算する -- 各スパンの所要時間（endTime - startTime）を計算し、クリティカルパス（順次実行されるスパンの最長チェーン）を特定します。
  4. ボトルネックを特定する -- 所要時間がその操作タイプのp95を超えるスパン、またはスパン間の間隔からアイドル時間が示唆される箇所にフラグを付けます。
  5. 要約する -- mcp__plugin_ruflo-core_ruflo__agentdb_context-synthesizeを呼び出し、スパンのメタデータを統合して実行フローの概要をまとめます。
  6. 報告する -- スパン名、エージェント、所要時間、ステータス（OK/ERROR）、ボトルネックフラグを含むトレースツリーを表示します。トレース全体の所要時間とクリティカルパスの所要時間も含めます。

CLI の代替方法

npx @claude-flow/cli@latest memory search --query "trace spans for task TASK_ID" --namespace observability

コメント

Markdown 対応