Paramètres de la surveillance Synthetic

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 tirets bas.
  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).

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.

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.

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 Datadog et 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 avez accès aux 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

La restriction d'accès est réservée aux clients qui disposent de la fonctionnalité Rôles personnalisé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.

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

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

Autorisations

Par défaut, seuls les utilisateurs disposant des rôles Admin Datadog et 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 avez accès aux 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