Tests DNS

Présentation

Les tests DNS vous permettent de surveiller de façon proactive les délais de résolution et de correspondance de vos enregistrements DNS à l’aide d’un serveur de noms. Si la résolution est étonnamment lente ou si le serveur DNS transmet des entrées A, AAAA, CNAME, TXT ou MX inattendues, Datadog vous envoie une alerte détaillée de l’erreur afin de vous permettre d’identifier rapidement la cause du problème et de résoudre ce dernier. Les tests DNS peuvent être exécutés depuis des emplacements gérés et des emplacements privés, ce qui vous permet d’exécuter des tests sur des domaines publics et des services internes qui peuvent utiliser un serveur DNS interne.

Configuration

Après avoir sélectionné le type de test que vous souhaitez créer (HTTP, SSL, TCP ou DNS), vous pouvez définir votre requête de test.

Définir la requête

Indiquez dans le champ Domain le domaine pour lequel vous souhaitez interroger dans le cadre de votre test. Exemple : www.example.com.
Indiquez dans le champ DNS Server le serveur DNS à utiliser (facultatif) : il peut s’agir d’un nom de domaine ou d’une adresse IP. Si aucune valeur n’est indiquée, votre test DNS effectue la résolution en utilisant 8.8.8.8, avec ma valeur alternative 1.1.1.1 et le serveur DNS AWS interne.
Donnez un nom à votre test DNS.
Ajoutez des tags env et tout autre tag de votre choix à votre test DNS. Vous pourrez ensuite utiliser ces tags pour filtrer rapidement vos tests Synthetic depuis la page d’accueil de la surveillance Synthetic.
Sélectionnez les emplacements à partir desquels vous souhaitez exécuter votre test DNS. Les tests DNS peuvent être exécutés depuis des emplacements gérés et des emplacements privés, selon que vous souhaitez surveiller un domaine privé ou public.

Cliquez sur Test URL pour essayer la configuration de requête. Un aperçu de la réponse s’affiche sur le côté droit de votre écran.

Indiquer la fréquence du test

Les tests DNS peuvent être exécutés :

Selon un programme, pour vous assurer que vos utilisateurs peuvent toujours accéder à vos principaux services. Sélectionnez la fréquence à laquelle vous souhaitez que Datadog exécute votre test DNS.

Exécuter des tests API selon un programme

Dans vos pipelines de CI/CD.
À la demande, afin d’exécuter les tests au moment le plus opportun pour vos équipes.

Définir des assertions

Les assertions définissent un résultat de test escompté. Lorsque vous cliquez sur Test URL, les assertions de base pour response time et les enregistrements disponibles sont ajoutés. Vous devez définir au moins une assertion à surveiller pour votre test.

Type	Type d’enregistrement	Opérateur	Type de valeur
response time		`is less than`	Nombre entier (ms)
every record	Tous les enregistrements de type A, AAAA, MX, TXT ou CNAME	`is`, `contains`, `matches`, `does not match`	Chaîne Regex
at least one record	Au moins un enregistrement de type A, AAAA, MX, TXT ou CNAME	`is`, `contains`, `matches`, `does not match`	Chaîne Regex

Vous pouvez créer jusqu’à 10 assertions par test API en cliquant sur New assertion ou directement sur l’aperçu de la réponse :

Définir les assertions pour votre test DNS

Définir des conditions d’alerte

Définissez des conditions d’alerte afin de spécifier les circonstances dans lesquelles vous souhaitez qu’un test échoue et déclenche une alerte.

Règle d’alerte

Lorsque vous définissez les conditions d’alerte sur An alert is triggered if any assertion fails for X minutes from any n of N locations, une alerte se déclenche uniquement si les deux conditions suivantes se vérifient :

Au moins un emplacement a donné lieu à un échec (au moins une assertion a échoué) au cours des X dernières minutes
À un moment au cours des X dernières minutes, au moins n emplacements ont donné lieu à un échec

Nouvelle tentative rapide

Votre test peut déclencher de nouvelles tentatives en cas d’échec. Par défaut, les tentatives sont effectuées 300 ms après le premier échec. Cet intervalle peut être configuré via l'API.

La disponibilité d’un emplacement est calculée pour chaque évaluation (quels que soient les résultats du dernier test avant l’évaluation). La disponibilité totale est calculée selon les conditions d’alerte configurées. Les notifications envoyées se basent sur la disponibilité totale.

Informer votre équipe

Votre test envoie une notification selon les conditions d’alerte définies au préalable. Référez-vous à cette section pour définir les conditions et le message à envoyer à vos équipes.

Tout comme pour les monitors, sélectionnez les utilisateurs et/ou services qui doivent recevoir des notifications. Pour ce faire, ajoutez @notification au message, ou cherchez des membres d’équipe ou des intégrations connectées à l’aide de la liste déroulante.

Saisissez un message de notification pour le test. Ce champ accepte le format de mise en forme Markdown standard ainsi que les variables conditionnelles suivantes :

Variable conditionnelle	Description
`{{#is_alert}}`	S’affiche lorsque le test envoie une alerte.
`{{^is_alert}}`	S’affiche lorsque le test n’envoie pas d’alerte.
`{{#is_recovery}}`	S’affiche lorsque le test est rétabli depuis un état d’alerte.
`{{^is_recovery}}`	S’affiche lorsque le test n’est pas rétabli depuis un état d’alerte.

Indiquez une fréquence de renvoi du message de notification en cas d’échec d’un test. Si vous ne souhaitez pas renvoyer de notification en cas d’échec, définissez l’option sur Never renotify if the monitor has not been resolved.

Les notifications par e-mail incluent le message défini dans cette section ainsi qu’un résumé des assertions qui ont échoué. Exemples de notification :

Cliquez sur Save pour enregistrer votre test. Datadog se charge alors de son exécution.

Variables

Créer des variables locales

Vous pouvez créer des variables locales en définissant leurs valeurs sur l’un des builtins disponibles ci-dessous :

Pattern	Description
`{{ numeric(n) }}`	Génère une chaîne numérique de `n` chiffres.
`{{ alphabetic(n) }}`	Génère une chaîne alphabétique de `n` lettres.
`{{ alphanumeric(n) }}`	Génère une chaîne alphanumérique de `n` caractères.
`{{ date(n, format) }}`	Génère une date dans l’un des formats acceptés. Sa valeur correspond à la date d’initiation du test + `n` jours.
`{{ timestamp(n, unit) }}`	Génère un timestamp dans l’une des unités acceptées. Sa valeur correspond au timestamp d’initiation du test +/- `n` unités choisies.

Utiliser des variables

Les variables globales définies sur la page Settings et les variables définies localement peuvent être utilisées dans l’URL, les options avancées et les assertions de vos tests DNS. Pour afficher la liste de vos variables, saisissez {{ dans le champ souhaité :

Échec de test

Un test est considéré comme FAILED s’il ne répond pas à une ou plusieurs de ses assertions ou si la requête a échoué prématurément. Dans certains cas, le test peut en effet échouer sans que les assertions n’aient pu être comparées à l’endpoint. Voici la liste des erreurs concernées :

Erreur	Description
`CONNRESET`	La connexion a été interrompue de façon soudaine par le serveur à distance. Causes possibles : erreur ou défaillance du serveur Web lors de la réponse ou perte de connectivité du serveur Web.
DNS	L’entrée DNS est introuvable pour l’URL du test. Causes possibles : URL du test mal configurée, configuration des entrées DNS incorrecte, etc.
`INVALID_REQUEST`	La configuration du test n’est pas valide (par exemple, en raison d’une faute de frappe dans l’URL).
`TIMEOUT`	La requête n’a pas pu être effectuée dans un délai raisonnable. Deux types d’erreur `TIMEOUT` peuvent se produire. - Une erreur `TIMEOUT: The request couldn’t be completed in a reasonable time.` indique que la requête a expiré lors de la connexion au socket TCP. - Une erreur `TIMEOUT: Retrieving the response couldn’t be completed in a reasonable time.` indique que la requête a expiré lors de son traitement global (qui comprend la connexion au socket TCP, le transfert de données et les assertions).