Document new health check endpoints
This commit is contained in:
parent
6162328593
commit
ea37d7dd67
|
|
@ -989,6 +989,116 @@ or:
|
|||
<pre>{"status":"failed","reason":"string"}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="path">/api/health/checks/alarms</td>
|
||||
<td>
|
||||
Checks that no alarms are raised. If everything is working correctly, will
|
||||
return HTTP status 200 with body: <pre>{"status":"ok"}</pre> If
|
||||
something fails, will return HTTP status 503 with the body of
|
||||
<pre>{"status":"failed","reason":"string","alarms":[{"resource":"string","node":"string"}]}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="path">/api/health/checks/local-alarms</td>
|
||||
<td>
|
||||
Checks that no alarms are raised in the given node.
|
||||
If everything is working correctly, will
|
||||
return HTTP status 200 with body: <pre>{"status":"ok"}</pre> If
|
||||
something fails, will return HTTP status 503 with the body of
|
||||
<pre>{"status":"failed","reason":"string","alarms":[{"resource":"string","node":"string"}]}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="path">/api/health/checks/certificate-expiration/<i>within</i>/<i>unit</i></td>
|
||||
<td>
|
||||
Checks the expiration date on the certificates for every listener configured to use TLS.
|
||||
If all certificates are valid it will return HTTP status 200 with body: <pre>{"status":"ok"}</pre> If any certificate expires, will return HTTP status 503 with the body of
|
||||
<pre>{"status":"failed","reason":"string","expired":[{"node":"string","protocol":"string","interface":"string","port":"integer","certfile":"string","cacertfile":"string","certfile_expires_on":"string","cacertfile_expires_on":"string"}]}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="path">/api/health/checks/port-listener/<i>port</i></td>
|
||||
<td>
|
||||
Checks if there is an active listener in the given node. If there is a listener it will
|
||||
return HTTP status 200 with body: <pre>{"status":"ok","port":"integer"}</pre>.
|
||||
If there is no active listener, will return HTTP status 503 with the body of
|
||||
<pre>{"status":"failed","reason":"string","missing":"integer","ports":["integer"]}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="path">/api/health/checks/protocol-listener/<i>protocol</i></td>
|
||||
<td>
|
||||
Checks if there is an active listener for given protocol. If there is a listener it will
|
||||
return HTTP status 200 with body: <pre>{"status":"ok","protocol":"string"}</pre>.
|
||||
If there is no active listener, will return HTTP status 503 with the body of
|
||||
<pre>{"status":"failed","reason":"string","missing":"integer","protocols":["string"]}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="path">/api/health/checks/virtual-hosts</td>
|
||||
<td>
|
||||
Checks if all vhosts are running in the given node. If everything is working
|
||||
correctly it will return HTTP status 200 with body: <pre>{"status":"ok"}</pre>.
|
||||
If there is any failure, will return HTTP status 503 with the body of
|
||||
<pre>{"status":"failed","reason":"string","virtual-hosts":["string"]}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="path">/api/health/checks/node-is-mirror-sync-critical</td>
|
||||
<td>
|
||||
Checks if there are classic mirrored queues without online synchronised mirrors
|
||||
(queues that would potentially lose data if the target node is shut down).
|
||||
If everything is working correctly it will return HTTP status 200 with body:
|
||||
<pre>{"status":"ok"}</pre>.
|
||||
If there is any classic mirrored queue without online synchronised mirrors,
|
||||
will return HTTP status 503 with the body of
|
||||
<pre>{"status":"failed","reason":"string","queues":[{"name":"string","readable_name":"string","virtual_host":"string","type":"string"}]}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="path">/api/health/checks/node-is-quorum-critical</td>
|
||||
<td>
|
||||
Checks if there are quorum queues with minimum online quorum (queues that
|
||||
would lose their quorum if the target node is shut down).
|
||||
If everything is working correctly it will return HTTP status 200 with body:
|
||||
<pre>{"status":"ok"}</pre>.
|
||||
If there is any quorum queue with minimum online quorum,
|
||||
will return HTTP status 503 with the body of
|
||||
<pre>{"status":"failed","reason":"string","queues":[{"name":"string","readable_name":"string","virtual_host":"string","type":"string"}]}</pre>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>X</td>
|
||||
<td></td>
|
||||
|
|
|
|||
Loading…
Reference in New Issue