modules/observability/hyper-p2p-health-probe/docs/architecture.md

Architecture: hyper-p2p-health-probe

Category: observability · Protocol: health-probe/v1

Role

Mesh-wide liveness and latency hints for routing, load spread, and dashboards.

flowchart LR
  Monitor[Monitor agent] --> HP[HealthProbe]
  HP --> Obs[observability-base]
  Obs --> SW[Hyperswarm]

Wire messages

type	direction	fields	behavior
health	gossip	entry	Upsert _reports; emit remote-report

State model

_reports: Map(peerId → entry) — latest report per peer wins.

Composition

• hyper-p2p-log-gossip — correlate errors with unhealthy peers
• hyper-p2p-discovery-health — discovery-time health checks
• hyper-p2p-intent-router — avoid routing to unhealthy peers