Mirrors/coredns
1
0
Fork 0
mirror of https://github.com/coredns/coredns.git synced 2025-10-28 00:34:24 -04:00
Code Issues Packages Projects Releases Wiki Activity

auto make -f Makefile.doc

Browse Source
This commit is contained in:
coredns-auto-go-mod-tidy[bot]
2020-10-16 12:29:11 +00:00
parent 04f2ecc87f
commit 1f07f7dddd
2 changed files with 32 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
man/coredns-autopath.7
View File

@@ -7,14 +7,14 @@
.SH "DESCRIPTION" .SH "DESCRIPTION"
.PP .PP
If it sees a query that matches the first element of the configured search path, \fIautopath\fP will If the \fIautopath\fP plugin sees a query that matches the first element of the configured search path, it will
follow the chain of search path elements and return the first reply that is not NXDOMAIN. On any follow the chain of search path elements and return the first reply that is not NXDOMAIN. On any
failures, the original reply is returned. Because \fIautopath\fP returns a reply for a name that wasn't failures, the original reply is returned. Because \fIautopath\fP returns a reply for a name that wasn't
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 .PP
\fBNote\fP: There are several known issues. See section below. \fBNote\fP: There are several known issues, see the "Bugs" section below.
.SH "SYNTAX" .SH "SYNTAX"
.PP .PP
@@ -35,7 +35,7 @@ query) to retrieve the search list it should use.
.PP .PP
If a plugin implements the \fB\fCAutoPather\fR interface then it can be used. If a plugin implements the \fB\fCAutoPather\fR interface then it can be used by \fIautopath\fP.
.SH "METRICS" .SH "METRICS"
.PP .PP
@@ -74,21 +74,22 @@ autopath @kubernetes
.PP .PP
Use the search path dynamically retrieved from the \fIkubernetes\fP plugin. Use the search path dynamically retrieved from the \fIkubernetes\fP plugin.
.SH "KNOWN ISSUES" .SH "BUGS"
.PP .PP
In Kubernetes, \fIautopath\fP can derive the wrong namespace of a client Pod (and therefore wrong search path) In Kubernetes, \fIautopath\fP can derive the wrong namespace of a client Pod (and therefore wrong search
in the following case. To properly build the search path of a client \fIautopath\fP needs to path) in the following case. To properly build the search path of a client \fIautopath\fP needs to know
know the namespace of the a Pod making a DNS request. To do this, it relies on the the namespace of the a Pod making a DNS request. To do this, it relies on the \fIkubernetes\fP plugin's
\fIkubernetes\fP plugin's Pod cache to resolve the client's IP address to a Pod. The Pod cache is maintained by Pod cache to resolve the client's IP address to a Pod. The Pod cache is maintained by an API watch
an API watch on Pods. When Pod IP assignments change, the Kubernetes API notifies CoreDNS via the 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 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 immediately provisioned to a Pod in another namespace, and that new Pod make a DNS lookup \fIbefore\fP
can notify CoreDNS of the change, \fIautopath\fP will resolve the IP to the previous Pod's namespace. the API watch can notify CoreDNS of the change, \fIautopath\fP will resolve the IP to the previous Pod's
namespace.
.PP .PP
In Kubernetes, \fIautopath\fP is not compatible with Pods running from Windows nodes. In Kubernetes, \fIautopath\fP is not compatible with Pods running from Windows nodes.
.PP .PP
If the server side search ultimately results in a negative answer (e.g. \fB\fCNXDOMAIN\fR), then the client will If the server side search ultimately results in a negative answer (e.g. \fB\fCNXDOMAIN\fR), then the client
fruitlessly search all paths manually, thus negating the \fIautopath\fP optimization. will fruitlessly search all paths manually, thus negating the \fIautopath\fP optimization.

17
man/coredns-trace.7
View File

@@ -50,6 +50,19 @@ trace [ENDPOINT\-TYPE] [ENDPOINT] {
.fi .fi
.RE .RE
.PP
.RS
.nf
trace datadog {
every AMOUNT
service NAME
datadog\_analytics\_rate RATE
}
.fi
.RE
.IP \(bu 4 .IP \(bu 4
\fB\fCevery\fR \fBAMOUNT\fP will only trace one query of each AMOUNT queries. For example, to trace 1 in every \fB\fCevery\fR \fBAMOUNT\fP will only trace one query of each AMOUNT queries. For example, to trace 1 in every
100 queries, use AMOUNT of 100. The default is 1. 100 queries, use AMOUNT of 100. The default is 1.
@@ -58,6 +71,10 @@ trace [ENDPOINT\-TYPE] [ENDPOINT] {
Default is \fB\fCcoredns\fR. Default is \fB\fCcoredns\fR.
.IP \(bu 4 .IP \(bu 4
\fB\fCclient_server\fR will enable the \fB\fCClientServerSameSpan\fR OpenTracing feature. \fB\fCclient_server\fR will enable the \fB\fCClientServerSameSpan\fR OpenTracing feature.
.IP \(bu 4
\fB\fCdatadog_analytics_rate\fR \fBRATE\fP will enable trace analytics
\[la]https://docs.datadoghq.com/tracing/app_analytics\[ra] on the traces sent
from \fI0\fP to \fI1\fP, \fI1\fP being every trace sent will be analyzed. This is a datadog only feature.
.SH "ZIPKIN" .SH "ZIPKIN"