Stackstate-PowerDNS Integration

Overview

Connect your PowerDNS Recursor to Stackstate to:

  • Visualize its performance
  • Understand query latency
  • Get alerted when something fails or when you’re under attack

Configuration

Configure the Agent to connect to the PowerDNS Recursor. Edit conf.d/powerdns_recursor.yaml

init_config:

instances:
  - host: 127.0.0.1
    port: 8082
    api_key: pdns_api_key

For more details about configuring this integration refer to the following file(s) on GitHub:

Validation

  1. Restart the Agent
  2. Execute the info command and verify that the integration check has passed. The output of the command should contain a section similar to the following:

    Checks
    ======
    
      [...]
    
      powerdns_recursor
      -----------------
          - instance #0 [OK]
          - Collected 8 metrics & 0 events
    

Metrics

powerdns.recursor.cache_entries
(gauge)
The number of entries in the cache
shown as unit
powerdns.recursor.concurrent_queries
(gauge)
The number of MThreads currently running
shown as unit
powerdns.recursor.all_outqueries
(gauge)
The number of outgoing udp queries per second
shown as operation/second
powerdns.recursor.answers_slow
(gauge)
Number of queries answered after 1 second
shown as unit/second
powerdns.recursor.answers0_1
(gauge)
Number of queries answered after 1 second
shown as unit/second
powerdns.recursor.answers1_10
(gauge)
Number of queries answered within 10 milliseconds
shown as unit/second
powerdns.recursor.answers10_100
(gauge)
Number of queries answered within 100 milliseconds
shown as unit/second
powerdns.recursor.answers100_1000
(gauge)
Number of queries answered within 1 second
shown as unit/second
powerdns.recursor.cache_hits
(gauge)
The number of cache hits per second
shown as operation/second
powerdns.recursor.cache_misses
(gauge)
The number of cache misses per second
shown as operation/second
powerdns.recursor.noerror_answers
(gauge)
The number of times it answered NOERROR per second
shown as operation/second
powerdns.recursor.outgoing_timeouts
(gauge)
The number of timeouts per second
shown as operation/second
powerdns.recursor.questions
(gauge)
The number of user initiated udp queries per second
shown as operation/second
powerdns.recursor.servfail_answers
(gauge)
The number of times it answered SERVFAIL per second
shown as operation/second
powerdns.recursor.tcp_outqueries
(gauge)
The number of outgoing tcp queries per second
shown as operation/second
powerdns.recursor.tcp_questions
(gauge)
The number of incoming tcp queries per second
shown as operation/second