Configuration des live containers

Si vous utilisez le chart Helm Datadog officiel :

• Utilisez au minimum la version 2.10.0 du chart. Remarque : assurez-vous que la version minimale ou une version ultérieure de l’Agent et de l’Agent de cluster est codée en dur dans le fichier values.yaml de votre chart Helm.

• Vérifiez que l’Agent de processus est activé. Pour ce faire, modifiez le fichier datadog-values.yaml afin d’inclure ce qui suit :

  datadog:
      # (...)
      processAgent:
          enabled: true
  

• Déployez une nouvelle version.

Dans certaines configurations, il arrive que l’Agent de processus et l’Agent de cluster ne parviennent pas à détecter automatiquement un nom de cluster Kubernetes. Lorsque c’est le cas, la fonctionnalité ne démarre pas et l’avertissement suivant s’affiche dans le log de l’Agent de cluster : Orchestrator explorer enabled but no cluster name set: disabling. Vous devez alors définir datadog.clusterName sur le nom de votre cluster dans values.yaml.

La version 1.11.0 ou une version ultérieure de l’Agent de cluster est requise pour commencer la configuration du DaemonSet. L’Agent de cluster doit être en cours d’exécution et l’Agent doit pouvoir communiquer avec celui-ci. Consultez la section Configuration de l’Agent de cluster pour en savoir plus.

1. Définissez le conteneur de l’Agent de cluster à l’aide de la variable d’environnement suivante :

     - name: DD_ORCHESTRATOR_EXPLORER_ENABLED
       value: "true"
   

2. Définissez le ClusterRole de l’Agent de cluster à l’aide des autorisations RBAC suivantes.

   Notez bien que pour les apiGroups apps et batch, les live containers ont besoin d’autorisations pour recueillir des ressources Kubernetes de base (pods, services, nodes, etc.). Elles devraient déjà se trouver dans le RBAC si vous avez suivi la documentation relative à la configuration de l’Agent de cluster. Si elles sont absentes, prenez soin de les ajouter (après deployments, replicasets) :

     ClusterRole:
     - apiGroups:  # To create the datadog-cluster-id ConfigMap
       - ""
       resources:
       - configmaps
       verbs:
       - create
       - get
       - update
     ...
     - apiGroups:  # Required to get the kube-system namespace UID and generate a cluster ID
       - ""
       resources:
       - namespaces
       verbs:
       - get
     ...
     - apiGroups:  # To collect new resource types
       - "apps"
       resources:
       - deployments
       - replicasets
       verbs:
       - list
       - get
       - watch
     - apiGroups:
       - "batch"
       resources:
       - cronjobs
       - jobs
       verbs:
       - list
       - get
       - watch
     ...
   

   Ces autorisations sont requises pour créer une ConfigMap datadog-cluster-id dans le même espace de nommage que le DaemonSet de l’Agent et le déploiement de l’Agent de cluster, mais également pour recueillir les ressources Kubernetes prises en charge.

   Si la ConfigMap cluster-id n’est pas créée par l’Agent de cluster, le pod de l’Agent ne peut pas recueillir de ressources. Pour y remédier, modifiez les autorisations de l’Agent de cluster et redémarrez son pod afin qu’il puisse créer la ConfigMap, puis redémarrez le pod de l’Agent.

3. L’Agent de processus, qui s’exécute dans le DaemonSet de l’Agent, doit être activé et en cours d’exécution. La collecte de processus ne doit pas forcément être en cours. Les options suivantes doivent également être configurées :

   - name: DD_ORCHESTRATOR_EXPLORER_ENABLED
     value: "true"
   

Dans certaines configurations, il arrive que l’Agent de processus et l’Agent de cluster ne parviennent pas à détecter automatiquement un nom de cluster Kubernetes. Lorsque c’est le cas, la fonctionnalité ne démarre pas et l’avertissement suivant s’affiche dans le log de l’Agent de cluster : Orchestrator explorer enabled but no cluster name set: disabling. Vous devez alors définir ajouter les options suivantes dans la section env de l’Agent de cluster et de l’Agent de processus :

- name: DD_CLUSTER_NAME
  value: "<NOM_CLUSTER>"

Si vous utilisez le chart Helm Datadog officiel :

• Utilisez une version du chart ultérieure à 2.10.0 et antérieure à 2.4.5. SI vous utilisez la version 2.10.0 ou une version ultérieure, consultez plutôt les dernières instructions de configuration. Remarque : assurez-vous que les versions de l’Agent et de l’Agent de cluster sont codées en dur, avec les versions minimales requises, dans le fichier values.yaml de votre chart Helm.
• Définissez datadog.orchestratorExplorer.enabled sur true dans values.yaml.
• Déployez une nouvelle version.

Dans certaines configurations, il arrive que l’Agent de processus et l’Agent de cluster ne parviennent pas à détecter automatiquement un nom de cluster Kubernetes. Lorsque c’est le cas, la fonctionnalité ne démarre pas et l’avertissement suivant s’affiche dans le log de l’Agent de cluster : Orchestrator explorer enabled but no cluster name set: disabling. Vous devez alors définir datadog.clusterName sur le nom de votre cluster dans values.yaml.

L’Agent de cluster doit être en cours d’exécution et l’Agent doit pouvoir communiquer avec celui-ci. Consultez la section Configuration de l’Agent de cluster pour en savoir plus.

1. Définissez le conteneur de l’Agent de cluster à l’aide de la variable d’environnement suivante :

     - name: DD_ORCHESTRATOR_EXPLORER_ENABLED
       value: "true"
   

2. Définissez le ClusterRole de l’Agent de cluster à l’aide des autorisations RBAC suivantes.

   Remarque : pour les apiGroups apps, les live containers ont besoin d’autorisations pour recueillir des ressources Kubernetes de base (pods, services, nodes, etc.). Elles devraient déjà se trouver dans le RBAC si vous avez suivi la documentation relative à la configuration de l’Agent de cluster. Si elles sont absentes, prenez soin de les ajouter (après deployments, replicasets) :

     ClusterRole:
     - apiGroups:  # To create the datadog-cluster-id ConfigMap
       - ""
       resources:
       - configmaps
       verbs:
       - create
       - get
       - update
     ...
     - apiGroups:  # Required to get the kube-system namespace UID and generate a cluster ID
       - ""
       resources:
       - namespaces
       verbs:
       - get
     ...
     - apiGroups:  # To collect new resource types
       - "apps"
       resources:
       - deployments
       - replicasets
       - daemonsets
       - statefulsets
       verbs:
       - list
       - get
       - watch
   

   Ces autorisations sont requises pour créer une ConfigMap datadog-cluster-id dans le même espace de nommage que le DaemonSet de l’Agent et le déploiement de l’Agent de cluster, mais également pour recueillir les déploiements et les ReplicaSets.

   Si la ConfigMap cluster-id n’est pas créée par l’Agent de cluster, le pod de l’Agent n’est pas initié et génère le statut CreateContainerConfigError. Si le pod de l’Agent est bloqué par l’absence de la ConfigMap, modifiez les autorisations de l’Agent de cluster et redémarrez ses pods pour permettre la création de la ConfigMap. Le pod de l’Agent récupérera automatiquement un statut normal.

3. L’Agent de processus, qui s’exécute dans le DaemonSet de l’Agent, doit être activé et en cours d’exécution. La collecte de processus ne doit pas forcément être en cours. Les options suivantes doivent également être configurées :

   - name: DD_ORCHESTRATOR_EXPLORER_ENABLED
     value: "true"
   - name: DD_ORCHESTRATOR_CLUSTER_ID
     valueFrom:
       configMapKeyRef:
         name: datadog-cluster-id
         key: id
   

Dans certaines configurations, il arrive que l’Agent de processus et l’Agent de cluster ne parviennent pas à détecter automatiquement un nom de cluster Kubernetes. Lorsque c’est le cas, la fonctionnalité ne démarre pas et l’avertissement suivant s’affiche dans le log de l’Agent de cluster : Orchestrator explorer enabled but no cluster name set: disabling. Vous devez alors définir ajouter les options suivantes dans la section env de l’Agent de cluster et de l’Agent de processus :

- name: DD_CLUSTER_NAME
  value: "<NOM_CLUSTER>"

SI vous utilisez le chart Helm officiel, ajoutez la variable d’environnement à l’Agent de processus et à l’Agent de cluster en définissant respectivement agents.containers.processAgent.env et clusterAgent.env dans values.yaml.

  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"

Déployez ensuite une nouvelle version.

Définissez la variable d’environnement sur les conteneurs de l’Agent de processus et de l’Agent de cluster :

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