mcpField
O
observe-metrics

observe-metrics

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

observe-metrics について

Observe Metricsは、オブザーバビリティ指標を集計し、システムの健全性に関する異常を見つけるエージェントスキルです。カウンター、ゲージ、ヒストグラムを集計し、ベースラインと比較して傾向と全体的な健全性スコアを報告します。

主な機能

  1. 01オブザーバビリティ指標の取得
  2. 02各種指標の集計
  3. 03指標ベースラインの算出
  4. 04統計的異常の検出
  5. 05指標スナップショットの保存
  6. 06傾向と健全性スコアの報告

活用シーン

  1. 01タスク完了率とエラー率の確認
  2. 02稼働中エージェントとメモリ使用量の監視
  3. 03トークン消費量の追跡
  4. 04タスクやスパンの所要時間の変化検出

MCP 対応

RufloのMCPツールを使って指標レコードを取得し、ベースラインを検索してスナップショットを保存します。このワークフローではmemoryおよびpatternツールを使用します。

インストール

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

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

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

詳細

メトリクスの監視

observability 名前空間のカウンター、ゲージ、ヒストグラムを集計し、異常を検出します。

使用する場面

タスク完了率、エラー率、アクティブなエージェント数、メモリ使用量、トークン消費量など、システムの健全性をスナップショットで確認するときに使用します。スウォームのパフォーマンス監視や、劣化の検出に役立ちます。

手順

  1. メトリクスを取得する -- mcp__plugin_ruflo-core_ruflo__memory_search --namespace observability（または memory_list）を呼び出し、指定した期間（デフォルト：1 時間）のメトリクスレコードを取得します。memory_* ツールファミリーは名前空間に応じてルーティングされます。agentdb_hierarchical-* はルーティングされないため、ここでは memory_* を使用してください。
  2. 集計する -- 次の値を計算します。
    • カウンター：合計値（tasks_completed、errors、token_usage）
    • ゲージ：現在値（active_agents、memory_usage_bytes）
    • ヒストグラム：p50、p95、p99（task_duration_ms、span_duration_ms）
  3. ベースラインを計算する -- mcp__plugin_ruflo-core_ruflo__agentdb_pattern-search を呼び出して（ReasoningBank 経由でルーティングされます。namespace 引数は渡さないでください。pattern-* ツールはこれを無視します）、各メトリクスのベースライン値を設定します。
  4. 異常を検出する -- ベースラインから 2 標準偏差を超えて乖離しているメトリクスに、方向（上回る／下回る）と深刻度を付けます。
  5. パターンを保存する -- ruflo-cost-tracker ADR-0001 のデュアルパスパターンに従い、次の 2 つの方法があります。
    • パターンストア（型付き、推奨）：type: 'metric-snapshot' を指定して mcp__plugin_ruflo-core_ruflo__agentdb_pattern-store を使用します。namespace 引数は不要です。
    • プレーンストア（名前空間でルーティング可能）：タイムスタンプにひも付けたスナップショットを mcp__plugin_ruflo-core_ruflo__memory_store --namespace observability で保存します。
  6. 報告する -- メトリクス名、現在値、ベースライン、乖離、傾向（上昇／下降／安定）、異常フラグを表示します。全体的な健全性スコア（緑／黄／赤）も表示します。

CLI の代替手段

npx @claude-flow/cli@latest memory search --query "system metrics for last hour" --namespace observability

コメント

Markdown 対応