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_VERSION> datadog/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 de trace datadog.yaml :

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

   Mettez à jour votre manifeste datadog-agent.yaml comme suit :

   agent:
     image:
       name: "datadog/agent:latest"
     apm:
       enabled: true
   

   Consultez l'exemple de manifeste avec activation de l’APM et de la collecte des métriques pour un exemple complet.

   Ensuite, appliquez la nouvelle configuration :

   $ kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml
   

   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:

• automatiquement à l’aide du contrôleur d’admission Datadog ;

• manuellement en utilisant l’API Downward pour récupérer l’IP du host. Le conteneur de l’application requiert la variable d’environnement DD_AGENT_HOST pointant 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’environnement disponibles pour le tracing lorsque l’Agent est exécuté dans Kubernetes :

Variables d’environnement d’opérateur

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