APM Synthetic

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 déclarations sur cette page s’appliquent aux tests API et aux tests Browser pour l’APM, sauf indication contraire.

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. Utilisez * pour les caractères génériques :

https://*.datadoghq.com/*

Bibliothèques prises en charge

Les bibliothèques de tracing Datadog suivantes sont prises en charge :

Bibliothèque	Version minimale
Python	0.22.0
Go	1.10.0
Java	0.24.1
Ruby	0.20.0
JavaScript	0.10.0
PHP	0.33.0
.NET	1.18.2

Comment les traces sont-elles associées aux tests ?

Datadog utilise un protocole de tracing distribué et configure les en-têtes HTTP suivants :

En-tête	Description
`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.