ns1

Supported OS Linux Windows

Integrationv0.0.6

Overview

This integration monitors NS1 services through the Datadog Agent

Snap

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.

  1. Run the following command to install the Agent integration:

    datadog-agent integration install -t datadog-ns1==<INTEGRATION_VERSION>
    
  2. Configure your integration similar to core integrations.

Configuration

  1. 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.

  2. 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: