Overview
This integration monitors NS1
services through the Datadog Agent
Setup
The NS1 check is not included in the Datadog Agent
package, so you need to install it.
Installation
For Agent v7.21+ / v6.21+, follow the instructions below to install the NS1 check on your host. See Use Community Integrations
to install with the Docker Agent or earlier versions of the Agent.
Run the following command to install the Agent integration:
datadog-agent integration install -t datadog-ns1==<INTEGRATION_VERSION>
Configure your integration similar to core integrations
.
Configuration
Edit the ns1.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting NS1 metrics. See the sample ns1.d/conf.yaml
for all available configuration options.
Restart the Agent
.
Validation
Run the Agent’s status subcommand
and look for ns1 under the Checks section.
Data Collected
Metrics
ns1.qps
(gauge) | Queries per second account wide
Shown as query |
ns1.qps.zone
(gauge) | Queries per second for zone
Shown as query |
ns1.qps.record
(gauge) | Queries per second for DNS record
Shown as query |
ns1.usage
(count) | Number of queries account wide
Shown as query |
ns1.usage.zone
(count) | Number of queries for zone
Shown as query |
ns1.usage.record
(count) | Number of queries for DNS record
Shown as query |
ns1.billing
(count) | Number of queries in current billing period and query imit
Shown as query |
ns1.leases
(count) | Number of DHCP leases |
ns1.peak_lps
(gauge) | Peak LPS (leases/sec) in given period |
ns1.ttl
(gauge) | TTL (time to live) for each DNS record |
ns1.pulsar.decisions
(count) | Pulsar decisions count
Shown as query |
ns1.pulsar.decisions.insufficient
(count) | Pulsar undetermined decisions count
Shown as query |
ns1.pulsar.decisions.record
(count) | Pulsar decisions for record
Shown as query |
ns1.pulsar.performance
(gauge) | Pulsar response time
Shown as time |
ns1.pulsar.availability
(gauge) | Pulsar availability percentage
Shown as percent |
ns1.pulsar.routemap.hit
(count) | Count of hits for route
Shown as query |
ns1.pulsar.routemap.miss
(count) | Count of misses for route
Shown as query |
ns1.pulsar.routemap.hit.record
(count) | Count of route hits for record
Shown as query |
ns1.pulsar.routemap.miss.record
(count) | Count of route misses for record
Shown as query |
Events
The NS1 integration does not include any events.
Service Checks
ns1.can_connect
Returns OK If NS1 API endpoints respond ok. Returns CRITICAL If API call Errors occurs.
Statuses: ok, critical
Troubleshooting
Need help? Contact Datadog support
.
Further Reading
Additional helpful documentation, links, and articles:
