sync docs

content/plugins/auto.md

@@ -4,7 +4,7 @@ description = "*auto* enables serving zone data from an RFC 1035-style master fi
 weight = 1
 tags = [ "plugin", "auto" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.860718"
+date = "2018-03-26T06:36:14.770368"
 +++
 
 ## Description

content/plugins/autopath.md

@@ -4,7 +4,7 @@ description = "*autopath* allows for server-side search path completion."
 weight = 2
 tags = [ "plugin", "autopath" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.861181"
+date = "2018-03-26T06:36:14.771073"
 +++
 
 ## Description

content/plugins/bind.md

@@ -4,7 +4,7 @@ description = "*bind* overrides the host to which the server should bind."
 weight = 3
 tags = [ "plugin", "bind" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.861436"
+date = "2018-03-26T06:36:14.771629"
 +++
 
 ## Description

content/plugins/cache.md

@@ -4,7 +4,7 @@ description = "*cache* enables a frontend cache."
 weight = 4
 tags = [ "plugin", "cache" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.861636"
+date = "2018-03-26T06:36:14.771907"
 +++
 
 ## Description
@@ -60,6 +60,7 @@ If monitoring is enabled (via the *prometheus* directive) then the following met
 * `coredns_cache_capacity{type}` - Total capacity of the cache by cache type.
 * `coredns_cache_hits_total{type}` - Counter of cache hits by cache type.
 * `coredns_cache_misses_total{}` - Counter of cache misses.
+* `coredns_cache_drops_total{}` - Counter of dropped messages.
 
 Cache types are either "denial" or "success".
 

content/plugins/chaos.md

@@ -4,7 +4,7 @@ description = "*chaos* allows for responding to TXT queries in the CH class."
 weight = 5
 tags = [ "plugin", "chaos" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.861817"
+date = "2018-03-26T06:36:14.772444"
 +++
 
 ## Description

content/plugins/debug.md

@@ -4,7 +4,7 @@ description = "*debug* disables the automatic recovery upon a crash so that you'
 weight = 6
 tags = [ "plugin", "debug" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.862025"
+date = "2018-03-26T06:36:14.772946"
 +++
 
 ## Description

content/plugins/dnssec.md

@@ -4,7 +4,7 @@ description = "*dnssec* enable on-the-fly DNSSEC signing of served data."
 weight = 7
 tags = [ "plugin", "dnssec" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.862305"
+date = "2018-03-26T06:36:14.773478"
 +++
 
 ## Description

content/plugins/dnstap.md

@@ -4,7 +4,7 @@ description = "*dnstap* enable logging to dnstap"
 weight = 8
 tags = [ "plugin", "dnstap" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.862552"
+date = "2018-03-26T06:36:14.773980"
 +++
 
 ## Description

content/plugins/erratic.md

@@ -4,7 +4,7 @@ description = "*erratic* a plugin useful for testing client behavior."
 weight = 9
 tags = [ "plugin", "erratic" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.862741"
+date = "2018-03-26T06:36:14.774559"
 +++
 
 ## Description

content/plugins/errors.md

@@ -4,7 +4,7 @@ description = "*errors* enable error logging."
 weight = 10
 tags = [ "plugin", "errors" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.862907"
+date = "2018-03-26T06:36:14.775048"
 +++
 
 ## Description

content/plugins/etcd.md

@@ -4,7 +4,7 @@ description = "*etcd* enables reading zone data from an etcd instance."
 weight = 11
 tags = [ "plugin", "etcd" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.863129"
+date = "2018-03-26T06:36:14.775646"
 +++
 
 ## Description

content/plugins/federation.md

@@ -4,7 +4,7 @@ description = "*federation* enables federated queries to be resolved via the kub
 weight = 12
 tags = [ "plugin", "federation" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.863318"
+date = "2018-03-26T06:36:14.776193"
 +++
 
 ## Description

content/plugins/file.md

@@ -4,7 +4,7 @@ description = "*file* enables serving zone data from an RFC 1035-style master fi
 weight = 13
 tags = [ "plugin", "file" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.863491"
+date = "2018-03-26T06:36:14.776738"
 +++
 
 ## Description

content/plugins/forward.md

@@ -4,7 +4,7 @@ description = "*forward* facilitates proxying DNS messages to upstream resolvers
 weight = 14
 tags = [ "plugin", "forward" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.863726"
+date = "2018-03-26T06:36:14.777363"
 +++
 
 ## Description

content/plugins/health.md

@@ -4,7 +4,7 @@ description = "*health* enables a health check endpoint."
 weight = 15
 tags = [ "plugin", "health" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.863930"
+date = "2018-03-26T06:36:14.777913"
 +++
 
 ## Description

content/plugins/hosts.md

@@ -4,7 +4,7 @@ description = "*hosts* enables serving zone data from a `/etc/hosts` style file.
 weight = 16
 tags = [ "plugin", "hosts" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.864118"
+date = "2018-03-26T06:36:14.778188"
 +++
 
 ## Description
@@ -51,23 +51,29 @@ Load `/etc/hosts` file.
 Load `example.hosts` file in the current directory.
 
 ~~~
+. {
     hosts example.hosts
+}
 ~~~
 
 Load example.hosts file and only serve example.org and example.net from it and fall through to the
 next plugin if query doesn't match.
 
 ~~~
+. {
     hosts example.hosts example.org example.net {
         fallthrough
     }
+}
 ~~~
 
 Load hosts file inlined in Corefile.
 
 ~~~
+. {
     hosts example.hosts example.org {
         10.0.0.1 example.org
         fallthrough
     }
+}
 ~~~

content/plugins/kubernetes.md

@@ -4,7 +4,7 @@ description = "*kubernetes* enables the reading zone data from a Kubernetes clus
 weight = 17
 tags = [ "plugin", "kubernetes" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.864268"
+date = "2018-03-26T06:36:14.778948"
 +++
 
 ## Description
@@ -196,13 +196,14 @@ feature enables serving federated domains from the kubernetes clusters.
 Some query labels accept a wildcard value to match any value.  If a label is a valid wildcard (\*,
 or the word "any"), then that label will match all values.  The labels that accept wildcards are:
 
- * _service_ in an `A` record request: _service_.namespace.svc.zone, e.g. `*.ns.svc.myzone.local`
- * _namespace_ in an `A` record request: service._namespace_.svc.zone, e.g. `nginx.*.svc.myzone.local`
+ * _endpoint_ in an `A` record request: _endpoint_.service.namespace.svc.zone, e.g. `*.nginx.ns.svc.cluster.local`
+ * _service_ in an `A` record request: _service_.namespace.svc.zone, e.g. `*.ns.svc.cluster.local`
+ * _namespace_ in an `A` record request: service._namespace_.svc.zone, e.g. `nginx.*.svc.cluster.local`
  * _port and/or protocol_ in an `SRV` request: __port_.__protocol_.service.namespace.svc.zone.,
-   e.g. `_http.*.service.ns.svc.`
+   e.g. `_http.*.service.ns.svc.cluster.local`
  * multiple wild cards are allowed in a single query, e.g. `A` Request `*.*.svc.zone.` or `SRV` request `*.*.*.*.svc.zone.`
  
- * Wildcard can be used also to resolve PODs IPs as `A` records in a Service with ClusterIP. e.g.: `*.service.ns.svc.myzone.local` will return the PODs IPs as the following:
+ For example, Wildcards can be used to resolve all Endpoints for a Service as `A` records. e.g.: `*.service.ns.svc.myzone.local` will return the Endpoint IPs in the Service `service` in namespace `default`:
  ```
 *.service.default.svc.cluster.local. 5	IN A	192.168.10.10
 *.service.default.svc.cluster.local. 5	IN A	192.168.25.15

content/plugins/loadbalance.md

@@ -4,7 +4,7 @@ description = "*loadbalance* acts as a round-robin DNS loadbalancer by randomizi
 weight = 18
 tags = [ "plugin", "loadbalance" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.864443"
+date = "2018-03-26T06:36:14.779541"
 +++
  in the answer.
 

content/plugins/log.md

@@ -4,7 +4,7 @@ description = "*log* enables query logging to standard output."
 weight = 19
 tags = [ "plugin", "log" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.864629"
+date = "2018-03-26T06:36:14.780062"
 +++
 
 ## Description

content/plugins/metrics.md

@@ -4,7 +4,7 @@ description = "*prometheus* enables [Prometheus](https://prometheus.io/) metrics
 weight = 20
 tags = [ "plugin", "metrics" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.864825"
+date = "2018-03-26T06:36:14.780589"
 +++
 
 ## Description

content/plugins/nsid.md

@@ -4,7 +4,7 @@ description = "*nsid* adds an identifier of this server to each reply."
 weight = 21
 tags = [ "plugin", "nsid" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.865007"
+date = "2018-03-26T06:36:14.781102"
 +++
 
 ## Description

content/plugins/pprof.md

@@ -4,7 +4,7 @@ description = "*pprof* publishes runtime profiling data at endpoints under `/deb
 weight = 22
 tags = [ "plugin", "pprof" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.865229"
+date = "2018-03-26T06:36:14.781649"
 +++
 
 ## Description

content/plugins/proxy.md

@@ -4,7 +4,7 @@ description = "*proxy* facilitates both a basic reverse proxy and a robust load
 weight = 23
 tags = [ "plugin", "proxy" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.865488"
+date = "2018-03-26T06:36:14.782240"
 +++
 
 ## Description

content/plugins/reload.md

@@ -4,7 +4,7 @@ description = "*reload* allows automatic reload of a changed Corefile"
 weight = 24
 tags = [ "plugin", "reload" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.865630"
+date = "2018-03-26T06:36:14.782749"
 +++
 
 ## Description

content/plugins/reverse.md

@@ -4,7 +4,7 @@ description = "*reverse* allows for dynamic responses to PTR and the related A/A
 weight = 25
 tags = [ "plugin", "reverse" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.865813"
+date = "2018-03-26T06:36:14.783276"
 +++
 
 ## Description

content/plugins/rewrite.md

@@ -4,7 +4,7 @@ description = "*rewrite* performs internal message rewriting."
 weight = 26
 tags = [ "plugin", "rewrite" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.866057"
+date = "2018-03-26T06:36:14.783877"
 +++
 
 ## Description

content/plugins/root.md

@@ -4,7 +4,7 @@ description = "*root* simply specifies the root of where to find (zone) files."
 weight = 27
 tags = [ "plugin", "root" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.866228"
+date = "2018-03-26T06:36:14.784389"
 +++
 
 ## Description

content/plugins/route53.md

@@ -4,7 +4,7 @@ description = "*route53* enables serving zone data from AWS route53."
 weight = 28
 tags = [ "plugin", "route53" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.866394"
+date = "2018-03-26T06:36:14.784909"
 +++
 
 ## Description

content/plugins/secondary.md

@@ -4,7 +4,7 @@ description = "*secondary* enables serving a zone retrieved from a primary serve
 weight = 29
 tags = [ "plugin", "secondary" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.866579"
+date = "2018-03-26T06:36:14.785347"
 +++
 
 ## Description

content/plugins/template.md

@@ -4,7 +4,7 @@ description = "*template* allows for dynamic responses based on the incoming que
 weight = 30
 tags = [ "plugin", "template" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.866888"
+date = "2018-03-26T06:36:14.786011"
 +++
 
 ## Description

content/plugins/tls.md

@@ -4,7 +4,7 @@ description = "*tls* allows you to configure the server certificates for the TLS
 weight = 31
 tags = [ "plugin", "tls" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.867103"
+date = "2018-03-26T06:36:14.786560"
 +++
 
 ## Description

content/plugins/trace.md

@@ -4,7 +4,7 @@ description = "*trace* enables OpenTracing-based tracing of DNS requests as they
 weight = 32
 tags = [ "plugin", "trace" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.867222"
+date = "2018-03-26T06:36:14.787026"
 +++
 
 ## Description

content/plugins/whoami.md

@@ -4,7 +4,7 @@ description = "*whoami* returns your resolver's local IP address, port and trans
 weight = 33
 tags = [ "plugin", "whoami" ]
 categories = [ "plugin" ]
-date = "2018-03-13T14:42:31.867409"
+date = "2018-03-26T06:36:14.787575"
 +++
 
 ## Description