Send periodic heartbeats to keep an instance alive and report its current load.

Request

curl -X POST http://localhost:8080/heartbeat \
  -H "Content-Type: application/json" \
  -d '{"name":"ms.auth","instance_id":"10.0.0.5:3001","active_connections":3}'

Body

FieldTypeRequiredDescription
namestringyesService name
instance_idstringyeshost:port of the instance
active_connectionsintyesCurrent connection count

Response

{"ok":true,"ttl_seconds":15}

The instance TTL is refreshed. Continue sending heartbeats before the TTL expires.