Supported OS
This integration monitors NS1 services through the Datadog Agent
The NS1 check is not included in the Datadog Agent package, so you need to install it.
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.
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.
Run the Agent’s status subcommand and look for ns1 under the Checks section.
| 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 |
The NS1 integration does not include any events.
ns1.can_connect
Returns OK If NS1 API endpoints respond ok. Returns CRITICAL If API call Errors occurs.
Statuses: ok, critical
Need help? Contact Datadog support.
Additional helpful documentation, links, and articles: