Collecte de traces Kubernetes

Pour commencer à recueillir les traces de votre application, vous devez exécuter l’Agent Datadog dans votre cluster Kubernetes.

Configuration

Pour activer la collecte de traces avec l’Agent, suivez les instructions ci-dessous :

1. Configurez l’Agent Datadog pour qu’il accepte les traces :

   • Dropdown

   • Si vous ne l’avez pas déjà fait, installez le chart Helm.

   • Mettez à jour votre fichier values.yaml avec la configuration d’APM suivante :

     datadog:
       ## @param apm - object - required
       ## Enable apm agent and provide custom configs
       #
       apm:
         ## @param enabled - boolean - optional - default: false
         ## Enable this to enable APM and tracing, on port 8126
         #
         enabled: true

     • Définissez votre système d’exploitation. Indiquez targetSystem: linux ou targetSystem: windows en haut de votre fichier values.yaml.

     • Ensuite, mettez à jour votre chart Helm Datadog à l’aide de la commande suivante : helm upgrade -f values.yaml <NOM DE VERSION> stable/datadog. N’oubliez pas de définir la clé d’API dans le fichier YAML. Si vous n’avez pas défini votre système d’exploitation dans values.yaml, ajoutez --set targetSystem=linux ou --set targetSystem=windows à cette commande.

   Pour activer la collecte de traces APM, ouvre le fichier de configuration DaemonSet et modifiez les éléments suivants :

   • Autorisez la réception de données sur le port 8126 (transmission du trafic du host à l’Agent) :

      # (...)
           ports:
             # (...)
             - containerPort: 8126
               hostPort: 8126
               name: traceport
               protocol: TCP
      # (...)

   • Si vous utilisez une ancienne version de l’Agent (7.17 ou antérieure), en plus des étapes ci-dessus, vous devez définir les variables DD_APM_NON_LOCAL_TRAFFIC et DD_APM_ENABLED sur true dans la section env du manifeste de l’Agent datadog.yaml :

      # (...)
           env:
             # (...)
             - name: DD_APM_ENABLED
               value: 'true'
             - name: DD_APM_NON_LOCAL_TRAFFIC
               value: "true"
      # (...)

   Remarque : si vous utilisez Minikube, vous recevrez peut-être l’erreur Unable to detect the kubelet URL automatically. Dans ce cas, définissez DD_KUBELET_TLS_VERIFY=false.

2. Configurez les pods de votre application pour qu’ils récupèrent l’IP du host afin de communiquer avec l’Agent Datadog : utilisez l’API Downward pour récupérer l’IP du host. Le conteneur de l’application requiert la variable d’environnement DD_AGENT_HOST qui pointe vers status.hostIP.

       apiVersion: apps/v1
       kind: Deployment
        # ...
           spec:
             containers:
             - name: "<CONTAINER_NAME>"
               image: "<CONTAINER_IMAGE>"/"<TAG>"
               env:
                 - name: DD_AGENT_HOST
                   valueFrom:
                     fieldRef:
                       fieldPath: status.hostIP

3. Configurez vos traceurs d’application pour qu’ils envoient des traces : indiquez aux traceurs d’application l’emplacement où le host de l’Agent Datadog utilise la variable d’environnement DD_AGENT_HOST. Consultez la documentation sur l’APM propre à votre langage pour obtenir davantage d’exemples.

Variables d’environnement de l’Agent

Remarque : Datadog vous conseille d’utiliser le tagging de service unifié lorsque vous assignez des tags. Le tagging de service unifié permet de lier les données de télémétrie Datadog entre elles via trois tags standards : env, service et version. Pour découvrir comment configurer le tagging unifié pour votre environnement, consultez la documentation dédiée au tagging de service unifié.

Voici la liste de l’ensemble des variables d’environnements pour le tracing au sein de l’Agent lors de l’exécution dans Kubernetes :

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Recueillir les logs de votre applicationDOCUMENTATION Recueillir vos métriques PrometheusDOCUMENTATION Recueillir automatiquement les métriques et les logs de vos applicationsDOCUMENTATION Limiter la collecte de données à un sous-ensemble de conteneursDOCUMENTATION Attribuer des tags à toutes les données envoyées par un conteneurDOCUMENTATION