coredns

README

CoreDNS monitoring with Netdata

CoreDNS is a fast and flexible DNS server.

This module monitor one or more CoreDNS instances depending on configuration.

Charts

It produces the following summary charts:

• Number Of DNS Requests in requests/s
• Number Of DNS Responses in responses/s
• Number Of Processed And Dropped DNS Requests in requests/s
• Number Of Dropped DNS Requests Because Of No Matching Zone in requests/s
• Number Of Panics in panics/s
• Number Of DNS Requests Per Transport Protocol in requests/s
• Number Of DNS Requests Per IP Family in requests/s
• Number Of DNS Requests Per Type in requests/s
• Number Of DNS Responses Per Rcode in responses/s

Per server charts (if configured):

• Number Of DNS Requests in requests/s
• Number Of DNS Responses in responses/s
• Number Of Processed And Dropped DNS Requests in requests/s
• Number Of DNS Requests Per Transport Protocol in requests/s
• Number Of DNS Requests Per IP Family in requests/s
• Number Of DNS Requests Per Type in requests/s
• Number Of DNS Responses Per Rcode in responses/s

Per zone charts (if configured):

• Number Of DNS Requests in requests/s
• Number Of DNS Responses in responses/s
• Number Of DNS Requests Per Transport Protocol in requests/s
• Number Of DNS Requests Per IP Family in requests/s
• Number Of DNS Requests Per Type in requests/s
• Number Of DNS Responses Per Rcode in responses/s

Configuration

Edit the go.d/coredns.conf configuration file using edit-config from the your agent's config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/coredns.conf

The module needs only the url to a CoreDNS metrics-address. Here is an example for several instances:

jobs:
  - name: local
    url : http://127.0.0.1:9153/metrics
      
  - name: remote
    url : http://203.0.113.10:9153/metrics

For all available options, please see the module's configuration file.

Troubleshooting

Check the module debug output. Run the following command as netdata user:

./go.d.plugin -d -m coredns

Documentation

Index

• type Chart
• type Charts
• type Config
• type CoreDNS
  • func New() *CoreDNS
  • func (cd CoreDNS) Charts() *Charts
  • func (cd CoreDNS) Check() bool
  • func (CoreDNS) Cleanup()
  • func (cd *CoreDNS) Collect() map[string]int64
  • func (cd *CoreDNS) Init() bool
• type Dim
• type Dims

Types

type Chart

type Chart = module.Chart

Chart is an alias for module.Chart

type Charts

type Charts = module.Charts

Charts is an alias for module.Charts

type Config

type Config struct {
	web.HTTP       `yaml:",inline"`
	PerServerStats matcher.SimpleExpr `yaml:"per_server_stats"`
	PerZoneStats   matcher.SimpleExpr `yaml:"per_zone_stats"`
}

Config is the CoreDNS module configuration.

type CoreDNS

type CoreDNS struct {
	module.Base
	Config `yaml:",inline"`
	// contains filtered or unexported fields
}

CoreDNS CoreDNS module.

func New

func New() *CoreDNS

New creates CoreDNS with default values.

func (CoreDNS) Charts

func (cd CoreDNS) Charts() *Charts

Charts creates Charts.

func (CoreDNS) Check

func (cd CoreDNS) Check() bool

Check makes check.

func (CoreDNS) Cleanup

func (CoreDNS) Cleanup()

Cleanup makes cleanup.

func (*CoreDNS) Collect

func (cd *CoreDNS) Collect() map[string]int64

Collect collects metrics.

func (*CoreDNS) Init

func (cd *CoreDNS) Init() bool

Init makes initialization.

type Dim

type Dim = module.Dim

Dim is an alias for module.Dim

type Dims

type Dims = module.Dims

Dims is an alias for module.Dims