Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
COREDNS-LOCAL(7)		CoreDNS	Plugins		      COREDNS-LOCAL(7)

NAME
       local - respond to local	names.

DESCRIPTION
       local  will  respond with a basic reply to a "local request". Local re-
       quest are defined to be names in	the following zones: localhost,	 0.in-
       addr.arpa,  127.in-addr.arpa  and 255.in-addr.arpa and any query	asking
       for localhost.<domain>. When seeing the latter a	metric counter is  in-
       creased and if debug is enabled a debug log is emitted.

       With  local  enabled any	query falling under these zones	will get a re-
       ply. The	prevents the query from	"escaping" to the internet and putting
       strain on external infrastructure.

       The zones are mostly empty, only	 localhost.  address  records  (A  and
       AAAA) are defined and a 1.0.0.127.in-addr.arpa. reverse (PTR) record.

SYNTAX
	      local

METRICS
       If monitoring is	enabled	(via the prometheus plugin) then the following
       metric is exported:

          coredns_local_localhost_requests_total{}  - a counter of the	number
	   of localhost.<domain> requests CoreDNS has seen. Note this does not
	   count localhost. queries.

       Note that this metric does not have a server label, because  it's  more
       interesting  to find the	client(s) performing these queries than	to see
       which server handled it.	You'll need to inspect the debug  log  to  get
       the client IP address.

EXAMPLES
	      .	{
		  local
	      }

BUGS
       Only  the  in-addr.arpa.	reverse	zone is	implemented, ip6.arpa. queries
       are not intercepted.

SEE ALSO
       BIND9's configuration in	Debian comes with these	 zones	preconfigured.
       See the debug plugin for	enabling debug logging.

CoreDNS				  March	2021		      COREDNS-LOCAL(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=coredns-local&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>

home | help