diff options
Diffstat (limited to 'man/coredns-cache.7')
| -rw-r--r-- | man/coredns-cache.7 | 10 |
1 files changed, 9 insertions, 1 deletions
diff --git a/man/coredns-cache.7 b/man/coredns-cache.7 index 5481ced31..0349af0f6 100644 --- a/man/coredns-cache.7 +++ b/man/coredns-cache.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.miek.nl -.TH "COREDNS-CACHE" 7 "October 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-CACHE" 7 "December 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -48,6 +48,7 @@ cache [TTL] [ZONES...] { success CAPACITY [TTL] [MINTTL] denial CAPACITY [TTL] [MINTTL] prefetch AMOUNT [[DURATION] [PERCENTAGE%]] + serve\_stale [DURATION] } .fi @@ -70,6 +71,11 @@ Popular means \fBAMOUNT\fP queries have been seen with no gaps of \fBDURATION\fP \fBDURATION\fP defaults to 1m. Prefetching will happen when the TTL drops below \fBPERCENTAGE\fP, which defaults to \fB\fC10%\fR, or latest 1 second before TTL expiration. Values should be in the range \fB\fC[10%, 90%]\fR. Note the percent sign is mandatory. \fBPERCENTAGE\fP is treated as an \fB\fCint\fR. +.IP \(bu 4 +\fB\fCserve_stale\fR, when serve_stale is set, cache always will serve an expired entry to a client if there is one +available. When this happens, cache will attempt to refresh the cache entry after sending the expired cache +entry to the client. The responses have a TTL of 0. \fBDURATION\fP is how far back to consider +stale responses as fresh. The default duration is 1h. .SH "CAPACITY AND EVICTION" @@ -95,6 +101,8 @@ If monitoring is enabled (via the \fIprometheus\fP plugin) then the following me \fB\fCcoredns_cache_misses_total{server}\fR - Counter of cache misses. .IP \(bu 4 \fB\fCcoredns_cache_drops_total{server}\fR - Counter of dropped messages. +.IP \(bu 4 +\fB\fCcoredns_cache_served_stale_total{server}\fR - Counter of requests served from stale cache entries. .PP |