Dépannage de la surveillance Synthetic

Dépannage de la surveillance Synthetic

Si vous rencontrez un problème durant la configuration de la surveillance Synthetic Datadog, utilisez cette page pour effectuer un premier dépannage. Si votre problème persiste, contactez l’équipe d’assistance Datadog.

Tests Browser

Enregistrement

Mon site Web ne se charge pas dans l’iframe et je ne peux enregistrer aucune étape, même lorsque j’ouvre mon site Web dans une fenêtre contextuelle.

Après avoir téléchargé l'extension Datadog, vous ne pouvez pas afficher votre site Web dans l’iframe sur la droite de l’enregistreur de votre test Browser. En outre, vous ne pouvez enregistrer aucune étape, que vous ayez ouvert votre site Web dans l’iframe ou dans une fenêtre contextuelle :

Si c’est le cas, assurez-vous que l'extension Datadog dispose des autorisations de lecture et d’écriture sur les données pour les sites Web souhaités, en spécifiant votre site Web dans la section On specific sites ou en activant le bouton On all sites :

Je ne vois pas la page de connexion dans l’outil d’enregistrement. Que se passe-t-il ?

Par défaut, l’iframe/la fenêtre de l’outil d’enregistrement utilise votre propre navigateur. Cela signifie que si vous êtes déjà connecté à votre application, il est possible que l’iframe/la fenêtre affiche directement la page qui suit l’écran de connexion, vous empêchant alors d’enregistrer vos étapes de connexion sans vous déconnecter au préalable.

Pour enregistrer vos étapes de connexion sans vous déconnecter de votre application, utilisez simplement le mode navigation privée de l’outil d’enregistrement :

L’option Open pop up in Incognito mode vous permet de démarrer l’enregistrement de votre test depuis l’URL de départ configurée et dans une session entièrement distincte de la session principale de votre navigateur.

La fenêtre de navigation privée qui s’ouvre alors ignore toutes vos anciennes données de navigation (cookies, données locales, etc.). Ainsi, vous êtes automatiquement déconnecté de votre compte et pouvez enregistrer vos étapes de connexion comme si vous consultiez votre site pour la première fois.

Résultats de test

Mon test Browser Mobile Small ou Tablet échoue systématiquement

Si votre site Web a recours à des techniques réactives, son DOM peut afficher d’importantes différences en fonction de l’appareil sur lequel le test est exécuté. Il est possible que votre site utilise un DOM spécifique lorsqu’il est exécuté à partir d’un Laptop Large, et que son architecture diffère grandement lorsqu’il est exécuté depuis un appareil Tablet ou Mobile Small. En d’autres termes, il se peut que les étapes que vous avez enregistrées depuis une fenêtre d’affichage Laptop Large ne s’appliquent pas à un appareil Mobile Small pour le même site Web. Cela entraînerait l’échec des résultats de votre test Mobile Small :

Pour y remédier, nous vous recommandons de créer des tests spécifiques au format Small ou Tablet. Leurs étapes enregistrées correspondront alors à la fenêtre d’affichage du test lors de l’exécution. Afin d’enregistrer ces étapes avec une fenêtre d’affichage Mobile Small ou Tablet, sélectionnez Mobile Small ou Tablet dans le menu déroulant de l’enregistreur avant de cliquer sur le bouton Start Recording.

En outre, les tests Browser sont exécutés en mode headless, ce qui signifie que certaines fonctionnalités ne sont pas prise en charge. Par exemple, les tests Browser ne prennent pas en charge l’action touch et ne peuvent l’utiliser pour détecter si le site Web doit s’afficher dans sa version mobile ou non.

Mon test Browser affiche un avertissement None or multiple elements detected

L’une des étapes de votre test Browser affiche un avertissement None or multiple elements detected :

Cela signifie que le localisateur d’utilisateur défini pour cette étape cible soit plusieurs éléments, soit aucun d’entre eux. Le test Browser ne sait donc pas avec quel élément interagir. Pour résoudre ce problème, accédez à l’éditeur de votre enregistrement et ouvrez les options avancées de l’étape problématique. Accédez à la page en cours de test, puis cliquez sur Test. Cela met en surbrillance l’élément localisé ou affiche un message d’erreur. Vous pouvez désormais modifier votre localisateur d’utilisateur de façon à ce qu’il ne renvoie plus qu’un seul élément de votre page :

Tests API et tests Browser

Erreurs Unauthorized

Si l’un de vos tests Synthetic renvoie une erreur 401, c’est probablement qu’il ne parvient pas à s’authentifier auprès de l’endpoint. Lorsque vous configurez votre test Synthetic, assurez-vous d’utiliser la même méthode d’authentification que celle que vous utilisez en dehors de Datadog.

  • Votre endpoint utilise-t-il une authentification par en-têtes ?

    • Authentification basique : spécifiez les identifiants requis dans les options avancées de votre test HTTP ou Browser.
    • Authentification basée sur un token : commencez par extraire votre token avec un premier test HTTP, créez une variable globale en parsant la réponse de ce premier test, et réinjectez cette variable dans un second test HTTP ou test Browser nécessitant le token d’authentification.
    • Authentification basée sur une session : ajoutez les en-têtes ou cookies requis dans les options avancées de votre test HTTP ou Browser.
  • L’endpoint utilise-t-il les paramètres de requête pour l’authentification ? (Avez-vous besoin d’ajouter une clé d’API spécifique dans vos paramètres d’URL ?)

  • Cet endpoint utilise-t-il une authentification basée sur l’adresse IP ? Dans ce cas, vous devrez peut-être autoriser une partie ou l’ensemble des IP à l’origine des tests Synthetic.

Erreurs Forbidden

Si les tests Synthetic renvoient des erreurs 403 Forbidden, il est possible que votre serveur Web bloque ou filtre les requêtes qui comprennent l’en-tête Sec-Datadog. Cet en-tête est ajouté à chaque requête Synthetic envoyée par Datadog pour identifier la source du trafic et aider l’assistance Datadog à identifier l’exécution de test spécifique.

En outre, vous devrez peut-être également vérifier que vos pare-feu autorisent les plages d’IP utilisées par la surveillance Synthetic Datadog comme sources de trafic.

Notifications manquantes

Par défaut, les tests Synthetic ne procèdent à aucun renvoi de notifications. Ainsi, si vous ajoutez votre handle de notification (adresse e-mail, handle Slack, etc.) après un changement d’état (par exemple, un test entrant en alerte ou se rétablissant à partir d’une ancienne alerte), aucune notification ne sera envoyée pour ce changement. Une notification sera toutefois envoyée pour le changement suivant.

Pour aller plus loin