diff options
Diffstat (limited to 'man/coredns-kubernetes.7')
| -rw-r--r-- | man/coredns-kubernetes.7 | 35 |
1 files changed, 30 insertions, 5 deletions
diff --git a/man/coredns-kubernetes.7 b/man/coredns-kubernetes.7 index 2c7baf8c3..e3b5e3177 100644 --- a/man/coredns-kubernetes.7 +++ b/man/coredns-kubernetes.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-KUBERNETES" 7 "September 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-KUBERNETES" 7 "October 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -37,7 +37,7 @@ kubernetes [ZONES...] .RE .PP -With only the directive specified, the \fIkubernetes\fP plugin will default to the zone specified in +With only the plugin specified, the \fIkubernetes\fP plugin will default to the zone specified in the server's block. It will handle all queries in that zone and connect to Kubernetes in-cluster. It will not provide PTR records for services or A records for pods. If \fBZONES\fP is used it specifies all the zones the plugin should be authoritative for. @@ -308,9 +308,6 @@ For example, wildcards can be used to resolve all Endpoints for a Service as \fB .fi .RE -.PP -This response can be randomized using the \fB\fCloadbalance\fR plugin - .SH "METADATA" .PP The kubernetes plugin will publish the following metadata, if the \fImetadata\fP @@ -334,3 +331,31 @@ kubernetes/client-namespace: the client pod's namespace, if \fB\fCpods verified\ kubernetes/client-pod-name: the client pod's name, if \fB\fCpods verified\fR mode is enabled +.SH "METRICS" +.PP +If monitoring is enabled (via the \fIprometheus\fP plugin) then the following metrics are exported: + +.IP \(bu 4 +\fB\fCcoredns_kubernetes_dns_programming_duration_seconds{service_kind}\fR - Exports the +DNS programming latency SLI +\[la]https://github.com/kubernetes/community/blob/master/sig-scalability/slos/dns_programming_latency.md\[ra]. +The metrics has the \fB\fCservice_kind\fR label that identifies the kind of the +kubernetes service +\[la]https://kubernetes.io/docs/concepts/services-networking/service\[ra]. +It may take one of the three values: + +.RS +.IP \(en 4 +\fB\fCcluster_ip\fR +.IP \(en 4 +\fB\fCheadless_with_selector\fR +.IP \(en 4 +\fB\fCheadless_without_selector\fR + +.RE + + +.SH "BUGS" +.PP +The duration metric only supports the "headless\fIwith\fPselector" service currently. + |