ns1

ns1

Agent Check Agent Check

Supported OS Linux Mac OS Windows

Integrationv0.0.4

Overview

This integration monitors NS1 services through the Datadog Agent

Snap

Setup

Download and install the Datadog Agent, then follow the instructions below to install and configure this integration for an Agent running on a host.

Installation

Refer to Datadog’s community integrations installation page for the specific steps to install the NS1 integration as an add-on, since it is not packaged and built into the Datadog Agent.

Note: The minimum Agent version required for supporting integrations is 7.21.0. NS1 recommends using the latest version of the Datadog Agent.

When running the installation process, make sure to do so using the following variables specific to the NS1 integration:

  • <INTEGRATION_NAME>: ns1
  • <INTEGRATION_VERSION>: 0.0.4

Configuration

To configure and activate the NS1 integration, see the Getting started with Integrations information on configuring Agent integrations.

See the sample ns1.d/conf.yaml for all available configuration options.

Validation

To validate your Agent and integration configuration, 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.insuficient
(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.

For more details about this integration, see the NS1 + Datadog Integration article in the NS1 Help Center.