Skip to content

managementRoutes

managementRoutes(system, cluster, settings?): object

Defined in: src/management/HttpManagement.ts:53

Build a Route tree exposing cluster-management HTTP endpoints. The caller binds the returned routes into their HTTP server — management usually lives on a separate port so it can be firewalled off the public one.

Endpoints:

  • GET /cluster/members → current membership JSON
  • GET /cluster/leader → leader info
  • GET /cluster/shards?type=<typeName> → shard-to-region map for one type (#56)
  • GET /health → liveness (200 iff all checks pass)
  • GET /ready → readiness (200 iff cluster is up + all checks pass)
  • POST /cluster/leave → graceful leave (optional, off by default)
  • POST /cluster/down body {address} → force-down a peer (optional, off by default) (#56)
  • GET /metrics → Prometheus text format (optional, off by default) (#56)

ActorSystem

Cluster | null

ManagementRoutesSettings = {}

object

health: HealthCheckRegistry

routes: Route