TrueCloudLab/coredns
16
0
Fork 2
Code Issues Pull requests 3 Projects Releases Packages Wiki Activity Actions
coredns/plugin/metrics
History
Miek Gieben 99047aee9b
plugin/metrics: convience MustRegister function (#1332) 
This leave most of the code intact, but we need to stop vendoring
prometheus, because, again, plugins what want to use it. Not vendoring
prometheus makes my forward metrics show up again. Code looks bit
convoluted, but works:

~~~
	c.OnStartup(func() error {
		once.Do(func() {
			m := dnsserver.GetConfig(c).Handler("prometheus")
			if m == nil {
				return
			}
			if x, ok := m.(*metrics.Metrics); ok {
				x.MustRegister(RequestCount)
				x.MustRegister(RcodeCount)
				x.MustRegister(RequestDuration)
				x.MustRegister(HealthcheckFailureCount)
				x.MustRegister(SocketGauge)
			}
		})
	})
~~~
2017-12-27 14:14:53 +00:00
..
test Remove the word middleware (#1067) 2017-09-14 09:36:06 +01:00
vars Update timing histograms (#1253) 2017-11-27 21:34:26 +00:00
handler.go pkg: add dnstest (#1098) 2017-09-21 15:15:47 +01:00
metrics.go plugin/metrics: convience MustRegister function (#1332) 2017-12-27 14:14:53 +00:00
metrics_test.go plugin/metrics: Added New func (#1309) 2017-12-13 16:59:10 -05:00
README.md metrics: use exponentional buckets (#1261) 2017-12-01 11:15:05 +00:00
setup.go plugin/metrics: Added New func (#1309) 2017-12-13 16:59:10 -05:00
setup_test.go Remove the word middleware (#1067) 2017-09-14 09:36:06 +01:00

README.md

prometheus

prometheus enables Prometheus metrics.

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} - total query count.
  • coredns_dns_request_duration_seconds{zone} - duration to process each query.
  • coredns_dns_request_size_bytes{zone, proto} - size of the request in bytes.
  • coredns_dns_request_do_count_total{zone} - queries that have the DO bit set
  • coredns_dns_request_type_count_total{zone, type} - counter of queries per zone and type.
  • coredns_dns_response_size_bytes{zone, proto} - response size in bytes.
  • coredns_dns_response_rcode_count_total{zone, rcode} - response per zone and 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 holds the query type. It holds most common types (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 plugin chain are exported under the fake name "dropped" (without a closing dot - this is never a valid domain name).

Syntax

prometheus [ADDRESS]

For each zone that you want to see metrics for.

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

Examples

Use an alternative address:

. {
    prometheus localhost:9253
}

Or via an enviroment variable (this is supported throughout the Corefile): export PORT=9253, and then:

. {
    prometheus localhost:{$PORT}
}

Bugs

When reloading, we keep the handler running, meaning that any changes to the handler's address aren't picked up. You'll need to restart CoreDNS for that to happen.