name	observe-metrics
description	Aggregate and display system metrics with anomaly detection for a time period
argument-hint	[--period 1h]
allowed-tools	mcp__claude-flow__memory_search mcp__claude-flow__memory_list mcp__claude-flow__memory_store mcp__claude-flow__agentdb_pattern-search mcp__claude-flow__agentdb_pattern-store mcp__claude-flow__agentdb_semantic-route Bash

Observe Metrics

Aggregate counters, gauges, and histograms from the observability namespace and flag anomalies.

When to use

When you need a snapshot of system health -- task completion rates, error rates, active agent counts, memory usage, and token consumption. Useful for monitoring swarm performance and detecting degradation.

Steps

Retrieve metrics -- call mcp__claude-flow__memory_search --namespace observability (or memory_list) to fetch metric records for the specified period (default: 1 hour). The memory_* tool family routes by namespace; agentdb_hierarchical-* does NOT, so use memory_* here.
Aggregate -- compute:
- Counters: sum totals (tasks_completed, errors, token_usage)
- Gauges: current values (active_agents, memory_usage_bytes)
- Histograms: p50, p95, p99 (task_duration_ms, span_duration_ms)
Compute baselines -- call mcp__claude-flow__agentdb_pattern-search (ReasoningBank-routed; don't pass a namespace argument — pattern-* tools ignore it) to establish baseline values for each metric.
Flag anomalies -- mark metrics deviating >2 standard deviations from baseline with direction (above/below) and severity
Store patterns -- two paths (per ruflo-cost-tracker ADR-0001 dual-path pattern):
- Pattern store (typed, recommended): mcp__claude-flow__agentdb_pattern-store with type: 'metric-snapshot'. No namespace arg.
- Plain store (namespace-routable): mcp__claude-flow__memory_store --namespace observability for the snapshot tied to a timestamp.
Report -- display: metric name, current value, baseline, deviation, trend (up/down/stable), anomaly flag; overall health score (green/yellow/red)

CLI alternative

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

Más de este repositorio

mismo repositorio

nested-subagents

ruvnet/ruflo

Spawn nested sub-agents (agents that spawn sub-agents, up to depth=5) via Claude Code's native Task tool — for context-managed deep delegation

2026-06-0958.7k

workflow-create

ruvnet/ruflo

Author a workflow — either an MCP workflow template (persisted, lifecycle) or a native .claude/workflows/*.js orchestration script (agent/parallel/pipeline fan-out)

2026-05-2958.7k

workflow-run

ruvnet/ruflo

Run a workflow — drive an MCP workflow lifecycle (execute/pause/resume/cancel) or invoke + resume a native .claude/workflows/*.js orchestration via the Workflow tool

2026-05-2958.7k

gaia-architecture-comparison

ruvnet/ruflo

Side-by-side comparison of ruflo vs HAL vs other GAIA harnesses — capability gaps, design decisions, and improvement roadmap

2026-05-2858.7k

gaia-debugging

ruvnet/ruflo

Diagnose why a GAIA question failed — extract trace, classify failure mode, and propose a fix

2026-05-2858.7k

gaia-submission

ruvnet/ruflo

Walk through a complete GAIA benchmark→submit flow — from key resolution through HAL-compatible package generation

2026-05-2858.7k

Observe Metrics

Aggregate counters, gauges, and histograms from the observability namespace and flag anomalies.

When to use

Steps

Retrieve metrics -- call mcp__claude-flow__memory_search --namespace observability (or memory_list) to fetch metric records for the specified period (default: 1 hour). The memory_* tool family routes by namespace; agentdb_hierarchical-* does NOT, so use memory_* here.

Aggregate -- compute:

Counters: sum totals (tasks_completed, errors, token_usage)
Gauges: current values (active_agents, memory_usage_bytes)
Histograms: p50, p95, p99 (task_duration_ms, span_duration_ms)

Compute baselines -- call mcp__claude-flow__agentdb_pattern-search (ReasoningBank-routed; don't pass a namespace argument — pattern-* tools ignore it) to establish baseline values for each metric.

Flag anomalies -- mark metrics deviating >2 standard deviations from baseline with direction (above/below) and severity

Store patterns -- two paths (per ruflo-cost-tracker ADR-0001 dual-path pattern):

Pattern store (typed, recommended): mcp__claude-flow__agentdb_pattern-store with type: 'metric-snapshot'. No namespace arg.
Plain store (namespace-routable): mcp__claude-flow__memory_store --namespace observability for the snapshot tied to a timestamp.

Report -- display: metric name, current value, baseline, deviation, trend (up/down/stable), anomaly flag; overall health score (green/yellow/red)

CLI alternative

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