Paramètres de la surveillance Synthetic

La page des paramètres de la surveillance Synthetic vous permet de définir les paramètres suivants :

Variables globales

Les variables globales sont des variables accessibles à partir de l’ensemble de vos tests Synthetic. Elles peuvent être utilisées dans tous les tests API uniques et à plusieurs étapes, ainsi que dans les tests Browser de votre collection de tests. Pour créer une variable globale, accédez à l’onglet Global variables de la page Settings, puis cliquez sur New Global Variable en haut à droite.

Choisissez le type de variable que vous souhaitez créer :

    1. 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.
    2. Saisissez une description pour votre variable (facultatif).
    3. Sélectionnez les tags à associer à votre variable (facultatif).
    4. Saisissez la valeur que vous souhaitez attribuer à votre variable.
    5. Activez l’obfuscation de votre variable pour masquer sa valeur dans les résultats du test (facultatif).
    Variable globale avec valeur spécifiée

    Vous pouvez créer des variables à partir de vos tests HTTP existants en parsant les en-têtes et le corps de la réponse associée.

    1. 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.
    2. Saisissez une description pour votre variable (facultatif).
    3. Sélectionnez les tags à associer à votre variable (facultatif).
    4. Sélectionnez le test HTTP à partir duquel vous souhaitez extraire votre variable.
    5. Activez l’obfuscation de votre variable pour masquer sa valeur dans les résultats du test (facultatif).
    6. Indiquez si la variable doit être extraite à partir des en-têtes ou du corps de la réponse.
      • 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 regex.
      • 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.
    Variable depuis un test HTTP

    Remarque : 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.

    1. Sous Choose variable type, sélectionnez MFA Token.
    2. 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.
    3. Saisissez une description pour votre variable (facultatif).
    4. Sélectionnez les tags à associer à votre variable (facultatif).
    5. Saisissez la clé du secret de votre variable ou importez une image de code QR.
    6. Cliquez sur + Generate pour créer un OTP. Vous pouvez copier l’OTP généré à l’aide de l’icône Copier.
    Créer un token MFA

    Remarque : pour en savoir plus sur l’authentification multifacteur basée sur un TOTP dans un test Browser, consultez le guide TOTP.

    Une fois les variables globales créées, elles peuvent être utilisées dans tous les tests Synthetic. Pour ce faire, saisissez {{ dans le champ de votre choix et sélectionnez votre variable globale. Pour en savoir plus, consultez les ressources suivantes : Test HTTP, Test API à plusieurs étapes, Configuration des tests Browser et Documentation relative aux étapes.

    Autorisations

    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_global_variable_read et synthetics_global_variable_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.

    Vous pouvez faire en sorte que certaines 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.

    Restreindre l'accès à une variable globale

    Paramètres par défaut

    Emplacements par défaut

    Choisissez les emplacements par défaut pour les détails relatifs à votre test API, test API à plusieurs étapes ou test Browser.

    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.

    Intégration APM pour les tests Browser

    Autorisez une URL pour inclure des en-têtes d’intégration APM dans cette URL. Les en-têtes d’intégration APM de Datadog permettent à Datadog de lier les tests Browser aux données d’APM.

    Définissez les endpoints devant recevoir les en-têtes APM en ajoutant une URL dans cette section.

    Utilisez * pour inclure des noms de domaine entiers. Par exemple, ajoutez https://*.datadoghq.com/* pour inclure toutes les adresses https://datadoghq.com/.

    Si l’endpoint est tracé et inclus dans la liste, les résultats du test Browser sont automatiquement liés à la trace correspondante.

    Application des tags

    L'application des tags est une fonctionnalité avancée incluse dans la formule Enterprise. Pour toutes les autres formules, contactez votre chargé de compte ou envoyez un e-mail à success@datadoghq.com pour demander l'activation de cette fonctionnalité.

    Cette fonctionnalité vous permet d’appliquer des tags spécifiques aux tests Synthetic. Vous pouvez visualiser les coûts et l’utilisation par équipes, applications ou services.

    Pour appliquer des tags, cliquez sur Enforce tags for usage attributions on all tests. 

    Appliquer des tags pour les attributions d'utilisation sur tous les tests

    Pour en savoir plus, consultez la section Attribution de l’utilisation.

    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.

    Pour aller plus loin

    Documentation, liens et articles supplémentaires utiles:

    Présentation de la surveillance Synthetic DatadogBLOG more more Configurer un test APIDOCUMENTATION more more Configurer un test BrowserDOCUMENTATION more more Identifier les bots SyntheticDOCUMENTATION more more Mots de passe à usage unique basés sur le temps (TOTP) pour l'authentification multifacteur dans des tests BrowserDOCUMENTATION more more Créer et gérer des variables globales Synthetic avec TerraformTERRAFORM more more