mirror of
https://github.com/coredns/coredns.git
synced 2025-11-24 04:34:01 -05:00
28 lines
692 B
Markdown
28 lines
692 B
Markdown
# health
|
|
|
|
*health* enables a simple health check endpoint.
|
|
|
|
By default, it listens on port 8080.
|
|
|
|
## Syntax
|
|
|
|
~~~
|
|
health [ADDRESS]
|
|
~~~
|
|
|
|
Optionally takes an address; the default is `:8080`. The health path is fixed to `/health`. The
|
|
health endpoint returns a 200 response code and the word "OK" when CoreDNS is healthy. It returns
|
|
a 503. *health* periodically (1s) polls plugin that exports health information. If any of the
|
|
plugin signals that it is unhealthy, the server will go unhealthy too. Each plugin that
|
|
supports health checks has a section "Health" in their README.
|
|
|
|
## Examples
|
|
|
|
Run another health endpoint on http://localhost:8091.
|
|
|
|
~~~ corefile
|
|
. {
|
|
health localhost:8091
|
|
}
|
|
~~~
|