Health Check

When the quarkus-smallrye-health extension is present, JSON-RPC automatically contributes a readiness health check that reports the active connection count across all transports. No code changes are needed.

Setup

Add the SmallRye Health extension:

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-smallrye-health</artifactId>
</dependency>

That’s it — the health check is registered automatically.

Health Check Output

The readiness endpoint (/q/health/ready) will include a JSON-RPC check:

{
  "status": "UP",
  "checks": [
    {
      "name": "JSON-RPC",
      "status": "UP",
      "data": {
        "activeConnections": 3
      }
    }
  ]
}

The check always reports UP and includes the current number of active connections across all transports (WebSocket and domain socket) as additional data.

Disabling the Health Check

The health check is enabled by default. To disable it, set:

quarkus.json-rpc.health.enabled=false