2016-04-03 09:15:55 +01:00
|
|
|
# prometheus
|
|
|
|
|
|
|
|
|
|
This module enables prometheus metrics for CoreDNS.
|
|
|
|
|
|
|
|
|
|
The following metrics are exported:
|
|
|
|
|
|
|
|
|
|
* coredns_dns_request_count_total
|
|
|
|
|
* coredns_dns_request_duration_seconds
|
|
|
|
|
* coredns_dns_response_size_bytes
|
|
|
|
|
* coredns_dns_response_rcode_count_total
|
|
|
|
|
|
2016-04-06 09:21:46 +01:00
|
|
|
Each counter has a label `zone` which is the zonename used for the request/response,
|
|
|
|
|
and a label `qtype` which old the query type.
|
|
|
|
|
The `response_rcode_count_total` has an extra label `rcode` which holds the rcode
|
|
|
|
|
of the response.
|
2016-04-03 09:15:55 +01:00
|
|
|
|
2016-04-06 22:29:33 +01:00
|
|
|
If monitoring is enabled queries that do not enter the middleware chain are exported
|
|
|
|
|
under the fake domain "dropped" (without a closing dot).
|
|
|
|
|
|
2016-04-03 09:15:55 +01:00
|
|
|
Restarting CoreDNS will stop the monitoring. This is a bug. Also [this upstream
|
|
|
|
|
Caddy bug](https://github.com/mholt/caddy/issues/675).
|
|
|
|
|
|
|
|
|
|
## Syntax
|
|
|
|
|
|
|
|
|
|
~~~
|
|
|
|
|
prometheus
|
|
|
|
|
~~~
|
|
|
|
|
|
|
|
|
|
For each zone that you want to see metrics for.
|
|
|
|
|
|
|
|
|
|
It optionally takes an address where the metrics are exported, the default
|
2016-04-06 09:21:46 +01:00
|
|
|
is `localhost:9135`. The metrics path is fixed to `/metrics`.
|
2016-04-03 09:15:55 +01:00
|
|
|
|
|
|
|
|
## Examples
|
