mirror of https://github.com/coredns/coredns.git synced 2025-10-31 10:13:14 -04:00

Files

Miek Gieben d563c62571 middleware/monitoring: add more monitoring (#182 )

* Split response size into normal responses and AXFR|IXFR responses.
* Split out incoming sizes as well in normal and AXFR|IXFRs.
* Add meta qtype to the monitored qtypes.
* Make duration to be exported in milliseconds instead of seconds.

2016-07-04 06:08:45 -04:00

1.7 KiB

Raw Blame History

prometheus

This module enables prometheus metrics for CoreDNS. The default location for the metrics is localhost:9153. The metrics path is fixed to /metrics.

The following metrics are exported:

coredns_dns_request_count_total{zone, proto, family}
coredns_dns_request_duration_milliseconds{zone}
coredns_dns_request_size_bytes{zone,, proto}
coredns_dns_request_transfer_size_bytes{zone,, proto}
coredns_dns_request_do_count_total{zone}
coredns_dns_request_type_count_total{zone, type}
coredns_dns_response_size_bytes{zone, proto}
coredns_dns_response_transfer_size_bytes{zone, proto}
coredns_dns_response_rcode_count_total{zone, rcode}

Each counter has a label zone which is the zonename used for the request/response.

Extra labels used are:

proto which holds the transport of the response ("udp" or "tcp")
The address family (family) of the transport (1 = IP (IP version 4), 2 = IP6 (IP version 6)).
type which old the query type, it holds the most common ones (A, AAAA, MX, SOA, CNAME, PTR, TXT, NS, SRV, DS, DNSKEY, RRSIG, NSEC, NSEC3, IXFR, AXFR and ANY) and "other" which lumps together all other types.
The response_rcode_count_total has an extra label rcode which holds the rcode of the response.

If monitoring is enabled queries that do not enter the middleware chain are exported under the fake domain "dropped" (without a closing dot).

Restarting CoreDNS will stop the monitoring. This is a bug. Also this upstream Caddy bug.

Syntax

prometheus

For each zone that you want to see metrics for.

It optionally takes an address where the metrics are exported, the default is localhost:9153. The metrics path is fixed to /metrics.

1.7 KiB Raw Blame History

prometheus

Syntax

Examples

1.7 KiB

Raw Blame History