Intégration monitoring PowerDNS

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cela s'applique uniquement aux versions à partir de la sortie 0.0.5 en octobre 2021.

Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.

Notre intégration PowerDNS collecte et envoie des métriques dimensionnelles à partir de PowerDNS. Vous pouvez afficher ces données métriques dans un dashboard prédéfini, créer une règle d'alerte et créer des requêtes et des graphiques personnalisés.

Lisez la suite pour installer l’intégration et voir quelles données nous collectons.

Compatibilité et exigences

Notre intégration est compatible avec PowerDNS Recursor et Authoritative Server.

Avant d’installer l’intégration, assurez-vous que vous répondez aux exigences suivantes :

Installez l'agent d'infrastructure, version minimale 1.19.2.
Distribution Linux compatible avec l'agent d'infrastructure.

Pour obtenir des données de infrastructure PowerDNS, notre intégration PowerDNS utilise un exportateurPrometheus tiers, qui expose les métriques Prometheus sur le port spécifié dans la configuration. L'intégration collecte ces métriques, les transforme en entité, les filtre, puis les envoie à New Relic.

Pour activer l'API, le serveur Web et l'API HTTP doivent être activés.

Ajoutez ces lignes au pdns.conf :

api=yes
api-key=changeme

Et redémarrez, les exemples suivants devraient commencer à fonctionner :

curl -v -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1/servers/localhost | jq .
curl -v -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1

Pour plus d'informations, Activation du serveur Web et de l'API

Installer et activer

Pour installer l'intégration PowerDNS, choisissez votre configuration :

Installez l'agent d'infrastructure et remplacez la variable INTEGRATION_FILE_NAME par nri-powerdns.
Changez le répertoire vers le dossier d'intégration :
```
cd /etc/newrelic-infra/integrations.d
```

Copie du fichier de configuration d'exemple :

sudo cp powerdns-config.yml.sample powerdns-config.yml

Modifiez le fichier powerdns-config.yml comme décrit dans les paramètres de configuration.

Ce document vous a-t-il aidé lors de votre installation ?

Configurer l'intégration

Pour configurer l'intégration, modifiez la configuration dans le fichier de configuration YAML de l'intégration powerdns-config.yml.

Utilisez la configuration YAML pour placer les informations de connexion requises et configurer la manière dont vos données sont collectées, en fonction de votre configuration et de vos préférences.

Étant donné que cette intégration est basée sur un exportateur Prometheus, les paramètres applicables à d'autres intégrations, comme interval, timeout ou inventory_source ne sont pas pris en charge.

Paramètres de l'instance PowerDNS

Les options de configuration suivantes sont disponibles :

Paramètre	Description	Défaut
powerdns_url	URL de l'API du service powerdns	N/A
exporter_port	Port sur lequel exposer le point de terminaison scrape, si celui-ci n'est pas fourni, un port aléatoire sera utilisé pour lancer l'exportateur	port aléatoire
scrape_timeout	Délai avant l'expiration d'une demande de scraping	5s
api_key	clé API utilisée pour se connecter au serveur PowerDNS	N/A

Exemple de configuration

Il s'agit de la configuration de base utilisée pour collecter des métriques à partir d'une instance faisant autorité et d'une instance récursive :

integrations:
  - name: nri-powerdns
    config:
      api_key: authoritative-secret
      exporter_port: 9121
      powerdns_url: http://localhost:8081/api/v1/
  - name: nri-powerdns
    config:
      api_key: recursor-secret
      exporter_port: 9122
      powerdns_url: http://localhost:8082/api/v1/

Rechercher et utiliser des données

Pour en savoir plus sur la recherche et l’utilisation de vos données, consultez Comprendre les données d’intégration.

Les métriques sont attachées aux types d'échantillons et d'événements métriques des entités POWERDNS_AUTHORITATIVE et POWERDNS_RECURSOR. Vous pouvez interroger ces données à des fins de dépannage ou pour créer des graphiques et des dashboards personnalisés.

données métriques

Deux entités sont créées : POWERDNS_AUTHORITATIVE et POWERDNS_RECURSOR.

Les métriques dimensionnelles suivantes sont capturées en scrapant l'exportateur et liées à l'entité POWERDNS_AUTHORITATIVE:

Nom	Description	Dimensions
`powerdns_authoritative_uptime (count)`	temps de disponibilité en secondes du daemon.	type
`powerdns_authoritative_packet_cache_size (gauge)`	Nombre d'entrées dans le cache de paquets.
`powerdns_authoritative_recursive_queries_total (count)`	Nombre total de requêtes récursives par statut.	statut
`powerdns_authoritative_remote_queries (count)`	Adresses IP des serveurs distants.	télécommande
`powerdns_authoritative_security_status (gauge)`	État de sécurité du serveur PDNS basé sur `security-status.secpoll.powerdns.com`.
`powerdns_authoritative_exceptions_total (count)`	Nombre total d'exceptions par erreur.	erreur
`powerdns_authoritative_latency_average_seconds (gauge)`	Nombre moyen de microsecondes qu'un paquet passe dans PowerDNS.
`powerdns_authoritative_dnsupdate_queries_total (count)`	Nombre total de requêtes de mise à jour DNS par statut.	statut
`powerdns_authoritative_qsize (gauge)`	Nombre de paquets en attente d'attention de la base de données.
`powerdns_authoritative_response_rcodes (count)`	Distribution des rcodes.	rcode
`powerdns_authoritative_signature_cache_size (gauge)`	Nombre d'entrées dans le cache de signatures.
`powerdns_authoritative_queries_unauth (count)`	requête pour un domaine pour lequel nous ne sommes pas compétents.	enregistrer
`powerdns_authoritative_answers_bytes_total (count)`	Nombre total d'octets de réponse envoyés par le protocole.	proto
`powerdns_authoritative_queries (count)`	Requête UDP reçue.	enregistrer
`powerdns_authoritative_exporter_json_parse_failures (count)`	Nombre d'erreurs lors de l'analyse des statistiques JSON PowerDNS.
`powerdns_authoritative_deferred_cache_actions (count)`	Actions de cache différées en raison de maintenance par type.	type
`powerdns_authoritative_up (gauge)`	Le dernier scraping de PowerDNS a réussi.
`powerdns_authoritative_query_cache_lookup (count)`	Recherches dans le cache de requêtes par résultat.	résultat
`powerdns_authoritative_key_cache_size (gauge)`	Nombre d'entrées dans le cache de clés.
`powerdns_authoritative_answers_total (count)`	Nombre total de réponses par protocole.	proto
`powerdns_authoritative_packet_cache_lookup (count)`	Recherches de cache de paquets par résultat.	résultat
`powerdns_authoritative_metadata_cache_size (gauge)`	Nombre d'entrées dans le cache de métadonnées.
`powerdns_authoritative_queries_total (count)`	Nombre total de requêtes par protocole.	proto
`powerdns_authoritative_cpu_utilisation (count)`	Nombre de millisecondes CPU passées dans l'espace utilisateur et dans l'espace noyau.	type
`powerdns_authoritative_dnssec (count)`	Compteurs DNSSEC.	type
`powerdns_authoritative_response_sizes (count)`	Répartition des tailles des réponses.	taille
`powerdns_authoritative_exporter_total_scrapes (count)`	Nombre total actuel de scrapings PowerDNS.
`powerdns_authoritative_remote_queries_unauth (count)`	Hôtes distants interrogeant un domaine pour lequel nous ne faisons pas autorité.	télécommande

Les métriques dimensionnelles suivantes sont capturées en scrapant l'exportateur et liées à l'entité POWERDNS_RECURSOR:

Nom	Description	Dimensions
`powerdns_recursor_incoming_queries_total (count)`	Nombre total de requêtes entrantes par réseau.	net
`powerdns_recursor_outgoing_queries_total (count)`	Nombre total de requêtes sortantes par réseau.	net
`powerdns_recursor_cache_size (gauge)`	Nombre d'entrées dans le cache.
`powerdns_recursor_cache_lookups_total (count)`	Nombre total de recherches de cache par résultat.	résultat
`powerdns_recursor_exporter_json_parse_failures (count)`	Nombre d'erreurs lors de l'analyse des statistiques JSON PowerDNS.
`powerdns_recursor_answers_rcodes_total (count)`	Nombre total de réponses par code de réponse.	rcode
`powerdns_recursor_exporter_total_scrapes (count)`	Nombre total actuel de scrapings PowerDNS.
`powerdns_recursor_concurrent_queries (gauge)`	Nombre de requêtes concurrentes.
`powerdns_recursor_answers_rtime_total (count)`	Nombre total de réponses regroupées par tranches de temps de réponse.	plage horaire
`powerdns_recursor_latency_average_seconds (gauge)`	Moyenne mobile exponentielle du temps de latence entre la question et la réponse.
`powerdns_recursor_exceptions_total (count)`	Nombre total d'exceptions par erreur.	erreur
`powerdns_recursor_response_time_seconds_sum (count)`	histogramme du temps de réponse du récurseur PowerDNS en secondes. (somme métrique)
`powerdns_recursor_response_time_seconds_bucket (count)`	histogramme du temps de réponse du récurseur PowerDNS en secondes. (métrique du godet)	le
`powerdns_recursor_up (gauge)`	Le dernier scraping de PowerDNS a réussi.

Vérifiez le code source

Cette intégration est un logiciel open source. Cela signifie que vous pouvez parcourir son code source et envoyer des améliorations, ou créer votre propre fork et le construire.

De plus, cette intégration s'appuie sur un exportateur open source créé par la communauté.

Cette traduction automatique est fournie pour votre commodité.

Aperçu

Compatibilité et exigences

Installer et activer

Installation de Linux

Installation de tarball (avancé)

Ce document vous a-t-il aidé lors de votre installation ?

Configurer l'intégration

Paramètres de l'instance PowerDNS

Exemple de configuration

Configuration de base

Rechercher et utiliser des données

données métriques

Vérifiez le code source

Cette traduction automatique est fournie pour votre commodité.

Intégration monitoring PowerDNS

Aperçu

Compatibilité et exigences .css-21sua1{background:none;border:none;width:0;padding:0;}

Installer et activer

Installation de tarball (avancé)

Ce document vous a-t-il aidé lors de votre installation ?

Configurer l'intégration

Paramètres de l'instance PowerDNS

Exemple de configuration

Configuration de base

Rechercher et utiliser des données

données métriques

Vérifiez le code source

Compatibilité et exigences