TP : Installer l'agent Datadog et activer une intégration avec correction

Ce que vous allez apprendre dans ce TP

• Installer l'agent
• Vérifier la collecte
• Activer une intégration par autodiscovery

Introduction #

Ce que vous allez apprendre dans cette section

• Installer l'agent
• Vérifier la collecte
• Activer une intégration par autodiscovery

Contexte. Votre équipe évalue Datadog. Vous installez l'agent sur un serveur de test et branchez un premier service.

Prérequis : Compte Datadog (essai gratuit de 14 jours), Docker  ·  Durée estimée : 35 min

Un hôte et un service visibles dans Datadog.

Mise en place #

Étapes guidées, avec leur correction.

1. 1. Préparer les clés

   Pourquoi ? La clé d'API autorise l'envoi des données ; le site doit correspondre à celui du compte.

   Créez un compte d'essai (site UE), puis récupérez une clé d'API (Organization Settings > API Keys).
   Voir la correction

   export DD_API_KEY=<cle_api>
   export DD_SITE=datadoghq.eu

2. 2. Lancer l'agent

   Pourquoi ? L'agent en conteneur voit les autres conteneurs via le socket Docker.

   Lancez l'agent avec la collecte de logs et l'APM activées.
   Voir la correction

   docker network create dd 2>/dev/null
   docker run -d --name dd-agent --network dd -e DD_API_KEY -e DD_SITE \
     -e DD_LOGS_ENABLED=true -e DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true \
     -e DD_APM_ENABLED=true -e DD_APM_NON_LOCAL_TRAFFIC=true -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC=true \
     -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 8125:8125/udp -p 8126:8126 gcr.io/datadoghq/agent:7

3. 3. Vérifier

   Pourquoi ? La commande status est le premier outil de diagnostic.

   Vérifiez l'état de l'agent, puis retrouvez l'hôte dans Infrastructure > Host Map.
   Voir la correction

   docker exec dd-agent agent status | grep -A3 -E 'API Keys|Forwarder|Logs Agent'

4. 4. Activer l'intégration Nginx

   Pourquoi ? L'autodiscovery applique la configuration au conteneur, sans fichier sur l'hôte.

   Lancez un Nginx avec la page de statut et les labels d'autodiscovery.
   Voir la correction

   cat > status.conf <<'EOF'
   server { listen 81; location /nginx_status { stub_status; } }
   EOF
   docker run -d --name front --network dd -v $PWD/status.conf:/etc/nginx/conf.d/status.conf \
     -l com.datadoghq.ad.checks='{"nginx": {"instances": [{"nginx_status_url": "http://%%host%%:81/nginx_status"}]}}' \
     -l com.datadoghq.ad.logs='[{"source": "nginx", "service": "front"}]' \
     -l com.datadoghq.tags.env=lab -l com.datadoghq.tags.service=front nginx:alpine
   sleep 30 && docker exec dd-agent agent status | grep -A6 'nginx ('

5. 5. Explorer

   Pourquoi ? Le dashboard d'intégration est créé automatiquement.

   Générez un peu de trafic et ouvrez le dashboard NGINX - Overview et les logs du service front.
   Voir la correction

   docker run --rm --network dd curlimages/curl sh -c 'for i in $(seq 200); do curl -s front >/dev/null; done'

Niveau de difficulté : ●●○○○ (2/5)