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 read 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

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

$ ./telegraf --config telegraf.conf --input-filter powerdns --test
> 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