mirror of
https://github.com/coredns/coredns.git
synced 2025-11-15 16:32:23 -05:00
Run makefile.doc (#3365)
Generate manual pages; no other changes. Signed-off-by: Miek Gieben <miek@miek.nl>
This commit is contained in:
@@ -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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user