Tracer des applications Docker

Activez l’Agent de trace dans le conteneur datadog/agent en transmettant DD_APM_ENABLED=true en tant que variable d’environnement.

Tracing depuis le host

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=<VOTRE_CLÉ_API> \
              -e DD_APM_ENABLED=true \
              datadog/agent:latest

Variables d’environnement de l’Agent APM Docker

Voici la liste de l’ensemble des variables d’environnements pour le tracing au sein de l’Agent Docker :

Tracing depuis d’autres conteneurs

Comme pour DogStatsD, les traces peuvent être envoyées à l’Agent depuis d’autres conteneurs, que ce soit à l’aide des réseaux Docker ou de l’[IP de host Docker)(#ip-de-host).

Réseau 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=<VOTRE_CLÉ_API> \
              -e DD_APM_ENABLED=true \
              -e DD_APM_NON_LOCAL_TRAFFIC=true \
              datadog/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.

DD_AGENT_HOST=datadog-agent \
DD_TRACE_AGENT_PORT=8126 \
java -javaagent:/chemin/vers/l/agent-java-dd.jar -jar /votre/app.jar

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
})

IP de host Datadog

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)

Pour aller plus loin