Interpreting election results
Whenever the state of a member server's election status changes it will publish a status report that looks like this:
{
"version": 1,
"state": "healthy",
"active": false,
"updatedMs": 1722976385590,
"details": {
"message": "GETTING READY: Waiting to win 2 consecutive elections (won 1 so far).",
"httpStatus": {
"state": "notRunning",
"reason": "Not initialized."
},
"igmpStatus": {
"state": "notRunning",
"reason": "Not initialized."
},
"rpStatus": {
"state": "healthy"
},
"won": {
"c6fa1352-7650-454c-894b-64f59011b58f": true
},
"elected": {
"c6fa1352-7650-454c-894b-64f59011b58f": false
},
"quorum": {
"c6fa1352-7650-454c-894b-64f59011b58f": true
},
"votes": {
"c6fa1352-7650-454c-894b-64f59011b58f": {
"8c3fdc1e-ffc0-4ea7-a4d7-4b46011490a3": 1
}
}
}
}
Where each property is described below:
Property | Description |
version | The version of this JSON document's schema. For internal use only. |
state | The state of the election system, see below for election state details. |
active | The value true if this server is active (leading) or false if its operating in standby. |
details/message | The last election status message printed to the console on the server. See below for a description of these messages. |
details/httpStatus | The status of the HTTP ballot transport mechanism. This is not used and will always appear in the notRunning state. |
details/igmpStatus | The status of the IGMP (multicast) ballot transport mechanism. This will appear in the notRunning state for internal (Kubernetes-hosted) servers and any external satellite server which was started without specifying a default NIC. A warning will appear in the console of a server running without a valid IGMP leader election configuration: WARNING ElectionConfiguration - IGMP leader election will be disabled because a default NIC was not specified. Use "agent --default-nic" to specify a default NIC. |
details/rpStatus | The status of the Rallypoint-based ballot transport mechanism. This should appear in the state healthy. If it appears unhealthy, this typically indicates a problem with the Rallypoint this server group is using for elections. |
details/won | A map of the server group ID, to a boolean indication of whether this server won the last election. |
details/elected | A map of the server group ID, to a boolean indication of whether this server was elected leader. See details above for situation where a server may win an election but not be elected leader. |
details/quorum | A map of the server group ID, to a boolean indication of whether the election met quorum rules. |
details/votes | A map of server IDs, to the number of votes the server submitted for itself. Recall that a negative vote count implies that the server has been taken out of service (disabled); a zero value indicates the server has lost its connection to ICE Server; and a positive value represents its election priority. |