Imposer des tags pour l’attribution de l’utilisation sur tous les tests
Sur la page Attribution de l’utilisation, vous pouvez configurer jusqu’à trois tags pour ventiler les coûts et les attributs d’utilisation. Sélectionnez Enforce tags for usage attribution on all tests pour exiger que les utilisateurs saisissent tous les tags d’attribution de l’utilisation configurés lors de la création ou de la modification de tests Synthetic. Lorsque ce paramètre est activé, les utilisateurs ne peuvent pas enregistrer de tests sans saisir tous les tags requis.
Imposer des politiques de tags de monitor requises sur tous les tests
Sur la page Synthetic Monitoring and Testing settings, sélectionnez Enforce required monitor tag policies on all tests pour exiger que les politiques de tags de monitor définies par l’utilisateur soient appliquées aux tests Synthetic. Lorsque ce paramètre est activé, les utilisateurs ne peuvent pas enregistrer de tests sans saisir 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.
Lorsque vous avez terminé de sélectionner les emplacements, cliquez sur Save Default Locations.
Navigateurs et appareils par défaut
Choisissez les types d’appareils et de navigateurs par défaut pour les détails relatifs à votre test de navigateur.
Vos options pour les navigateurs incluent Google Chrome, Mozilla Firefox et Microsoft Edge. Vos options pour les appareils incluent un grand ordinateur portable, une tablette et un petit appareil mobile.
Lorsque vous avez terminé de sélectionner les navigateurs et les appareils, cliquez sur Save Default Browsers & Devices.
Lorsque vous avez terminé de sélectionner les tags associés, cliquez sur Save Default Frequencies.
Tentatives par défaut
Choisissez ou ajoutez le nombre de fois par défaut que vous souhaitez que votre test soit relancé en cas d’échec pour les détails de votre test API, test de navigateur ou test mobile.
Lorsque vous avez terminé de saisir les valeurs de tentative par défaut, cliquez sur Save Default Retries.
Appareils mobiles par défaut
Choisissez ou ajoutez les appareils mobiles par défaut que vous souhaitez utiliser dans les détails de votre test mobile.
Une fois la saisie des appareils mobiles par défaut terminée, cliquez sur Save Default Devices.
Autorisations
Par défaut, seuls les utilisateurs disposant des rôles Datadog Admin et Datadog Standard peuvent accéder à la page Default Settings de Synthetic Monitoring. Pour accéder à la Default Settings page, 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é incluant les autorisations synthetics_default_settings_read et synthetics_default_settings_write.
Choisissez le type de variable que vous souhaitez créer :
Saisissez un Variable Name. Le nom de votre variable ne peut contenir que des lettres majuscules, des chiffres et des traits de soulignement. Ce nom doit être unique parmi vos variables globales.
Facultativement, saisissez une Description et sélectionnez Tags à associer à votre variable.
Saisissez la Value que vous souhaitez attribuer à votre variable.
Facultativement, utilisez les fonctions intégrées pour attribuer des valeurs à votre variable. Par exemple, cliquez sur la fonction intégrée `{{ alphabetic(n) }} pour remplir le champ Value avec un exemple de valeur alphabétique.
Facultativement, activez l’obfuscation de votre variable pour masquer sa valeur dans les résultats de test.
Les fonctions intégrées suivantes sont disponibles :
{{ numeric(n) }}
Génère une chaîne numérique avec n chiffres.
{{ alphabetic(n) }}
Génère une chaîne alphabétique avec n lettres.
{{ alphanumeric(n) }}
Génère une chaîne alphanumérique avec n caractères.
{{ date(n unit, format) }}
Génère une date dans l’un des formats acceptés par Datadog avec une valeur correspondant à la date UTC à laquelle le test est lancé, plus ou moins n unités.
{{ timestamp(n, unit) }}
Génère un horodatage dans l’une des unités acceptées par Datadog avec une valeur correspondant à l’horodatage UTC au moment du lancement du test, plus ou moins n unités.
{{ uuid }}
Génère un identifiant unique universel (UUID) de version 4.
{{ public-id }}
Injecte l’ID public de votre test.
{{ result-id }}
Injecte l’ID de résultat de votre exécution de test.
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.
Saisissez un Variable Name. Le nom de votre variable ne peut contenir que des lettres majuscules, des chiffres et des traits de soulignement.
Facultativement, saisissez une Description et sélectionnez Tags à associer à votre variable.
Activez l’obfuscation de votre variable pour masquer sa valeur dans les résultats de test (facultatif).
Sélectionnez le test à partir duquel vous souhaitez extraire une variable.
Si vous utilisez un test API à plusieurs étapes, extrayez votre variable locale du test. Si vous utilisez un test HTTP, choisissez d’extraire votre variable de l’en-tête de réponse ou du corps de la réponse.
Extraire la valeur de Response Header : Utilisez l’en-tête de réponse complet pour votre variable ou analysez-le avec un regex.
Extraire la valeur de Response Body : Analysez le corps de la réponse de la requête avec un regex, un jsonpath, un xpath, ou utilisez le corps de la réponse complet.
Extraire la valeur du Response Status Code.
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 :
Faire correspondre non seulement la première instance d’un motif, mais aussi toutes les instances du motif fourni
Ignorer la casse du motif de correspondance
Faire correspondre les chaînes sur plusieurs lignes
Traiter le motif regex transmis comme unicode
Autoriser les symboles de point à identifier les nouvelles lignes
Faire correspondre à partir d’un index donné dans un motif regex
Remplacer le motif correspondant par une valeur fournie
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. Remarque : Actuellement, seul l’algorithme de hachage SHA1 est pris en charge pour TOTP.
Dans Choose variable type, sélectionnez MFA Token.
Dans Define Variable, saisissez un Variable Name. Le nom de votre variable ne peut contenir que des lettres majuscules, des chiffres et des traits de soulignement.
Facultativement, entrez une Description et sélectionnez Tags à associer à votre variable.
Entrez la Secret Key de votre variable ou téléversez une image de code QR.
Cliquez sur + Generate pour créer un OTP. Vous pouvez copier l’OTP généré avec l’icône Copy.
Remarque : Si votre jeton TOTP fonctionne dans Google Authenticator, il est probablement compatible avec Datadog.
Certains codes QR sont limités à des méthodes de vérification spécifiques et peuvent ne pas fonctionner sur toutes les plateformes. Pour garantir la compatibilité, utilisez un code QR ou un secret qui respecte les protocoles TOTP standard.
Pour effectuer un parcours utilisateur avec une clé d’accès dans vos tests Synthetics, créez une variable globale d’authentificateur virtuel. Cette variable globale est utilisée pour générer et stocker des clés d’accès pour tous vos tests de navigateur Synthetics. Pour plus d’informations, consultez Utilisation des clés d’accès dans les tests de navigateur.
Dans la section Choose variable type, sélectionnez Virtual Authenticator.
Dans la section Specify variable details, entrez une Variable Name. Le nom de votre variable ne peut contenir que des lettres majuscules, des chiffres et des traits de soulignement.
Optionnellement, entrez une Description et sélectionnez Tags pour l’associer à votre variable. Datadog crée alors un authentificateur virtuel utilisé pour générer et stocker vos clés d’accès.
Dans la section Permissions settings, restreignez l’accès à votre variable en fonction des rôles dans votre organisation. Pour plus d’informations sur les rôles, consultez la documentation RBAC.
Une fois créées, les variables globales peuvent être utilisées dans tous les tests Synthetic. Pour importer vos variables globales dans votre test, cliquez sur + Variables, saisissez {{ dans un champ où vous souhaitez ajouter la variable, puis sélectionnez votre variable globale.
Par défaut, seuls les utilisateurs disposant des rôles Datadog Admin et Datadog Standard peuvent accéder à la page Global Variables de Synthetic Monitoring. Vous pouvez obtenir l’accès à la page Global Variables en faisant passer votre utilisateur à 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é incluant les autorisations synthetics_default_settings_read et synthetics_default_settings_write.
Restreindre l’accès
Utilisez le contrôle d’accès granulaire pour limiter l’accès à votre test en fonction des rôles, des équipes ou des utilisateurs individuels :
Ouvrez la section des autorisations du formulaire.
Cliquez sur Edit Access.
Cliquez sur Restrict Access.
Sélectionnez des équipes, des rôles ou des utilisateurs.
Cliquez sur Add.
Sélectionnez le niveau d’accès que vous souhaitez associer à chacun d’eux.
Cliquez sur Done.
Vous pouvez consulter les résultats d'une Private Location même sans accès Viewer à cette Private Location.
Niveau d’accès
Voir la valeur de la variable globale
Voir les métadonnées de la variable globale
Utiliser la variable globale dans un test
Modifier la valeur/les métadonnées de la variable globale
Aucun accès
Viewer
Editor
Remarque : Restreindre une variable empêche les autres utilisateurs de l’ajouter à un test et de l’utiliser ; cela ne masque pas le nom de la variable si elle est déjà utilisée dans un test existant.
Paramètres d’intégration
Intégration APM pour les tests de navigateur
Autorisez les URL à ajouter des en-têtes d’intégration APM à ces URL. Les en-têtes des intégrations APM Datadog permettent à Datadog d’associer des tests de navigateur à APM.
Définissez les endpoints vers lesquels vous souhaitez envoyer les en-têtes APM en saisissant une URL dans le champ Value. Si l’endpoint est tracé et inclus dans la liste, les résultats du test de navigateur sont automatiquement liés à la trace correspondante.
Utilisez * pour autoriser des noms de domaine plus larges. Par exemple, l’ajout de https://*.datadoghq.com/* autorise tout ce qui se trouve sur https://datadoghq.com/. Une fois que vous avez terminé d’ajouter des URL, cliquez sur Save APM Integration Settings.
Pour en savoir plus, consultez la section APM Synthetic.
Collecte de données de test de navigateur Synthetic et applications RUM
Pour permettre à Datadog de collecter des données RUM à partir de vos exécutions de tests de navigateur, cliquez sur Enable Synthetic RUM data collection. Si cette option est désactivée, vous ne pouvez pas modifier le paramètre RUM dans l’enregistreur de tests de navigateur. Une fois l’activation de la collecte de données terminée, cliquez sur Save RUM Data Collection.
Sélectionnez une application RUM dans le menu déroulant Default Application qui collecte les données de test de navigateur. Une fois la spécification d’une application par défaut terminée, cliquez sur Save RUM Data Applications.
Collecte de données de test d’application mobile Synthetic
Pour permettre à Datadog de collecter des données RUM à partir de vos exécutions de tests d’application mobile, configurez et packagez le SDK iOS ou le SDK Android RUM avec votre fichier .ipa ou .apk. Cela associe automatiquement les données RUM, vous offrant une observabilité de bout en bout des exécutions de tests.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
