Configuration des live containers

Ressources Kubernetes

L’Agent Datadog et l’Agent de cluster peuvent être configurés afin de récupérer des ressources Kubernetes pour des [live containers][1]. Une telle configuration vous permet de surveiller l’état de vos pods, déploiements et autres entités Kubernetes dans un espace de nommage ou une zone de disponibilité spécifique. Cela vous permet également de consulter les spécifications de ressources pour les échecs de pods d’un déploiement ou encore de mettre en corrélation l’activité d’un nœud avec les logs associés.

La récupération des ressources Kubernetes pour les live containers requiert au minimum la version 7.27.0 de l’Agent et la version 1.11.0 de l’Agent de cluster. Pour les versions antérieures de l’Agent Datadog et de l’Agent de cluster, consultez la section Configuration des live containers pour les anciennes versions des Agents.

Remarque : pour Kubernetes 1.25 et les versions ultérieures, la version minimale requise de l’Agent de cluster est la 7.40.0.

- name: DD_CLUSTER_NAME
  value: "<NOM_CLUSTER>"

Matrice de compatibilité de la collecte de ressources

Le tableau suivant présente la liste des ressources recueillies et les versions minimales de l’Agent, de l’Agent de cluster et du chart Helm requises pour la collecte.

Remarque : pour Kubernetes 1.25 et les versions ultérieures, la version minimale requise de l’Agent de cluster est la 7.40.0.

Ajouter des tags personnalisés aux ressources

Vous pouvez ajouter des tags personnalisés aux ressources Kubernetes afin de faciliter le filtrage de la vue des ressources Kubernetes.

Des tags supplémentaires sont ajoutés via la variable d’environnement DD_ORCHESTRATOR_EXPLORER_EXTRA_TAGS.

Remarque : ces tags s’affichent uniquement dans la vue des ressources Kubernetes.

  agents:
    containers:
      processAgent:
        env:
          - name: "DD_ORCHESTRATOR_EXPLORER_EXTRA_TAGS"
            value: "tag1:value1 tag2:value2"
  clusterAgent:
    env:
      - name: "DD_ORCHESTRATOR_EXPLORER_EXTRA_TAGS"
        value: "tag1:value1 tag2:value2"

- name: DD_ORCHESTRATOR_EXPLORER_EXTRA_TAGS
  value: "tag1:value1 tag2:value2"

Inclure ou exclure des conteneurs

Il est possible d’inclure et/ou d’exclure des conteneurs pour la collecte en temps réel :

• Pour exclure des conteneurs, passez la variable d’environnement DD_CONTAINER_EXCLUDE ou ajoutez container_exclude: dans le fichier de configuration principal datadog.yaml.
• Pour inclure des conteneurs, passez la variable d’environnement DD_CONTAINER_INCLUDE ou ajoutez container_include: dans le fichier de configuration principal datadog.yaml.

Ces deux arguments ont pour valeur un nom d’image. Les expressions régulières sont également prises en charge.

Par exemple, pour exclure toutes les images Debian à l’exception des conteneurs dont le nom commence par frontend, ajoutez les deux lignes de configuration suivantes dans votre fichier datadog.yaml :

container_exclude: ["image:debian"]
container_include: ["name:frontend.*"]

Remarque : pour la version 5 de l’Agent, au lieu d’ajouter les lignes ci-dessus dans le fichier de configuration principal datadog.conf, ajoutez explicitement un fichier datadog.yaml dans /etc/datadog-agent/. En effet, l’Agent de processus exige que toutes les options de configuration se trouvent à cet emplacement. Cette configuration exclut uniquement les conteneurs de la collecte en temps réel, et non de la fonction Autodiscovery.

Nettoyage d’informations sensibles

Pour éviter toute fuite de données sensibles, vous pouvez nettoyer des termes sensibles dans les fichiers YAML des conteneurs. Le nettoyage de conteneur est activé par défaut pour les charts Helm. Plusieurs termes sensibles sont fournis par défaut :

• password
• passwd
• mysql_pwd
• access_token
• auth_token
• api_key
• apikey
• pwd
• secret
• credentials
• stripetoken

Vous pouvez définir des termes sensibles supplémentaires en fournissant une liste de termes via la variable d’environnement DD_ORCHESTRATOR_EXPLORER_CUSTOM_SENSITIVE_WORDS. Ces termes viennent s’ajouter aux termes par défaut et ne les écrasent pas.

Remarque : les termes sensibles supplémentaires ne doivent pas inclure de majuscules, car l’Agent compare le texte au pattern en minuscules. Cela signifie que le terme password remplace MY_PASSWORD par MY_*******, tandis que le terme PASSWORD ne nettoie aucune donnée.

Vous devez configurer cette variable d’environnement pour les Agents suivants :

• process-agent
• cluster-agent

env:
    - name: DD_ORCHESTRATOR_EXPLORER_CUSTOM_SENSITIVE_WORDS
      value: "customword1 customword2 customword3"

Par exemple, puisque password est un terme sensible, la fonctionnalité de nettoyage remplace toutes les occurrences de <MY_PASSWORD> ci-dessous par la chaîne d’astérisques *********** :

password <MY_PASSWORD>
password=<MY_PASSWORD>
password: <MY_PASSWORD>
password::::== <MY_PASSWORD>

Les chemins contenant des termes sensibles ne sont toutefois pas modifiés. Par exemple, le chemin /etc/vaultd/secret/haproxy-crt.pem n’est pas remplacé par /etc/vaultd/******/haproxy-crt.pem, même si secret est un terme sensible.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Visualisez tous vos hosts sur un seul écran avec la hostmapDOCUMENTATION Découvrir ce qui se passe à tous les niveaux de votre systèmeDOCUMENTATION