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.
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 sur l’Agent ou reportez-vous au modèle de configuration datadog.yaml.
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é :
localhost:8126.Pour en savoir plus sur la configuration de Lambda - X-Ray, consultez la documentation sur l’intégration Amazon X-Ray.
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.
Vous pouvez utiliser d’autres composants que l’Agent et les conteneurs pour recueillir des traces.
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.
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.
Il existe plusieurs manières de spécifier un environnement lors de l’envoi de données :
env:<ENVIRONNEMENT> pour appliquer le tag correspondant à l’ensemble des traces de l’Agent.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>
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.
Ensuite, instrumentez votre application. Pour consulter l’ensemble des étapes de configuration de l’APM, accédez à la section Présentation de l’APM.
Documentation, liens et articles supplémentaires utiles:
