aboutsummaryrefslogtreecommitdiff
path: root/man/coredns-forward.7
diff options
context:
space:
mode:
Diffstat (limited to 'man/coredns-forward.7')
-rw-r--r--man/coredns-forward.718
1 files changed, 8 insertions, 10 deletions
diff --git a/man/coredns-forward.7 b/man/coredns-forward.7
index c4ee3ff06..865384416 100644
--- a/man/coredns-forward.7
+++ b/man/coredns-forward.7
@@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
-.TH "COREDNS-FORWARD" 7 "June 2020" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-FORWARD" 7 "July 2020" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP
@@ -11,14 +11,12 @@ The \fIforward\fP plugin re-uses already opened sockets to the upstreams. It sup
DNS-over-TLS and uses in band health checking.
.PP
-When it detects an error a health check is performed. This checks runs in a loop, starting with
-a \fI0.5s\fP interval and exponentially backing off with randomized intervals up to \fI15s\fP for as long
-as the upstream reports unhealthy. The exponential backoff will reset to \fI0.5s\fP after 2 minutes.
-Once healthy we stop health checking (until the next error). The health checks use a recursive
-DNS query (\fB\fC. IN NS\fR) to get upstream health. Any response that is not a network error (REFUSED,
-NOTIMPL, SERVFAIL, etc) is taken as a healthy upstream. The health check uses the same protocol as
-specified in \fBTO\fP. If \fB\fCmax_fails\fR is set to 0, no checking is performed and upstreams will always
-be considered healthy.
+When it detects an error a health check is performed. This checks runs in a loop, performing each
+check at a \fI0.5s\fP interval for as long as the upstream reports unhealthy. Once healthy we stop
+health checking (until the next error). The health checks use a recursive DNS query (\fB\fC. IN NS\fR)
+to get upstream health. Any response that is not a network error (REFUSED, NOTIMPL, SERVFAIL, etc)
+is taken as a healthy upstream. The health check uses the same protocol as specified in \fBTO\fP. If
+\fB\fCmax_fails\fR is set to 0, no checking is performed and upstreams will always be considered healthy.
.PP
When \fIall\fP upstreams are down it assumes health checking as a mechanism has failed and will try to
@@ -165,7 +163,7 @@ If monitoring is enabled (via the \fIprometheus\fP plugin) then the following me
.IP \(bu 4
\fB\fCcoredns_forward_requests_total{to}\fR - query count per upstream.
.IP \(bu 4
-\fB\fCcoredns_forward_responses_total{to}\fR - Counter of responses made per upstream.
+\fB\fCcoredns_forward_responses_total{to}\fR - Counter of responses received per upstream.
.IP \(bu 4
\fB\fCcoredns_forward_request_duration_seconds{to}\fR - duration per upstream interaction.
.IP \(bu 4