ns1

ns1

Agent Check Check de l'Agent

Supported OS Linux Mac OS Windows

Présentation

Ce check permet de surveiller ns1 avec l’Agent Datadog.

Snap

Configuration

Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions à un environnement conteneurisé.

Installation

Consultez le guide relatif à l'installation d’intégrations développées par la communauté :

  1. Téléchargez et lancez l’Agent Datadog.

  2. Exécutez la commande suivante pour installer le wheel de l’intégration à l’aide de l’Agent :

    datadog-agent integration install -t datadog-ns1==0.0.2
    
  3. Configurez votre intégration comme n’importe quelle autre intégration du paquet.

Configuration

  1. Modifiez le fichier ns1.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance ns1. Consultez le fichier d’exemple ns1.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

  2. Redémarrez l’Agent.

Pour obtenir une description détaillée de toutes les données de performance, consultez l’article sur l'intégration NS1 + Datadog dans le centre d’aide NS1.

Validation

Lancez la sous-commande status de l’Agent et cherchez ns1 dans la section Checks.

Données collectées

Métriques

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

Checks de service

ns1 n’inclut aucun check de service.

Événements

ns1 n’inclut aucun événement.

Développement

Consultez la documentation de Datadog dédiée aux développeurs pour découvrir comment tester et développer des intégrations reposant sur l’Agent.

Pour installer le check ns1 sur votre host :

  1. Installez le kit de développement sur n’importe quelle machine.

  2. Exécutez ddev release build ns1 pour générer le package.

  3. Téléchargez l’Agent Datadog.

  4. Importez l’artefact du build sur tous les hosts avec un Agent et exécutez datadog-agent integration install -w chemin/vers/référentiel/ns1/<NOM_ARTEFACT>.whl.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.