Présentation
L’intégration de l’APM avec la surveillance Synthetic vous permet d’identifier la cause de l’échec d’un test en visualisant les traces générées durant son exécution.
En accédant à des données réseau (grâce à votre test) ainsi qu’à des informations sur le backend, l’infrastructure et les logs (grâce à votre trace), vous avez la possibilité d’analyser en détail le comportement de votre application, tel que constaté par votre utilisateur.
Utilisation
Les informations sur cette page s’appliquent aux tests API HTTP, aux tests API à plusieurs étapes et aux tests Browser pour APM.
Prérequis
- Votre service, et l’endpoint sur lequel vous exécutez le test, sont soumis à un tracing côté APM.
- Votre service utilise un serveur HTTP.
- Votre serveur HTTP utilise une bibliothèque qui prend en charge le tracing distribué.
Créez un test qui s’applique à votre serveur HTTP tracé, et Datadog associera automatiquement la trace générée par votre serveur au résultat de test correspondant.
Pour associer des résultats de test Browser, autorisez les URL auxquelles vous souhaitez ajouter les en-têtes d’intégration APM. Vous pouvez effectuer cette opération depuis les paramètres Synthetic. Utilisez le caractère *
pour les wildcards :
https://*.datadoghq.com/*
Bibliothèques compatibles
Les bibliothèques de tracing Datadog suivantes sont prises en charge :
Datadog utilise un protocole de tracing distribué et configure les en-têtes HTTP suivants :
x-datadog-trace-id
- Généré à partir du backend de surveillance Synthetic. Permet à Datadog d’associer la trace au résultat du test.
x-datadog-parent-id: 0
- Permet aux tests Synthetic d’être la span racine de la trace générée.
x-datadog-origin: synthetics
- Permet de s’assurer que les traces générées à partir des tests API ne rentrent pas en compte dans le calcul de vos quotas de l’APM.
x-datadog-origin: synthetics-browser
- Permet de s’assurer que les traces générées à partir des tests Browser ne rentrent pas en compte dans le calcul de vos quotas de l’APM.
x-datadog-sampling-priority: 1
- Permet de s’assurer que l’Agent conserve la trace.
Cela a-t-il une incidence sur les quotas de l’APM ?
L’en-tête x-datadog-origin: synthetics
indique au backend APM que les traces sont générées par Synthetic. Les traces générées n’ont par conséquent aucune incidence sur les quotas standard de l’APM.
Combien de temps les traces sont-elles conservées ?
Ces traces sont conservées aussi longtemps que vos traces APM standard.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles: