Activer la collecte de traces dans Datadog

Pour utiliser l’APM, commencez par envoyer vos traces à Datadog, puis configurez votre environnement. Vous pouvez envoyer des traces à Datadog de plusieurs manières en fonction de la configuration de votre système : en exécutant l’Agent Datadog localement, sur des conteneurs ou via un autre type d’environnement. Pour consulter l’ensemble des étapes de configuration de l’APM, accédez à la section Présentation de l’APM.

Agent Datadog

L’APM est activé par défaut dans l’Agent 6. Définissez apm_non_local_traffic: true dans votre fichier de configuration principal datadog.yaml si vous envoyez des traces depuis un environnement non local (comme un conteneur).

Pour découvrir l’ensemble des paramètres disponibles pour l’APM, consultez le fichier de configuration datadog.example.yaml de l’Agent. Pour obtenir la liste complète des métriques envoyées à Datadog par l’Agent, consultez la page Métriques APM envoyées par l’Agent Datadog. Pour en savoir plus sur l’Agent Datadog, consultez la documentation de l’Agent ou reportez-vous au modèle de configuration datadog.yaml.

Conteneurs

Consultez les instructions de configuration spécifiques pour vous assurer que l’Agent est configuré de manière à recevoir des traces dans un environnement conteneurisé :

Remarque : après avoir instrumenté votre application, par défaut, le client de tracing envoie les traces à localhost:8126.

Environnement sans serveur

AWS Lambda

Pour en savoir plus sur la configuration de Lambda - X-Ray, consultez la documentation sur l’intégration Amazon X-Ray.

Google App Engine, AAS

L’APM Datadog requiert l’envoi de données de trace à un Agent en cours d’exécution. Pour activer la collecte de trace dans un environnement sans serveur, il est possible de configurer une machine virtuelle distincte qui accepte le trafic de traces de manière externe.

Environnements supplémentaires

Vous pouvez utiliser d’autres composants que l’Agent et les conteneurs pour recueillir des traces.

Heroku

Le tracing est activé par défaut lors de la surveillance avec Heroku. Pour en savoir plus sur la configuration du tracing pour Heroku, consultez la documentation sur la plateforme cloud Heroku.

Cloud Foundry

Le tracing est activé par défaut lors de la surveillance avec Cloud Foundry. Pour en savoir plus sur la configuration du tracing pour Cloud Foundry, consultez la documentation Cloud Foundry.

Configurer votre environnement

Il existe plusieurs manières de spécifier un environnement lors de l’envoi de données :

1. Tag de host : utilisez un tag de host au format env:<ENVIRONNEMENT> pour appliquer le tag correspondant à l’ensemble des traces de l’Agent.
2. Configuration de l’Agent : remplacez le tag par défaut utilisé par l’Agent dans le fichier de configuration de l’Agent. Cela permet de taguer l’ensemble des traces transmises à l’Agent en ignorant la valeur du tag de host. apm_config: env: <ENVIRONMENT>
3. Par trace : lorsque vous envoyez une seule trace, spécifiez un environnement en taguant l’une de ses spans avec la clé de métadonnées env. Ce tag remplace alors la configuration de l’Agent et la valeur du tag de host (le cas échéant). Consultez la documentation relative au tagging de traces pour découvrir comment assigner un tag à vos traces.

Étapes suivantes

Ensuite, instrumentez votre application. Pour consulter l’ensemble des étapes de configuration de l’APM, accédez à la section Présentation de l’APM.

Pour aller plus loin