mirror of https://github.com/coredns/coredns.git synced 2025-11-01 10:43:17 -04:00

Files

Miek Gieben 219bfd0493 middleware/metrics: cleanup (#355 )

* middleware/metrics: add more metrics

middleware/cache:
Add metrics for number of elements in the cache. Also export the total
size. Update README to detail the new metrics.

middleware/metrics

Move metrics into subpackage called "vars". This breaks the import
cycle and is cleaner. This allows vars.Report to be used in the
the dnsserver to log refused queries.

middleware/metrics: tests

Add tests to the metrics framework. The metrics/test subpackage allows
scraping of the local server. Do a few test scrape of the metrics that
are defined in the metrics middleware.

This also allows metrics integration tests to check if the caching and
dnssec middleware export their metrics correctly.

* update README

* typos

* fix tests

2016-10-26 10:01:52 +01:00

black_lies_test.go

middleware/file: proper support for wildcard (#323 )

2016-10-08 15:22:31 +01:00

black_lies.go

Add middleware/dnssec (#133 )

2016-04-26 17:57:11 +01:00

cache_test.go

Replace go-cache with golang-lru in dnssec (#336 )

2016-10-17 13:04:36 +01:00

cache.go

Add middleware/dnssec (#133 )

2016-04-26 17:57:11 +01:00

dnskey.go

Golint2 (#280 )

2016-09-23 09:14:12 +01:00

dnssec_test.go

Replace go-cache with golang-lru in dnssec (#336 )

2016-10-17 13:04:36 +01:00

dnssec.go

Replace go-cache with golang-lru in dnssec (#336 )

2016-10-17 13:04:36 +01:00

handler_test.go

Replace go-cache with golang-lru in dnssec (#336 )

2016-10-17 13:04:36 +01:00

handler.go

middleware/metrics: cleanup (#355 )

2016-10-26 10:01:52 +01:00

README.md

middleware/metrics: cleanup (#355 )

2016-10-26 10:01:52 +01:00

responsewriter.go

middleware/metrics: cleanup (#355 )

2016-10-26 10:01:52 +01:00

rrsig.go

Golint2 (#280 )

2016-09-23 09:14:12 +01:00

setup_test.go

Add cache_capacity option to dnssec middleware for the capacity of LRU cache (#339 )

2016-10-18 13:33:23 -07:00

setup.go

middleware/metrics: cleanup (#355 )

2016-10-26 10:01:52 +01:00

README.md

dnssec

dnssec enables on-the-fly DNSSEC signing of served data.

Syntax

dnssec [ZONES...]

ZONES zones that should be signed. If empty, the zones from the configuration block are used.

If keys are not specified (see below), a key is generated and used for all signing operations. The DNSSEC signing will treat this key a CSK (common signing key), forgoing the ZSK/KSK split. All signing operations are done online. Authenticated denial of existence is implemented with NSEC black lies. Using ECDSA as an algorithm is preferred as this leads to smaller signatures (compared to RSA). NSEC3 is not supported.

A single signing key can be specified by using the key directive.

NOTE: Key generation has not been implemented yet.

TODO(miek): think about key rollovers, and how to do them automatically.

dnssec [ZONES... ] {
    key file KEY...
    cache_capacity CAPACITY
}

key file indicates that key file(s) should be read from disk. When multiple keys are specified, RRsets will be signed with all keys. Generating a key can be done with dnssec-keygen: dnssec-keygen -a ECDSAP256SHA256 <zonename>. A key created for zone A can be safely used for zone B.
cache_capacity indicates the capacity of the LRU cache. The dnssec middleware uses LRU cache to manage objects and the default capacity is 10000.

Metrics

If monitoring is enabled (via the prometheus directive) then the following metrics are exported:

coredns_dnssec_size_guage{type} - total elements in the cache, type is "signature".
coredns_dnssec_capacity_guage{type} - total capacity of the cache, type is "signature".

README.md

dnssec

Syntax

Metrics

Examples