# Health Checker

A simple way to gauge the health of a VerneMQ cluster is to query the `/health` path on the [HTTP listener](/master/configuring-vernemq/http-listeners.md).

The health check will return **200** when VerneMQ is accepting connections and is joined with the cluster (for clustered setups). **503** will be returned in case any of those two conditions are not met. In addition to the simple `/health` path, the following options are available as well

* `/health/ping`: Cowboy (ie. Verne) is up.
* `/health/listeners`: will fail if any of the configured listeners is down or suspended
* `/health/listeners_full_cluster`: will fail if any listener is down or any of the cluster nodes is offline. (you probably don't want to use this to base automated actions on the status)

With the `ping` or `listeners` option, you can configure a health check for a single node, even if it is part of a cluster.

If you want to configure any automated actions based on the health check results, you need to chose an appropriate health check path. For example, you should not use the `/health` check (checking for full cluster consistency) to automatically restart a single node. This is of special importance for Kubernetes deployments.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vernemq.com/master/monitoring/health-check.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
