powerdns

README

PowerDNS Input Plugin

The powerdns plugin gathers metrics about PowerDNS using unix socket.

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# Read metrics from one or many PowerDNS servers
[[inputs.powerdns]]
  # An array of sockets to gather stats about.
  # Specify a path to unix socket.
  #
  # If no servers are specified, then '/var/run/pdns.controlsocket' is used as the path.
  unix_sockets = ["/var/run/pdns.controlsocket"]

Permissions

Telegraf will need access to the powerdns control socket. On many systems this can be accomplished by adding the telegraf user to the pdns group:

usermod telegraf -a -G pdns

Additionally, telegraf may need additional permissions. Look at the socket-mode PowerDNS option to set permissions on the socket.

Metrics

• powerdns
  • corrupt-packets
  • deferred-cache-inserts
  • deferred-cache-lookup
  • dnsupdate-answers
  • dnsupdate-changes
  • dnsupdate-queries
  • dnsupdate-refused
  • packetcache-hit
  • packetcache-miss
  • packetcache-size
  • query-cache-hit
  • query-cache-miss
  • rd-queries
  • recursing-answers
  • recursing-questions
  • recursion-unanswered
  • security-status
  • servfail-packets
  • signatures
  • tcp-answers
  • tcp-queries
  • timedout-packets
  • udp-answers
  • udp-answers-bytes
  • udp-do-queries
  • udp-queries
  • udp4-answers
  • udp4-queries
  • udp6-answers
  • udp6-queries
  • key-cache-size
  • latency
  • meta-cache-size
  • qsize-q
  • signature-cache-size
  • sys-msec
  • uptime
  • user-msec

Tags

• tags: server=socket

Example Output

powerdns,server=/var/run/pdns.controlsocket corrupt-packets=0i,deferred-cache-inserts=0i,deferred-cache-lookup=0i,dnsupdate-answers=0i,dnsupdate-changes=0i,dnsupdate-queries=0i,dnsupdate-refused=0i,key-cache-size=0i,latency=26i,meta-cache-size=0i,packetcache-hit=0i,packetcache-miss=1i,packetcache-size=0i,qsize-q=0i,query-cache-hit=0i,query-cache-miss=6i,rd-queries=1i,recursing-answers=0i,recursing-questions=0i,recursion-unanswered=0i,security-status=3i,servfail-packets=0i,signature-cache-size=0i,signatures=0i,sys-msec=4349i,tcp-answers=0i,tcp-queries=0i,timedout-packets=0i,udp-answers=1i,udp-answers-bytes=50i,udp-do-queries=0i,udp-queries=0i,udp4-answers=1i,udp4-queries=1i,udp6-answers=0i,udp6-queries=0i,uptime=166738i,user-msec=3036i 1454078624932715706

Documentation

Index

• type Powerdns
  • func (p *Powerdns) Gather(acc telegraf.Accumulator) error
  • func (*Powerdns) SampleConfig() string

Types

type Powerdns

type Powerdns struct {
	UnixSockets []string

	Log telegraf.Logger `toml:"-"`
}

func (*Powerdns) Gather

func (p *Powerdns) Gather(acc telegraf.Accumulator) error

func (*Powerdns) SampleConfig

func (*Powerdns) SampleConfig() string