mirror of https://github.com/coredns/coredns.git synced 2025-10-27 16:24:19 -04:00

Files

Miek Gieben c4ab98c6e3 Add middleware.NextOrFailure (#462 )

This checks if the next middleware to be called is nil, and if so returns
ServerFailure and an error. This makes the next calling more robust and
saves some lines of code.

Also prefix the error with the name of the middleware to aid in
debugging.

2016-12-20 18:58:05 +00:00

test

Update metric names (#371 )

2016-10-30 09:06:57 +00:00

vars

middleware/metrics: export actual size (#448 )

2016-11-29 11:02:43 +00:00

handler.go

Add middleware.NextOrFailure (#462 )

2016-12-20 18:58:05 +00:00

metrics_test.go

middleware/metrics: export ListenAddr (#366 )

2016-10-28 12:57:10 +01:00

metrics.go

middleware/metrics: export ListenAddr (#366 )

2016-10-28 12:57:10 +01:00

README.md

middleware/metrics: cleanup (#355 )

2016-10-26 10:01:52 +01:00

setup_test.go

tests: clean up output

2016-10-08 16:44:43 +01:00

setup.go

middleware/metrics: export ListenAddr (#366 )

2016-10-28 12:57:10 +01:00

README.md

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_do_count_total{zone}
coredns_dns_request_type_count_total{zone, type}
coredns_dns_response_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 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 middleware 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