FreeBSD Manual Pages
COREDNS-METRICS(7) CoreDNS Plugins COREDNS-METRICS(7) NAME prometheus - enables Prometheus <https://prometheus.io/> metrics. DESCRIPTION With prometheus you export metrics from CoreDNS and any plugin that has them. The default location for the metrics is localhost:9153. The met- rics path is fixed to /metrics. The following metrics are exported: • coredns_build_info{version, revision, goversion} - info about CoreDNS itself. • coredns_panics_total{} - total number of panics. • coredns_dns_requests_total{server, zone, proto, family, type} - to- tal query count. • coredns_dns_request_duration_seconds{server, zone, type} - duration to process each query. • coredns_dns_request_size_bytes{server, zone, proto} - size of the request in bytes. • coredns_dns_do_requests_total{server, zone} - queries that have the DO bit set • coredns_dns_response_size_bytes{server, zone, proto} - response size in bytes. • coredns_dns_responses_total{server, zone, rcode} - response per zone and rcode. • coredns_plugin_enabled{server, zone, name} - indicates whether a plugin is enabled on per server and zone basis. Each counter has a label zone which is the zonename used for the re- quest/response. Extra labels used are: • server is identifying the server responsible for the request. This is a string formatted as the server's listening address: <scheme>://[<bind>]:<port>. I.e. for a "normal" DNS server this is dns://:53. If you are using the bind plugin an IP address is in- cluded, e.g.: dns://127.0.0.53:53. • 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. 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). This plugin can only be used once per Server Block. SYNTAX prometheus [ADDRESS] For each zone that you want to see metrics for. It optionally takes a bind address to which the metrics are exported; the default listens on localhost:9153. The metrics path is fixed to /metrics. EXAMPLES Use an alternative listening address: . { prometheus localhost:9253 } Or via an environment variable (this is supported throughout the Core- file): export PORT=9253, and then: . { prometheus localhost:{$PORT} } BUGS When reloading, the Prometheus handler is stopped before the new server instance is started. If that new server fails to start, then the ini- tial server instance is still available and DNS queries still served, but Prometheus handler stays down. Prometheus will not reply HTTP re- quest until a successful reload or a complete restart of CoreDNS. Only the plugins that register as Handler are visible in coredns_plugin_en- abled{server, zone, name}. As of today the plugins reload and bind will not be reported. CoreDNS March 2021 COREDNS-METRICS(7)
NAME | DESCRIPTION | SYNTAX | EXAMPLES | BUGS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=coredns-metrics&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>