Files
skills/docs/networking/network/network-plugin-monitor/README.md
2026-05-29 08:20:56 +01:00

14 KiB

@suaveplan/network-plugin-monitor - Production monitoring + distributed tracing for the Suaveplan mesh: metric collector, alert engine, network tracer, historical store, adaptive sampler

Summary

Production monitoring + distributed tracing for the Suaveplan mesh. Collects metrics across four categories (node / connection / message / hierarchy), supports the four standard metric types (Counter / Gauge / Histogram / Summary) with both push and pull collection, raises threshold-based monitor:alert bus events with cooldown suppression, propagates OpenTelemetry-compatible trace ids across mesh hops with four sampling strategies (probabilistic / rate-limited / error-based / priority-based) plus clock-skew detection and correction, retains rolled-up history per metric, and adapts sampling rate downward under high metric volume so monitoring overhead never degrades the network it observes. Wrapped in a single MonitorPlugin satisfying the NetworkPlugin lifecycle.

Documentation tree

- [alert-engine](./src/alert/alert-engine.md) — _(no submodules)_- [collector](./src/collector/metric-collector.md) — _(no submodules)_- [metric-collector](./src/collector/metric-collector.md) — _(no submodules)_- [grafana](./src/grafana/dashboard-generator.md) — _(no submodules)_- [dashboard-generator](./src/grafana/dashboard-generator.md) — _(no submodules)_- [history](./src/history/historical-data-store.md) — _(no submodules)_- [historical-data-store](./src/history/historical-data-store.md) — _(no submodules)_- [monitor](./src/monitor/network-monitor.md) — _(no submodules)_- [network-monitor](./src/monitor/network-monitor.md) — _(no submodules)_- [plugin](./src/plugin/monitor-plugin.md) — _(no submodules)_- [monitor-plugin](./src/plugin/monitor-plugin.md) — _(no submodules)_- [prometheus](./src/prometheus/prometheus-exposition.md) — _(no submodules)_- [prometheus-exposition](./src/prometheus/prometheus-exposition.md) — _(no submodules)_- [bandwidth-monitor](./src/quality/bandwidth-monitor.md) — `BandwidthMonitor` records per-link bandwidth / RTT / packet-loss measurements into a bounded ring buffer and exposes s…