Aperçu

Les tests de navigateur sont des scénarios exécutés par Datadog sur vos applications web. Ils s’exécutent à des intervalles périodiques configurables depuis plusieurs emplacements dans le monde, à partir de plusieurs navigateurs et appareils. Ces tests vérifient à la fois que vos applications sont opérationnelles et répondent aux demandes, et que toutes les conditions définies dans vos scénarios sont remplies.

Configuration du test

Vous pouvez créer un test en utilisant l’une des options suivantes :

Créer un test à partir d’un modèle

1. Survolez l’un des modèles pré-remplis et cliquez sur Voir le modèle. Cela ouvre un panneau latéral affichant des informations de configuration pré-remplies, y compris : Détails du test, Conditions d’alerte, Étapes et éventuellement Variables.
2. Cliquez sur +Créer un test pour ouvrir la page de configuration, où vous pouvez examiner et modifier les options de configuration pré-remplies. Les champs présentés sont identiques à ceux disponibles lors de la création d’un test à partir de zéro.
3. Cliquez sur Enregistrer et quitter dans le coin supérieur droit pour soumettre votre test de navigateur.
   
   

Créez un test à partir de zéro

1. Cliquez sur le + modèle pour commencer un nouveau test de navigateur à partir de zéro.
2. Entrez une URL de départ : L’URL à partir de laquelle votre test de navigateur commence le scénario.
3. Ajoutez un nom : Le nom de votre test de navigateur.
4. Sélectionnez l’environnement et les balises supplémentaires : Définissez les env et les balises associées à votre test de navigateur. Utilisez le format <KEY>:<VALUE> pour filtrer sur un <VALUE> pour un <KEY> donné.

5. Sélectionnez navigateurs et appareils : Les navigateurs (comme Chrome, Firefox et Edge), et les appareils (comme Laptop Large, Tablet et Mobile Small) sur lesquels exécuter votre test.

   • Pour un grand ordinateur portable, les dimensions sont de 1440 pixels x 1100 pixels.
   • Pour une tablette, les dimensions sont de 768 pixels x 1020 pixels.
   • Pour un petit appareil mobile, les dimensions sont de 320 pixels x 550 pixels.

6. Sélectionnez emplacements gérés et privés : Sélectionnez parmi une liste d’emplacements dans le monde qui sont gérés par Datadog, ou créez des emplacements privés pour exécuter votre test de navigateur depuis des emplacements personnalisés ou à l’intérieur de réseaux privés.

   Note : Vous pouvez également utiliser le Continuous Testing Tunnel pour déclencher des tests sur votre configuration de développement local ou dans votre pipeline CI/CD pour tester des environnements internes.

7. Définissez la fréquence de test : Les intervalles varient de toutes les cinq minutes à une fois par semaine. Pour demander une fréquence d’une minute, contactez le support.

8. Cliquez sur Enregistrer et modifier l’enregistrement pour soumettre votre test de navigateur.

Emplacements

Datadog’s out-of-the-box managed locations allow you to test public-facing websites and endpoints from regions where your customers are located.

AWS:

GCP:

Azure:

The Datadog for Government site (US1-FED) uses the following managed location:

Extraits

Lors de la configuration d’un nouveau test de navigateur Synthetic Monitoring, utilisez des extraits pour remplir automatiquement vos appareils et régions, plutôt que de sélectionner ces options manuellement. Les extraits suivants sont disponibles :

• Tailles d’écran : Effectuez automatiquement vos tests de navigateur sur un écran de taille spécifiée sur différents navigateurs :

  • Grand
  • Tablette
  • Mobile

• Vérification multi-région : Testez automatiquement votre site web contre un emplacement dans chacune des trois principales régions géographiques (AMER, APAC et EMEA).
  
  

Options avancées

Create local variables

To create a local variable, click + All steps > Variables. You can select one of the following available builtins to add to your variable string:

{{ numeric(n) }}

Generates a numeric string with n digits.

{{ alphabetic(n) }}

Generates an alphabetic string with n letters.

{{ alphanumeric(n) }}

Generates an alphanumeric string with n characters.

{{ date(n unit, format) }}

Generates a date in one of Datadog’s accepted formats with a value corresponding to the UTC date the test is initiated at + or - n units.

{{ timestamp(n, unit) }}

Generates a timestamp in one of Datadog’s accepted units with a value corresponding to the UTC timestamp the test is initiated at +/- n units.

{{ uuid }}

Generates a version 4 universally unique identifier (UUID).

{{ public-id }}

Injects the Public ID of your test.

{{ result-id }}

Injects the Result ID of your test run.

To obfuscate local variable values in test results, select Hide and obfuscate variable value. Once you have defined the variable string, click Add Variable.

Utiliser des variables globales

Vous pouvez utiliser les variables globales définies dans Paramètres dans l’URL de départ et Options avancées des détails de votre test de navigateur, ainsi que dans votre enregistrement de test.

Pour afficher la liste des variables disponibles, procédez comme suit :

• Dans les détails de votre test de navigateur : Tapez {{ dans le champ souhaité.

• Dans l’enregistreur de votre test de navigateur : Importez la variable dans votre test, puis tapez {{ dans le champ souhaité ou injectez la variable dans votre application pour l’utiliser.

Pour plus d’informations sur l’utilisation des variables dans l’enregistrement de votre test de navigateur, consultez Étapes du test de navigateur.

Définir des conditions d’alerte

Vous pouvez personnaliser des conditions d’alertes afin de définir les circonstances dans lesquelles vous souhaitez qu’un test envoie une notification.

Règle d’alerte

Une alerte est déclenchée si une assertion échoue pendant X minutes à partir de n’importe quel n des N emplacements. Cette règle d’alerte vous permet de spécifier combien de temps et dans combien d’emplacements un test doit échouer avant de déclencher la notification.

Une alerte est déclenchée uniquement si ces deux conditions sont vraies :

• Au moins un emplacement était en échec (au moins une assertion a échoué) pendant les dernières X minutes ;
• À un moment donné pendant les dernières X minutes, au moins N emplacements étaient en échec.

En cas d’échec, réessayez X fois avant que l’emplacement ne soit considéré comme ayant échoué. Cela vous permet de définir le nombre d’échecs consécutifs d’un test nécessaires pour qu’un emplacement soit considéré comme ayant échoué. Par défaut, il y a une attente de 300ms avant de réessayer un test qui a échoué. Cet intervalle peut être configuré avec l’API.

Réessai rapide

Lorsqu’un test échoue, le réessai rapide vous permet de réessayer le test X fois après Y ms avant de le marquer comme échoué. La personnalisation de l’intervalle de réessai permet de réduire les faux positifs et d’améliorer la précision de vos alertes.

Étant donné que la disponibilité de l’emplacement est calculée en fonction du résultat final du test après l’achèvement des réessais, les intervalles de réessai rapide ont un impact direct sur ce qui apparaît dans votre graphique de disponibilité totale. La disponibilité totale est calculée en fonction des conditions d’alerte configurées, et les notifications sont envoyées sur la base de cette disponibilité totale.

Downtimes

To pause test execution during planned maintenance windows, select an existing Scheduled downtime in the Downtimes section. The test automatically pauses during the downtime’s scheduled time slots.

Note: You cannot create a new downtime from the test creation form. To create one, navigate to Settings > Downtimes.

Configurer le test monitor

Une notification est envoyée conformément à l’ensemble des conditions d’alerte. Utilisez cette section pour définir comment et quel message envoyer à vos équipes.

1. Saisissez un message pour le test monitor ou utilisez les messages pré-remplis. Ce champ permet un formatage standard Markdown et prend en charge les variables conditionnelles suivantes :

   Variable conditionnelle	Description
   {{#is_alert}}	Show when the monitor alerts.
   {{^is_alert}}	Show unless the monitor alerts.
   {{#is_recovery}}	Show when the monitor recovers from alert.
   {{^is_recovery}}	Show unless the monitor recovers from alert.
   {{#is_renotify}}	Show when the monitor renotifies.
   {{^is_renotify}}	Show unless the monitor renotifies.
   {{#is_priority}}	Show when the monitor matches priority (P1 to P5).
   {{^is_priority}}	Affiche sauf si le monitor correspond à la priorité (P1 à P5).

   Notification messages include the message defined in this section and information about the failing locations. Pre-filled monitor messages are included in the message body section:

   For example, to create a monitor that iterates over steps extracting variables for browser tests, add the following to the monitor message:

   {{! Liste des variables extraites de toutes les étapes réussies }}
   # Variables extraites
   {{#each synthetics.attributes.result.steps}}
   {{#if extractedValue}}
   * **Nom** : `
   **Valeur :** {{#if extractedValue.secure}}*Obfusqué (valeur cachée)*{{else}}`{{{extractedValue.value}}}`{{/if}}
   {{/if}}
   {{/each}}
   

2. Choose team members and services to notify.

3. Specify a renotification frequency. To prevent renotification on failing tests, check the option Stop re-notifying on X occurrences.

4. Click Save & Start Recording to save your test configuration and record your browser steps.

For more information, see Synthetic Monitoring notifications.

Record your steps

Tests can be only recorded from Google Chrome and Microsoft Edge. To record your test, download the Datadog Record Test extension.

You can switch tabs in a browser test recording to perform an action on your application (such as clicking on a link that opens another tab) and add another test step. Your browser test must interact with the page first (through a click) before it can perform an assertion. By recording all of the test steps, the browser test can switch tabs automatically at test execution.

1. Optionnellement, sélectionnez Ouvrir dans une fenêtre pop-up en haut à droite de la page pour ouvrir l’enregistrement de votre test dans une fenêtre pop-up distincte. Ceci est utile si votre application ne prend pas en charge l’ouverture dans un iframe ou si vous souhaitez éviter des problèmes de dimensionnement lors de l’enregistrement. Vous pouvez également ouvrir la fenêtre pop-up en mode Incognito pour commencer à enregistrer votre test à partir d’un navigateur frais, exempt de sessions déjà connectées, de cookies de votre navigateur existant, et plus encore.

2. Optionnellement, activez Datadog pour collecter automatiquement les données RUM lors de l’exécution des enregistrements d’étapes depuis votre test de navigateur. Pour plus d’informations, voir Explorer RUM & Relecture de session.

3. Cliquez sur Démarrer l’enregistrement pour commencer l’enregistrement de votre test de navigateur.

4. Lorsque vous cliquez sur votre application en suivant le parcours utilisateur que vous souhaitez surveiller, vos actions sont automatiquement enregistrées et utilisées pour créer des étapes dans votre scénario de test de navigateur à gauche.

5. En plus des étapes automatiquement enregistrées, vous pouvez également utiliser les étapes disponibles dans le coin supérieur gauche pour enrichir votre scénario :

   Datadog recommande de terminer votre test de navigateur par une assertion pour confirmer que le parcours exécuté par le test de navigateur a abouti à l’état attendu.

6. Une fois que vous avez terminé votre scénario, cliquez sur Enregistrer et lancer le test.

Rejouez vos étapes

Pour relancer une ou plusieurs étapes de votre test de navigateur directement dans votre navigateur, téléchargez l’extension Datadog Record Test.

La fonctionnalité de Relecture des Étapes vous aide à déboguer des étapes individuelles, à atteindre le bon état d’application lors de l’édition d’un test de navigateur, et à confirmer des flux entiers avant d’enregistrer votre test.

Remarque : La Relecture des Étapes peut se comporter différemment d’un test complet de Surveillance Synthétique en raison de conditions différentes (version du navigateur, réseau, agent utilisateur, état de connexion) ou de limitations.

Comment utiliser la relecture des étapes

Vous pouvez rejouer les étapes de trois manières :

1. Relecture d’une seule étape : Réexécutez une seule étape :

Survolez l'étape et cliquez sur le bouton de lecture pour rejouer uniquement cette étape.

2. Rejouer toutes les étapes : Exécutez l’ensemble de la séquence d’étapes telle que définie dans l’enregistreur :

Cliquez sur le bouton de rejouer toutes les étapes (⏩︎) en haut de la liste des étapes pour rejouer toutes les étapes.

3. Rejouer les étapes sélectionnées : Exécutez un sous-ensemble d’étapes que vous sélectionnez dans la liste des étapes :

Sélectionnez les étapes que vous souhaitez rejouer, puis cliquez sur le bouton de rejouer les étapes sélectionnées (⏩︎) en haut de la liste des étapes.

Prise en charge de la fonctionnalité de relecture d’étape

Le tableau suivant résume les types d’étapes de test de navigateur pris en charge par la relecture d’étape :

Types d’étapes non pris en charge par la relecture d’étape

Autorisation du débogueur

Pour être aussi proche que possible d’un test complet de surveillance synthétique, certaines étapes comme les étapes basées sur JavaScript ou les simulations de frappes nécessitent l’autorisation du débogueur pour être répétées.

La première fois que l’extension est mise à jour vers une version nécessitant l’autorisation du débogueur, une demande d’autorisation apparaît et l’extension est désactivée jusqu’à ce que vous l’approuviez :

Cliquez sur les trois points du menu pour accepter l'autorisation.

Autorisations

Par défaut, seuls les utilisateurs ayant les rôles Administrateur Datadog et Standard Datadog peuvent créer, modifier et supprimer des tests de navigateur synthétiques. Pour obtenir l’accès à la création, à la modification et à la suppression des tests de navigateur synthétiques, mettez à niveau votre utilisateur vers l’un de ces deux rôles par défaut.

Si vous utilisez la fonctionnalité de rôle personnalisé, ajoutez votre utilisateur à tout rôle personnalisé qui inclut les permissions synthetics_read et synthetics_write.

Restreindre l’accès

Utilisez le contrôle d’accès granulaire pour limiter qui a accès à votre test en fonction des rôles, des équipes ou des utilisateurs individuels :

1. Ouvrez la section des permissions du formulaire.
2. Cliquez sur Modifier l’accès.

3. Cliquez sur Restreindre l’accès.
4. Sélectionnez des équipes, des rôles ou des utilisateurs.
5. Cliquez sur Ajouter.
6. Sélectionnez le niveau d’accès que vous souhaitez associer à chacun d’eux.
7. Cliquez sur Terminé.

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Démarrage des tests de navigateurDOCUMENTATION En savoir plus sur les monitors de test SyntheticDOCUMENTATION Historique des versions de Synthetic MonitoringGUIDE Centre d'apprentissage Datadog : Premiers pas avec les tests de navigateur SyntheticCENTRE D'APPRENTISSAGE Bonnes pratiques pour la création de tests de bout en boutBLOG Simplifier le dépannage tout au long du parcours utilisateur avec Datadog Synthetic MonitoringBLOG Comment j'ai aidé mon client à faire évoluer ses tests de navigateur avec DatadogBLOG Créer et gérer des tests Browser Synthetic avec TerraformSITE EXTERNE