Depuis la page Usage Attribution, vous pouvez configurer jusqu’à trois tags servant à répartir les attributs de coût et d’utilisation. Sélectionnez l’option Enforce tags for usage attribution on all tests pour forcer les utilisateurs à saisir tous les tags d’attribution d’utilisation lors de la création ou de la modification de tests Synthetic. Lorsque ce paramètre est activé, il n’est pas possible d’enregistrer un test ne comportant pas tous les tags requis.
Les options comprennent tous les emplacements gérés disponibles proposés par Datadog, ainsi que les emplacements privés que vous avez configurés pour votre compte.
Une fois les emplacements sélectionnés, cliquez sur Save Default Locations.
Appareils et navigateurs par défaut
Choisissez les types d’appareils et de navigateurs par défaut pour les détails relatifs à votre test Browser.
Les navigateurs Google Chrome, Mozilla Firefox et Microsoft Edge sont disponibles. Pour les navigateurs, vous pouvez choisir parmi un grand ordinateur portable, une tablette et un petit appareil mobile.
Une fois vos navigateurs et appareils sélectionnés, cliquez sur Save Default Browsers & Devices.
Une fois les tags associés sélectionnés, cliquez sur Save Default Tags.
Autorisations
Par défaut, seuls les utilisateurs disposant des rôles Admin ou Standard Datadog peuvent accéder à la page Paramètres par défaut de la surveillance Synthetic. Pour que votre utilisateur puisse consulter la page Paramètres par défaut, vous devez donc lui accorder l’un de ces deux rôles par défaut.
Si vous utilisez des rôles personnalisés, ajoutez votre utilisateur à un rôle personnalisé disposant des autorisations synthetics_default_settings_read et synthetics_default_settings_write.
Paramètres d’intégration
Intégration APM pour les tests Browser
Les en-têtes des intégrations APM Datadog permettent à Datadog d’associer des tests Browser à APM.
Pour définir les endpoints vers lesquels vous souhaitez envoyer les en-têtes APM, ajoutez des URL à la liste Value. Si les endpoints sont tracés et autorisés, les résultats de votre test Browser sont automatiquement associés à la trace correspondante.
Utilisez le caractère * pour inclure des noms de domaine entiers. Par exemple, ajoutez https://*.datadoghq.com/* pour inclure toutes les adresses https://datadoghq.com/. Une fois les URL ajoutées, cliquez sur Save APM Integration Settings.
Pour en savoir plus, consultez la section APM Synthetic.
Collecte de données Synthetic et applications RUM
Pour autoriser Datadog à recueillir les données RUM de vos exécutions de test, cliquez sur Enable Synthetic RUM data collection. Lorsque cette option est désactivée, vous ne pouvez pas modifier les paramètres RUM dans l’outil d’enregistrement de test Browser. Pour appliquer vos modifications, cliquez sur Save RUM Data Collection.
Sélectionnez l’application par défaut à laquelle les nouveaux tests Browser doivent envoyer les données. Utilisez le menu déroulant Default Application pour sélectionner une application RUM qui recueille les données de test Browser. Pour appliquer vos modifications, cliquez sur Save RUM Data Applications.
Choisissez le type de variable que vous souhaitez créer :
Donnez un nom à votre variable en renseignant le champ Variable Name. Ce nom peut uniquement contenir des lettres majuscules, des chiffres et des underscores. Aucune autre variable globale ne doit utiliser ce nom.
Si vous le souhaitez, saisissez une description, puis sélectionnez des tags à associer à votre variable.
Saisissez la valeur que vous souhaitez attribuer à votre variable.
Activez l’obfuscation de votre variable pour masquer sa valeur dans les résultats du test (facultatif).
Vous pouvez créer des variables à partir de vos tests HTTP existants, en parsant leur corps et leurs en-têtes de réponse associés, ou à partir de vos tests API à plusieurs étapes existants, à l’aide de leurs variables extraites.
Donnez un nom à votre variable en renseignant le champ Variable Name. Ce nom peut uniquement contenir des lettres majuscules, des chiffres et des tirets bas.
Si vous le souhaitez, saisissez une description, puis sélectionnez des tags à associer à votre variable.
Activez l’obfuscation de votre variable pour masquer sa valeur dans les résultats du test (facultatif).
Sélectionnez le test à partir duquel vous souhaitez extraire une variable.
Pour un test API à plusieurs étapes, extrayez votre variable locale à partir du test. Pour un test HTTP, choisissez si vous souhaitez extraire la variable à partir de l’en-tête ou du corps de la réponse.
Pour extraire la valeur à partir d’un en-tête de réponse : utilisez l’en-tête complet comme variable, ou parsez l’en-tête à l’aide d’une expression regex.
Pour extraire la valeur à partir du corps de la réponse : parsez le corps de la réponse de la requête avec une expression regex, jsonpath ou xpath, ou utilisez le corps entier.
Extrayez la valeur à partir du code de statut de la réponse.
Il est non seulement possible d’extraire une valeur à partir d’une regex, mais également d’utiliser une regex afin d’appliquer les logiques de parsing suivantes :
Ne pas renvoyer simplement la première instance d’un pattern, mais toutes ses instances
Ignorer la casse du pattern
Renvoyer des chaînes réparties sur plusieurs lignes
Considérer le pattern de regex passé comme de l’unicode
Autoriser les symboles de point pour l’identification de nouvelles lignes
Renvoyer des résultats provenant d’un index donné au seni d’un pattern de regex
Remplacer le pattern de recherche par une valeur spécifique
Les valeurs des variables sont mises à jour lors de chaque exécution du test à partir duquel elles sont extraites.
Pour générer et utiliser un TOTP dans vos tests, créez une variable globale et ajoutez-y une clé de secret ou importez un code QR fourni par votre fournisseur d’authentification.
Sous Choose variable type, sélectionnez MFA Token.
Sous Define Variable, donnez un nom à votre variable en renseignant le champ Variable Name. Ce nom peut uniquement contenir des lettres majuscules, des chiffres et des tirets bas.
Si vous le souhaitez, saisissez une description, puis sélectionnez des tags à associer à votre variable.
Saisissez la clé du secret de votre variable ou importez une image de code QR.
Cliquez sur + Generate pour créer un OTP. Vous pouvez copier l’OTP généré à l’aide de l’icône Copier.
Pour terminer un parcours utilisateur avec une clé d’accès dans vos tests Synthetic, créez une variable globale de type Authentificateur virtuel. Cette variable globale permet de générer et de stocker des clés d’accès pour l’ensemble de vos tests Browser Synthetic. Pour en savoir plus, consultez la section Utiliser des clés d’accès (FIDO2) dans des tests Browser.
Depuis la section Choose variable type, sélectionnez Virtual Authenticator.
Depuis la section Specify variable details, saisissez un nom de variable. Votre nom de variable peut uniquement contenir des lettres majuscules, des chiffres et des underscores.
Si vous le souhaitez, saisissez une description, puis sélectionnez des tags à associer à votre variable. Datadog crée alors un authentificateur virtuel permettant de générer et de stocker vos clés d’accès.
Depuis la section Permissions settings, limitez l’accès à votre variable à certains rôles de votre organisation. Pour en savoir plus sur les rôles, consultez la documentation relative au RBAC.
Une fois vos variables globales créées, vous pouvez les utiliser dans n’importe quel test Synthetic. Pour importer une variable globale dans un test, cliquez sur + Variables, saisissez {{ dans le champ où vous souhaitez ajouter la variable, puis sélectionnez votre variable globale.
Par défaut, seuls les utilisateurs disposant des rôles Admin ou Standard Datadog peuvent accéder à la page Variables globales de la surveillance Synthetic. Pour que votre utilisateur puisse consulter la page Variables globales, vous devez donc lui accorder l’un de ces deux rôles par défaut.
Si vous utilisez des rôles personnalisés, ajoutez votre utilisateur à un rôle personnalisé disposant des autorisations synthetics_default_settings_read et synthetics_default_settings_write.
Restreindre l’accès
Les clients qui ont configuré des rôles personnalisés sur leur compte peuvent utiliser la fonctionnalité de restriction d’accès. Si vous utilisez des rôles personnalisés, ajoutez votre utilisateur à un rôle personnalisé disposant des autorisations synthetics_global_variable_read et synthetics_global_variable_write.
Vous pouvez faire en sorte que certains rôles au sein de votre organisation ne puissent pas accéder à une variable globale. Lors de la création d’une variable globale, choisissez les rôles (en plus des utilisateurs) disposant des autorisations de lecture/écriture sur votre variable globale dans Permissions settings.
Paramètres d’intégration
Intégration APM pour les tests Browser
Autorisez des URL pour inclure des en-têtes d’intégration APM dans ces URL. Les en-têtes d’intégration APM de Datadog permettent à Datadog d’associer des tests Browser à APM.
Pour définir les endpoints vers lesquels vous souhaitez envoyer les en-têtes APM, saisissez des URL dans le champ Value. Si les endpoints sont tracés et autorisés, les résultats de votre test Browser sont automatiquement associés à la trace correspondante.
Utilisez le caractère * pour inclure des noms de domaine entiers. Par exemple, ajoutez https://*.datadoghq.com/* pour inclure toutes les adresses https://datadoghq.com/. Une fois les URL ajoutées, cliquez sur Save APM Integration Settings.
Pour en savoir plus, consultez la section APM Synthetic.
Collecte de données Synthetic et applications RUM
Pour autoriser Datadog à recueillir les données RUM de vos exécutions de test, cliquez sur Enable Synthetic RUM data collection. Lorsque cette option est désactivée, vous ne pouvez pas modifier les paramètres RUM dans l’outil d’enregistrement de test Browser. Une fois la collecte de données activée, cliquez sur Save RUM Data Collection.
Depuis le menu déroulant Default Application, sélectionnez une application RUM qui recueille les données de test Browser. Une fois l’application par défaut définie, cliquez sur Save RUM Data Applications.
