Si vous installez ou mettez à jour l’Agent Datadog en ayant sélectionné l’option Enable APM Instrumentation (beta), l’Agent est installé et configuré pour activer APM. Vous pourrez ainsi instrumenter automatiquement votre application sans étape d’installation ou de configuration supplémentaire.
Pour commencer, lisez la documentation Instrumentation en une étape.
Pour instrumenter automatiquement votre application à l’aide des bibliothèques Datadog :
- Installez et configurez l’Agent.
- Ajoutez la bibliothèque de tracing Datadog dans votre code.
Installez et configurez l’Agent Datadog de façon à ce qu’il reçoive les traces provenant de votre application instrumentée. Par défaut, l’Agent Datadog est configuré pour recevoir les traces dans votre fichier datadog.yaml avec l’option enabled: true sous apm_config. Il détecte les données de trace sur http://localhost:8126.
Pour les environnements conteneurisés, suivez les liens ci-dessous pour activer la collecte de traces au sein de l’Agent Datadog.
Conteneurs
- Définissez
apm_non_local_traffic: true dans la section apm_config de votre fichier de configuration principal datadog.yaml. - Consultez les instructions de configuration spécifiques pour vous assurer que l’Agent est configuré de façon à recevoir des traces dans un environnement conteneurisé :
Le client de tracing tente d’envoyer les traces au socket de domaine Unix /var/run/datadog/apm.socket par défaut. Si le socket n’existe pas, les traces sont envoyées à http://localhost:8126.
Si vous souhaitez spécifier un autre socket, host ou port, utilisez la variable d’environnement DD_TRACE_AGENT_URL. Par exemple :
DD_TRACE_AGENT_URL=http://custom-hostname:1234
DD_TRACE_AGENT_URL=unix:///var/run/datadog/apm.socket
Là encore, le client de tracing tente d’envoyer les statistiques au socket de domaine Unix /var/run/datadog/dsd.socket. Si le socket n’existe pas, les statistiques sont envoyées à http://localhost:8125.
- Définissez
DD_SITE dans l’Agent Datadog sur
AWS Lambda
Pour configurer la solution APM Datadog dans AWS Lambda, consultez la documentation dédiée au tracing de fonctions sans serveur.
Autres environnements
Le tracing est disponible pour d’autres d’environnements tels que Heroku, Cloud Foundry, AWS Elastic Beanstalk et Azure App Services.
Pour les autres environnements, consultez la documentation relative aux intégrations pour l’environnement qui vous intéresse. Contactez l’assistance si vous rencontrez des problèmes de configuration.
Instrumenter votre application
Configurez votre application pour envoyer des traces en utilisant l’une des bibliothèques de tracing Datadog officielles suivantes :
Pour instrumenter une application écrite dans un langage qui n’est pas pris en charge par une bibliothèque officielle, consultez la liste des bibliothèques de tracing de notre communauté.
