mirror of
				https://github.com/coredns/coredns.git
				synced 2025-10-29 01:04:15 -04:00 
			
		
		
		
	auto make -f Makefile.doc
This commit is contained in:
		| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-ACL" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-ACL" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
| @@ -109,9 +109,9 @@ example.org { | |||||||
| If monitoring is enabled (via the \fIprometheus\fP plugin) then the following metrics are exported: | If monitoring is enabled (via the \fIprometheus\fP plugin) then the following metrics are exported: | ||||||
|  |  | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_request_block_count_total{server, zone}\fR - counter of DNS requests being blocked. | \fB\fCcoredns_dns_blocked_requests_total{server, zone}\fR - counter of DNS requests being blocked. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_request_allow_count_total{server}\fR - counter of DNS requests being allowed. | \fB\fCcoredns_dns_allowed_requests_total{server}\fR - counter of DNS requests being allowed. | ||||||
|  |  | ||||||
|  |  | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-ANY" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-ANY" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-AUTO" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-AUTO" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-AUTOPATH" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-AUTOPATH" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
| @@ -13,6 +13,9 @@ failures, the original reply is returned. Because \fIautopath\fP returns a reply | |||||||
| the original question it will add a CNAME that points from the original name (with the search path | the original question it will add a CNAME that points from the original name (with the search path | ||||||
| element in it) to the name of this answer. | element in it) to the name of this answer. | ||||||
|  |  | ||||||
|  | .PP | ||||||
|  | \fBNote\fP: There are several known issues.  See section below. | ||||||
|  |  | ||||||
| .SH "SYNTAX" | .SH "SYNTAX" | ||||||
| .PP | .PP | ||||||
| .RS | .RS | ||||||
| @@ -39,7 +42,7 @@ If a plugin implements the \fB\fCAutoPather\fR interface then it can be used. | |||||||
| If monitoring is enabled (via the \fIprometheus\fP plugin) then the following metric is exported: | If monitoring is enabled (via the \fIprometheus\fP plugin) then the following metric is exported: | ||||||
|  |  | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_autopath_success_count_total{server}\fR - counter of successfully autopath-ed queries. | \fB\fCcoredns_autopath_success_total{server}\fR - counter of successfully autopath-ed queries. | ||||||
|  |  | ||||||
|  |  | ||||||
| .PP | .PP | ||||||
| @@ -73,8 +76,19 @@ Use the search path dynamically retrieved from the \fIkubernetes\fP plugin. | |||||||
|  |  | ||||||
| .SH "KNOWN ISSUES" | .SH "KNOWN ISSUES" | ||||||
| .PP | .PP | ||||||
| In Kubernetes, \fIautopath\fP is not compatible with pods running from Windows nodes. | In Kubernetes, \fIautopath\fP can derive the wrong namespace of a client Pod (and therefore wrong search path) | ||||||
|  | in the following case.  To properly build the search path of a client \fIautopath\fP needs to | ||||||
|  | know the namespace of the a Pod making a DNS request. To do this, it relies on the | ||||||
|  | \fIkubernetes\fP plugin's Pod cache to resolve the client's IP address to a Pod.  The Pod cache is maintained by | ||||||
|  | an API watch on Pods.  When Pod IP assignments change, the Kubernetes API notifies CoreDNS via the API watch. | ||||||
|  | However, that notification is not instantaneous. In the case that a Pod is deleted, and it's IP is | ||||||
|  | immediately provisioned to a Pod in another namespace, and that new Pod make a DNS lookup \fIbefore\fP the API watch | ||||||
|  | can notify CoreDNS of the change, \fIautopath\fP will resolve the IP to the previous Pod's namespace. | ||||||
|  |  | ||||||
| .PP | .PP | ||||||
| If the server side search ultimately results in a negative answer (e.g. \fB\fCNXDOMAIN\fR), then the client will fruitlessly search all paths manually, thus negating the \fIautopath\fP optimization. | In Kubernetes, \fIautopath\fP is not compatible with Pods running from Windows nodes. | ||||||
|  |  | ||||||
|  | .PP | ||||||
|  | If the server side search ultimately results in a negative answer (e.g. \fB\fCNXDOMAIN\fR), then the client will | ||||||
|  | fruitlessly search all paths manually, thus negating the \fIautopath\fP optimization. | ||||||
|  |  | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-AZURE" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-AZURE" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
| @@ -23,6 +23,7 @@ azure RESOURCE\_GROUP:ZONE... { | |||||||
|     subscription SUBSCRIPTION\_ID |     subscription SUBSCRIPTION\_ID | ||||||
|     environment ENVIRONMENT |     environment ENVIRONMENT | ||||||
|     fallthrough [ZONES...] |     fallthrough [ZONES...] | ||||||
|  |     access private | ||||||
| } | } | ||||||
|  |  | ||||||
| .fi | .fi | ||||||
| @@ -41,22 +42,25 @@ to access the data in Azure. | |||||||
| \fB\fCfallthrough\fR If zone matches and no record can be generated, pass request to the next plugin. | \fB\fCfallthrough\fR If zone matches and no record can be generated, pass request to the next plugin. | ||||||
| If \fBZONES\fP is omitted, then fallthrough happens for all zones for which the plugin is | If \fBZONES\fP is omitted, then fallthrough happens for all zones for which the plugin is | ||||||
| authoritative. | authoritative. | ||||||
|  | .IP \(bu 4 | ||||||
|  | \fB\fCaccess\fR  specifies if the zone is \fB\fCpublic\fR or \fB\fCprivate\fR. Default is \fB\fCpublic\fR. | ||||||
|  |  | ||||||
|  |  | ||||||
| .SH "EXAMPLES" | .SH "EXAMPLES" | ||||||
| .PP | .PP | ||||||
| Enable the \fIazure\fP plugin with Azure credentials for the zone \fB\fCexample.org\fR: | Enable the \fIazure\fP plugin with Azure credentials for private zones \fB\fCexample.org\fR, \fB\fCexample.private\fR: | ||||||
|  |  | ||||||
| .PP | .PP | ||||||
| .RS | .RS | ||||||
|  |  | ||||||
| .nf | .nf | ||||||
| example.org { | example.org { | ||||||
|     azure resource\_group\_foo:example.org { |     azure resource\_group\_foo:example.org resource\_group\_foo:example.private { | ||||||
|       tenant 123abc\-123abc\-123abc\-123abc |       tenant 123abc\-123abc\-123abc\-123abc | ||||||
|       client 123abc\-123abc\-123abc\-234xyz |       client 123abc\-123abc\-123abc\-234xyz | ||||||
|       subscription 123abc\-123abc\-123abc\-563abc |       subscription 123abc\-123abc\-123abc\-563abc | ||||||
|       secret mysecret |       secret mysecret | ||||||
|  |       access private | ||||||
|     } |     } | ||||||
| } | } | ||||||
|  |  | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-BIND" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-BIND" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-BUFSIZE" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-BUFSIZE" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -107,7 +107,7 @@ If monitoring is enabled (via the \fIprometheus\fP plugin) then the following me | |||||||
|  |  | ||||||
| .PP | .PP | ||||||
| Cache types are either "denial" or "success". \fB\fCServer\fR is the server handling the request, see the | Cache types are either "denial" or "success". \fB\fCServer\fR is the server handling the request, see the | ||||||
| metrics plugin for documentation. | prometheus plugin for documentation. | ||||||
|  |  | ||||||
| .SH "EXAMPLES" | .SH "EXAMPLES" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-CHAOS" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-CHAOS" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-CLOUDDNS" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-CLOUDDNS" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-DEBUG" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-DEBUG" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-ERRATIC" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-ERRATIC" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-ERRORS" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-ERRORS" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-ETCD" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-ETCD" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-FILE" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-FILE" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -165,16 +165,16 @@ If monitoring is enabled (via the \fIprometheus\fP plugin) then the following me | |||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_forward_request_duration_seconds{to}\fR - duration per upstream interaction. | \fB\fCcoredns_forward_request_duration_seconds{to}\fR - duration per upstream interaction. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_forward_request_count_total{to}\fR - query count per upstream. | \fB\fCcoredns_forward_requests_total{to}\fR - query count per upstream. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_forward_response_rcode_count_total{to, rcode}\fR - count of RCODEs per upstream. | \fB\fCcoredns_forward_responses_total{to, rcode}\fR - count of RCODEs per upstream. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_forward_healthcheck_failure_count_total{to}\fR - number of failed health checks per upstream. | \fB\fCcoredns_forward_healthcheck_failures_total{to}\fR - number of failed health checks per upstream. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_forward_healthcheck_broken_count_total{}\fR - counter of when all upstreams are unhealthy, | \fB\fCcoredns_forward_healthcheck_broken_total{}\fR - counter of when all upstreams are unhealthy, | ||||||
| and we are randomly (this always uses the \fB\fCrandom\fR policy) spraying to an upstream. | and we are randomly (this always uses the \fB\fCrandom\fR policy) spraying to an upstream. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCmax_concurrent_reject_count_total{}\fR - counter of the number of queries rejected because the | \fB\fCmax_concurrent_rejects_total{}\fR - counter of the number of queries rejected because the | ||||||
| number of concurrent queries were at maximum. | number of concurrent queries were at maximum. | ||||||
| Where \fB\fCto\fR is one of the upstream servers (\fBTO\fP from the config), \fB\fCrcode\fR is the returned RCODE | Where \fB\fCto\fR is one of the upstream servers (\fBTO\fP from the config), \fB\fCrcode\fR is the returned RCODE | ||||||
| from the upstream. | from the upstream. | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-GRPC" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-GRPC" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
| @@ -95,9 +95,9 @@ If monitoring is enabled (via the \fIprometheus\fP plugin) then the following me | |||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_grpc_request_duration_seconds{to}\fR - duration per upstream interaction. | \fB\fCcoredns_grpc_request_duration_seconds{to}\fR - duration per upstream interaction. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_grpc_request_count_total{to}\fR - query count per upstream. | \fB\fCcoredns_grpc_requests_total{to}\fR - query count per upstream. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_grpc_response_rcode_count_total{to, rcode}\fR - count of RCODEs per upstream. | \fB\fCcoredns_grpc_responses_total{to, rcode}\fR - count of RCODEs per upstream. | ||||||
| and we are randomly (this always uses the \fB\fCrandom\fR policy) spraying to an upstream. | and we are randomly (this always uses the \fB\fCrandom\fR policy) spraying to an upstream. | ||||||
|  |  | ||||||
|  |  | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-HEALTH" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-HEALTH" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-IMPORT" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-IMPORT" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-LOADBALANCE" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-LOADBALANCE" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-LOG" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-LOG" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-LOOP" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-LOOP" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-METADATA" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-METADATA" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -15,21 +15,19 @@ The following metrics are exported: | |||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_build_info{version, revision, goversion}\fR - info about CoreDNS itself. | \fB\fCcoredns_build_info{version, revision, goversion}\fR - info about CoreDNS itself. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_panic_count_total{}\fR - total number of panics. | \fB\fCcoredns_panics_total{}\fR - total number of panics. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_dns_request_count_total{server, zone, proto, family}\fR - total query count. | \fB\fCcoredns_dns_requests_total{server, zone, proto, family, type}\fR - total query count. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_dns_request_duration_seconds{server, zone, type}\fR - duration to process each query. | \fB\fCcoredns_dns_request_duration_seconds{server, zone, type}\fR - duration to process each query. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_dns_request_size_bytes{server, zone, proto}\fR - size of the request in bytes. | \fB\fCcoredns_dns_request_size_bytes{server, zone, proto}\fR - size of the request in bytes. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_dns_request_do_count_total{server, zone}\fR -  queries that have the DO bit set | \fB\fCcoredns_dns_do_requests_total{server, zone}\fR -  queries that have the DO bit set | ||||||
| .IP \(bu 4 |  | ||||||
| \fB\fCcoredns_dns_request_type_count_total{server, zone, type}\fR - counter of queries per zone and type. |  | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_dns_response_size_bytes{server, zone, proto}\fR - response size in bytes. | \fB\fCcoredns_dns_response_size_bytes{server, zone, proto}\fR - response size in bytes. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_dns_response_rcode_count_total{server, zone, rcode}\fR - response per zone and rcode. | \fB\fCcoredns_dns_responses_total{server, zone, rcode}\fR - response per zone and rcode. | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_plugin_enabled{server, zone, name}\fR - indicates whether a plugin is enabled on per server and zone basis. | \fB\fCcoredns_plugin_enabled{server, zone, name}\fR - indicates whether a plugin is enabled on per server and zone basis. | ||||||
|  |  | ||||||
| @@ -52,8 +50,6 @@ The address family (\fB\fCfamily\fR) of the transport (1 = IP (IP version 4), 2 | |||||||
| \fB\fCtype\fR which holds the query type. It holds most common types (A, AAAA, MX, SOA, CNAME, PTR, TXT, | \fB\fCtype\fR 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 | NS, SRV, DS, DNSKEY, RRSIG, NSEC, NSEC3, IXFR, AXFR and ANY) and "other" which lumps together all | ||||||
| other types. | other types. | ||||||
| .IP \(bu 4 |  | ||||||
| The \fB\fCresponse_rcode_count_total\fR has an extra label \fB\fCrcode\fR which holds the rcode of the response. |  | ||||||
|  |  | ||||||
|  |  | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-NSID" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-NSID" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-PPROF" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-PPROF" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-READY" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-READY" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-RELOAD" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-RELOAD" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
| @@ -123,7 +123,7 @@ fail loading the new Corefile, abort and keep using the old process | |||||||
|  |  | ||||||
| .PP | .PP | ||||||
| After the aborted attempt to reload we are left with the old processes running, but the listener is | After the aborted attempt to reload we are left with the old processes running, but the listener is | ||||||
| closed in step 1; so the health endpoint is broken. The same can happen in the prometheus metrics plugin. | closed in step 1; so the health endpoint is broken. The same can happen in the prometheus plugin. | ||||||
|  |  | ||||||
| .PP | .PP | ||||||
| In general be careful with assigning new port and expecting reload to work fully. | In general be careful with assigning new port and expecting reload to work fully. | ||||||
| @@ -138,9 +138,14 @@ CoreDNS v1.7.0 and later does parse the Corefile and supports detecting changes | |||||||
| If monitoring is enabled (via the \fIprometheus\fP plugin) then the following metric is exported: | If monitoring is enabled (via the \fIprometheus\fP plugin) then the following metric is exported: | ||||||
|  |  | ||||||
| .IP \(bu 4 | .IP \(bu 4 | ||||||
| \fB\fCcoredns_reload_failed_count_total{}\fR - counts the number of failed reload attempts. | \fB\fCcoredns_reload_failed_total{}\fR - counts the number of failed reload attempts. | ||||||
|  | .IP \(bu 4 | ||||||
|  | \fB\fCcoredns_reload_version_info{hash, value}\fR - record the hash value during reload. | ||||||
|  |  | ||||||
|  |  | ||||||
|  | .PP | ||||||
|  | Currently the type of \fB\fChash\fR is "md5", the \fB\fCvalue\fR is the returned hash value. | ||||||
|  |  | ||||||
| .SH "ALSO SEE" | .SH "ALSO SEE" | ||||||
| .PP | .PP | ||||||
| See coredns-import(7) and corefile(5). | See coredns-import(7) and corefile(5). | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-ROOT" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-ROOT" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-ROUTE53" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-ROUTE53" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-SIGN" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-SIGN" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-TEMPLATE" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-TEMPLATE" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-TLS" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-TLS" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-TRACE" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-TRACE" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS-WHOAMI" 7 "January 2020" "CoreDNS" "CoreDNS Plugins" | .TH "COREDNS-WHOAMI" 7 "March 2020" "CoreDNS" "CoreDNS Plugins" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREDNS" 1 "January 2020" "CoreDNS" "CoreDNS" | .TH "COREDNS" 1 "March 2020" "CoreDNS" "CoreDNS" | ||||||
|  |  | ||||||
| .SH "COREDNS" | .SH "COREDNS" | ||||||
| .PP | .PP | ||||||
| @@ -58,5 +58,5 @@ Apache License 2.0 | |||||||
|  |  | ||||||
| .SH "SEE ALSO" | .SH "SEE ALSO" | ||||||
| .PP | .PP | ||||||
| Corefile(5) coredns-k8s_external(7) coredns-erratic(7) coredns-nsid(7) coredns-any(7) coredns-hosts(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-file(7) coredns-root(7) coredns-auto(7) coredns-pprof(7) coredns-dnstap(7) coredns-clouddns(7) coredns-bufsize(7) coredns-tls(7) coredns-loadbalance(7) coredns-cache(7) coredns-whoami(7) coredns-bind(7) coredns-loop(7) coredns-import(7) coredns-chaos(7) coredns-template(7) coredns-azure(7) coredns-autopath(7) coredns-log(7) coredns-kubernetes(7) coredns-forward(7) coredns-debug(7) coredns-secondary(7) coredns-route53(7) coredns-transfer(7) coredns-errors(7) coredns-ready(7) coredns-reload(7) coredns-rewrite(7) coredns-metrics(7) coredns-metadata(7) coredns-etcd(7) coredns-cancel(7) coredns-trace(7). | Corefile(5) coredns-k8s_external(7) coredns-any(7) coredns-hosts(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-kubernetes(7) coredns-file(7) coredns-nsid(7) coredns-auto(7) coredns-erratic(7) coredns-chaos(7) coredns-dnstap(7) coredns-pprof(7) coredns-bufsize(7) coredns-clouddns(7) coredns-loadbalance(7) coredns-log(7) coredns-root(7) coredns-whoami(7) coredns-dns64(7) coredns-loop(7) coredns-import(7) coredns-debug(7) coredns-template(7) coredns-azure(7) coredns-autopath(7) coredns-cache(7) coredns-forward(7) coredns-secondary(7) coredns-route53(7) coredns-transfer(7) coredns-bind(7) coredns-errors(7) coredns-ready(7) coredns-reload(7) coredns-rewrite(7) coredns-tls(7) coredns-metrics(7) coredns-metadata(7) coredns-etcd(7) coredns-cancel(7) coredns-trace(7). | ||||||
|  |  | ||||||
|   | |||||||
| @@ -1,5 +1,5 @@ | |||||||
| .\" Generated by Mmark Markdown Processer - mmark.miek.nl | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | ||||||
| .TH "COREFILE" 5 "December 2019" "CoreDNS" "CoreDNS" | .TH "COREFILE" 5 "March 2020" "CoreDNS" "CoreDNS" | ||||||
|  |  | ||||||
| .SH "NAME" | .SH "NAME" | ||||||
| .PP | .PP | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user