Activez l’Agent de trace dans le conteneur gcr.io/datadoghq/agent en transmettant DD_APM_ENABLED=true en tant que variable d’environnement.
Ajoutez l’option -p 127.0.0.1:8126:8126/tcp à la commande docker run pour bénéficier du tracing sur le port 8126/tcp depuis votre host uniquement.
Pour profiter du tracing depuis tous les hosts, utilisez plutôt la commande -p 8126:8126/tcp.
Par exemple, la commande suivante permet à l’Agent de recevoir des traces depuis votre host uniquement :
docker run -d -v /var/run/docker.sock:/var/run/docker.sock:ro \
-v /proc/:/host/proc/:ro \
-v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
-p 127.0.0.1:8126:8126/tcp \
-e DD_API_KEY="<CLÉ_API_DATADOG>" \
-e DD_APM_ENABLED=true \
gcr.io/datadoghq/agent:latest
docker run -d -p 127.0.0.1:8126:8126/tcp \
-e DD_API_KEY="<CLÉ_API_DATADOG>" \
-e DD_APM_ENABLED=true \
gcr.io/datadoghq/agent:latest
Voici la liste de l’ensemble des variables d’environnements pour le tracing au sein de l’Agent Docker :
| Variable d’environnement | Description |
|---|---|
DD_API_KEY | Clé d’API Datadog |
DD_PROXY_HTTPS | Configure l’URL utilisée par le proxy. |
DD_APM_REPLACE_TAGS | Nettoyer les données sensibles des tags de vos spans. |
DD_HOSTNAME | Définit manuellement le hostname à utiliser pour les métriques si la détection automatique échoue, ou lors de l’exécution de l’Agent de cluster Datadog. |
DD_DOGSTATSD_PORT | Définit le port DogStatsD. |
DD_APM_RECEIVER_SOCKET | Recueillez vos traces via un socket de domaine Unix afin de ne pas tenir compte du port et du hostname configurés, le cas échéant. Cette variable est désactivée par défaut. Si vous l’activez, vous devez indiquer un fichier de socket valide. |
DD_BIND_HOST | Définit le hostname StatsD et le hostname du récepteur. |
DD_LOG_LEVEL | Définit le niveau de journalisation (trace, debug, info, warn, error, critical ou off). |
DD_APM_ENABLED | Lorsque ce paramètre est défini sur true, l’Agent Datadog accepte les métriques de trace. |
DD_APM_CONNECTION_LIMIT | Définit la limite maximale de connexions sur un intervalle de 30 secondes. La limite par défaut est de 2 000 connexions. |
DD_APM_DD_URL | Définissez le endpoint de l’API Datadog sur l’adresse vers laquelle vos traces sont envoyées : https://trace.agent.. Valeur par défaut : https://trace.agent.datadoghq.com. |
DD_APM_RECEIVER_PORT | Port sur lequel le récepteur de traces de l’Agent Datadog effectue son écoute. Valeur par défaut : 8126. |
DD_APM_NON_LOCAL_TRAFFIC | Autorise le trafic non local pour le tracing depuis d’autres conteneurs. |
DD_APM_IGNORE_RESOURCES | Configurer les ressources que l’Agent doit ignorer. Utilisez des expressions régulières séparées par des virgules, par exemple : GET /ignore-me,(GET|POST) /and-also-me. |
DD_APM_ANALYZED_SPANS | Configurez les spans à analyser pour les transactions. Utilisez des instances de <NOM_SERVICE>|;<NOM_OPÉRATION>=1 séparées par des virgules, par exemple : my-express-app|;express.request=1,my-dotnet-app|;aspnet_core_mvc.request=1. Vous pouvez également l’activer automatiquement à l’aide du paramètre de configuration dans le client de tracing. |
DD_APM_MAX_EPS | Définit le nombre maximum de spans indexées par seconde. La valeur par défaut est de 200 événements par seconde. |
DD_APM_MAX_TPS | Définit le nombre maximum de traces par seconde. La valeur par défaut est de 10 traces par seconde. |
Comme pour DogStatsD, les traces peuvent être envoyées à l’Agent depuis d’autres conteneurs via les réseaux Docker ou l'IP de host Docker.
Commencez par créer un pont défini par l’utilisateur :
docker network create <NOM_RÉSEAU>
Démarrez ensuite l’Agent et le conteneur de l’application, connectés au réseau précédemment créé :
# Agent Datadog
docker run -d --name datadog-agent \
--network <NOM_RÉSEAU> \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
-v /proc/:/host/proc/:ro \
-v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
-e DD_API_KEY="<CLÉ_API_DATADOG>" \
-e DD_APM_ENABLED=true \
-e DD_APM_NON_LOCAL_TRAFFIC=true \
gcr.io/datadoghq/agent:latest
# Application
docker run -d --name app \
--network <NOM_RÉSEAU> \
company/app:latest
# Agent Datadog
docker run -d --name datadog-agent \
--network "<NOM_RÉSEAU>" \
-e DD_API_KEY="<CLÉ_API_DATADOG>" \
-e DD_APM_ENABLED=true \
-e DD_APM_NON_LOCAL_TRAFFIC=true \
gcr.io/datadoghq/agent:latest
# Application
docker run -d --name app \
--network "<NOM_RÉSEAU>" \
company/app:latest
Cela expose le hostname datadog-agent dans votre conteneur app.
Si vous utilisez docker-compose, les paramètres <NOM_RÉSEAU> correspondent aux paramètres définis dans la section networks de votre fichier docker-compose.yml.
Vos traceurs d’application doivent être configurés afin d’envoyer des traces à cette adresse. Définissez les variables d’environnement en indiquant le DD_AGENT_HOST en tant que nom de conteneur de l’Agent et le DD_TRACE_AGENT_PORT en tant port des traces de l’Agent dans vos conteneurs d’application. Dans cet exemple, il s’agit respectivement de datadog-agent et de 8126.
Vous pouvez également consulter les exemples ci-dessous pour définir manuellement le host de l’Agent dans chaque langage pris en charge.
Mettez à jour la configuration de l’Agent Java avec des variables d’environnement…
DD_AGENT_HOST=datadog-agent \
DD_TRACE_AGENT_PORT=8126 \
java -javaagent:/chemin/vers/l/agent-java-dd.jar -jar /votre/app.jar
… ou avec des propriétés système :
java -javaagent:/chemin/vers/l/agent-java-dd.jar \
-Ddd.agent.host=datadog-agent \
-Ddd.agent.port=8126 \
-jar /votre/app.jar
from ddtrace import tracer
tracer.configure(
hostname='datadog-agent',
port=8126,
)
Datadog.configure do |c|
c.tracer hostname: 'datadog-agent',
port: 8126
end
package main
import "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
func main() {
tracer.Start(tracer.WithAgentAddr("datadog-agent:8126"))
defer tracer.Stop()
}
const tracer = require('dd-trace').init({
hostname: 'datadog-agent',
port: 8126
});
Définissez les variables d’environnement avant le lancement de votre application instrumentée :
# Variables d'environnement
export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
export CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
export DD_INTEGRATIONS=/opt/datadog/integrations.json
export DD_DOTNET_TRACER_HOME=/opt/datadog
# Pour les conteneurs
export DD_AGENT_HOST=datadog-agent
export DD_TRACE_AGENT_PORT=8126
# Démarrer votre application
dotnet example.dll
Le port de conteneur de l’Agent 8126 doit être associé directement au host.
Configurez votre traceur d’application afin d’indiquer l’itinéraire par défaut de ce conteneur (utilisez la commande ip route).
L’exemple suivant est basé sur le traceur Python et part du principe que 172.17.0.1 est votre itinéraire par défaut :
from ddtrace import tracer
tracer.configure(hostname='172.17.0.1', port=8126)
Documentation, liens et articles supplémentaires utiles:
