---
title: ns1
description: A Datadog integration to collect NS1 metrics
breadcrumbs: Docs > Integrations > ns1
---

# ns1
Supported OS Integration version1.0.1
## Overview{% #overview %}

This integration monitors [NS1](https://ns1.com/) services through the Datadog Agent



## Setup{% #setup %}

The NS1 check is not included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest?platform=overview) package, so you need to install it.

### Installation{% #installation %}

For Agent v7.21+ / v6.21+, follow the instructions below to install the NS1 check on your host. See [Use Community Integrations](https://docs.datadoghq.com/agent/guide/community-integrations-installation-with-docker-agent/?tab=agentabovev68) to install with the Docker Agent or earlier versions of the Agent.

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

   ```shell
   datadog-agent integration install -t datadog-ns1==1.0.1
   ```

1. Configure your integration similar to core [integrations](https://docs.datadoghq.com/getting_started/integrations/).

### Configuration{% #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](https://github.com/DataDog/integrations-extras/blob/master/ns1/datadog_checks/ns1/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands/#agent-status-and-information).

### Validation{% #validation %}

Run the [Agent's status subcommand](https://docs.datadoghq.com/getting_started/integrations/) and look for `ns1` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #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.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{% #events %}

The NS1 integration does not include any events.

### Service Checks{% #service-checks %}

**ns1.can\_connect**

Returns `OK` If NS1 API endpoints respond ok. Returns `CRITICAL` If API call Errors occurs.

*Statuses: ok, critical*

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).

## Further Reading{% #further-reading %}

- [Monitor NS1 with Datadog](https://www.datadoghq.com/blog/ns1-monitoring-datadog/)