Plugin: go.d.plugin Module: powerdns_recursor
This collector monitors PowerDNS Recursor instances.
It collects metrics from the internal webserver.
Used endpoints:
This collector is supported on all platforms.
This collector supports collecting metrics from multiple instances of this integration, including remote instances.
This integration doesn’t support auto-detection.
The default configuration for this integration does not impose any limits on data collection.
The default configuration for this integration is not expected to impose a significant performance impact on the system.
Follow webserver documentation.
Follow HTTP API documentation.
The configuration file name for this integration is go.d/powerdns_recursor.conf
.
You can edit the configuration file using the edit-config
script from the
Netdata config directory.
cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config go.d/powerdns_recursor.conf
The following options can be defined globally: update_every, autodetection_retry.
Name | Description | Default | Required |
---|---|---|---|
update_every | Data collection frequency. | 5 | False |
autodetection_retry | Recheck interval in seconds. Zero means no recheck will be scheduled. | 0 | False |
url | Server URL. | http://127.0.0.1:8081 | True |
timeout | HTTP request timeout. | 1 | False |
username | Username for basic HTTP authentication. | False | |
password | Password for basic HTTP authentication. | False | |
proxy_url | Proxy URL. | False | |
proxy_username | Username for proxy basic HTTP authentication. | False | |
proxy_password | Password for proxy basic HTTP authentication. | False | |
method | HTTP request method. | GET | False |
body | HTTP request body. | False | |
headers | HTTP request headers. | False | |
not_follow_redirects | Redirect handling policy. Controls whether the client follows redirects. | False | False |
tls_skip_verify | Server certificate chain and hostname validation policy. Controls whether the client performs this check. | False | False |
tls_ca | Certification authority that the client uses when verifying the server’s certificates. | False | |
tls_cert | Client TLS certificate. | False | |
tls_key | Client TLS key. | False |
An example configuration.
jobs:
- name: local
url: http://127.0.0.1:8081
Basic HTTP authentication.
jobs:
- name: local
url: http://127.0.0.1:8081
username: admin
password: password
Note: When you define multiple jobs, their names must be unique.
Local and remote instances.
jobs:
- name: local
url: http://127.0.0.1:8081
- name: remote
url: http://203.0.113.0:8081
Metrics grouped by scope.
The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.
These metrics refer to the entire monitored application.
This scope has no labels.
Metrics:
Metric | Dimensions | Unit |
---|---|---|
powerdns_recursor.questions_in | total, tcp, ipv6 | questions/s |
powerdns_recursor.questions_out | udp, tcp, ipv6, throttled | questions/s |
powerdns_recursor.answer_time | 0-1ms, 1-10ms, 10-100ms, 100-1000ms, slow | queries/s |
powerdns_recursor.timeouts | total, ipv4, ipv6 | timeouts/s |
powerdns_recursor.drops | over-capacity-drops, query-pipe-full-drops, too-old-drops, truncated-drops, empty-queries | drops/s |
powerdns_recursor.cache_usage | cache-hits, cache-misses, packet-cache-hits, packet-cache-misses | events/s |
powerdns_recursor.cache_size | cache, packet-cache, negative-cache | entries |
There are no alerts configured by default for this integration.
To troubleshoot issues with the powerdns_recursor
collector, run the go.d.plugin
with the debug option enabled. The output
should give you clues as to why the collector isn’t working.
Navigate to the plugins.d
directory, usually at /usr/libexec/netdata/plugins.d/
. If that’s not the case on
your system, open netdata.conf
and look for the plugins
setting under [directories]
.
cd /usr/libexec/netdata/plugins.d/
Switch to the netdata
user.
sudo -u netdata -s
Run the go.d.plugin
to debug the collector:
./go.d.plugin -d -m powerdns_recursor