mesh-metrics

mesh-metrics — Prometheus-style counters and gauges for Mesh Protocol

Discovery & UI

Usage

mesh metrics  [args]

Commands

inc, gauge, histogram, query, summary, export, reset, top

Commons Entry

# mesh-metrics — Prometheus-Style Observability

**Layer:** Infrastructure (Observability)
**CLI:** `mesh metrics|met`
**Tool:** `tools/mesh-metrics/metrics.sh`

## Purpose
Counters, gauges, and histograms for Mesh Protocol. Tracks request counts, latencies, error rates per tool/agent. Exports in Prometheus and JSON formats.

## Commands
| Command | Description |
|---------|-------------|
| `inc <name> [amount] [k=v...]` | Increment counter |
| `gauge <name> <value> [k=v...]` | Set gauge value |
| `histogram <name> <ms> [k=v...]` | Record latency |
| `query [name] [since]` | Query metrics |
| `summary` | Overview of all metrics |
| `export [prometheus\|json]` | Export metrics |
| `reset [name]` | Reset metrics |
| `top [n]` | Top N by sample count |

## Integration
- JSONL ledger at `data/metrics/metrics.jsonl`
- Label support for multi-dimensional querying
- Prometheus export for external monitoring
- Wired into mesh CLI as `mesh metrics|met`