Aperçu

Le contrôleur d’admission Datadog est un composant de l’Agent de cluster Datadog. Le principal avantage du contrôleur d’admission est de simplifier la configuration de vos pods d’application. Pour cela, il dispose de deux fonctionnalités principales :

• Injectez des variables d’environnement (DD_AGENT_HOST, DD_TRACE_AGENT_URL, DD_ENTITY_ID et DD_EXTERNAL_ENV) pour configurer DogStatsD et les SDK Datadog dans les conteneurs d’application de l’utilisateur.
• Injectez les balises standard Datadog (env, service, version) à partir des étiquettes d’application dans les variables d’environnement du conteneur.

Le contrôleur d’admission de Datadog est de type MutatingAdmissionWebhook. Pour plus de détails sur les contrôleurs d’admission, consultez le guide Kubernetes sur les contrôleurs d’admission.

Exigences

• Agent de cluster Datadog v7.40+

Configuration

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  #(...)
  features:
    admissionController:
      enabled: true
      mutateUnlabelled: false

#(...)
clusterAgent:
  #(...)
  ## @param admissionController - object - required
  ## Enable the admissionController to automatically inject APM and
  ## DogStatsD config and standard tags (env, service, version) into
  ## your pods
  #
  admissionController:
    enabled: true

    ## @param mutateUnlabelled - boolean - optional
    ## Enable injecting config without having the pod label:
    ## admission.datadoghq.com/enabled="true"
    #
    mutateUnlabelled: false

- apiGroups:
  - admissionregistration.k8s.io
  resources:
  - mutatingwebhookconfigurations
  verbs: ["get", "list", "watch", "update", "create"]
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["get", "list", "watch", "update", "create"]
- apiGroups: ["batch"]
  resources: ["jobs", "cronjobs"]
  verbs: ["get"]
- apiGroups: ["apps"]
  resources: ["statefulsets", "replicasets", "deployments"]
  verbs: ["get"]

apiVersion: v1
kind: Service
metadata:
  name: datadog-cluster-agent-admission-controller
  labels:
    app: "datadog"
    app.kubernetes.io/name: "datadog"
spec:
  selector:
    app: datadog-cluster-agent
  ports:
  - port: 443
    targetPort: 8000

- name: DD_ADMISSION_CONTROLLER_ENABLED
  value: "true"
- name: DD_ADMISSION_CONTROLLER_SERVICE_NAME
  value: "datadog-cluster-agent-admission-controller"

# Uncomment this to configure Datadog SDKs automatically (see below)
# - name: DD_ADMISSION_CONTROLLER_MUTATE_UNLABELLED
#   value: "true"

Injection de bibliothèque d’instrumentation APM

Vous pouvez configurer l’Agent de Cluster (version 7.39 et supérieure) pour injecter des bibliothèques d’instrumentation en utilisant l’instrumentation par étape unique. Consultez l’instrumentation APM par étape unique pour plus d’informations.

Si vous ne souhaitez pas utiliser l’instrumentation par étape unique, le contrôleur d’admission Datadog peut être utilisé pour injecter directement les SDK Datadog comme alternative manuelle au niveau des pods. Consultez l’injection de SDK local pour plus d’informations.

Injection de variables d’environnement APM et DogStatsD

Pour configurer les clients DogStatsD ou d’autres bibliothèques APM qui ne prennent pas en charge l’injection de bibliothèque, injectez les variables d’environnement DD_AGENT_HOST et DD_ENTITY_ID en procédant comme suit :

• Ajoutez l’étiquette admission.datadoghq.com/enabled: "true" à votre Pod.
• Configurez le contrôleur d’admission de l’Agent de Cluster en définissant mutateUnlabelled (ou DD_ADMISSION_CONTROLLER_MUTATE_UNLABELLED, selon votre méthode de configuration) sur true.

Ajouter une configuration d’Agent mutateUnlabelled: true dans le chart Helm amène l’Agent de Cluster à tenter d’intercepter chaque Pod non étiqueté.

Pour empêcher les Pods de recevoir des variables d’environnement, ajoutez l’étiquette admission.datadoghq.com/enabled: "false". Cela fonctionne même si vous définissez mutateUnlabelled: true.

Si mutateUnlabelled est défini sur false, l’étiquette du Pod doit être définie sur admission.datadoghq.com/enabled: "true".

Options possibles :

Ordre de priorité

Le contrôleur d’admission Datadog n’injecte pas les variables d’environnement DD_VERSION, DD_ENV ou DD_SERVICE si elles existent déjà.

Lorsque ces variables d’environnement ne sont pas définies, le contrôleur d’admission utilise la valeur des balises standard dans l’ordre suivant (de la plus élevée à la plus basse) :

• Étiquettes sur le Pod
• Étiquettes sur le ownerReference (ReplicaSets, DaemonSets, Deployments, etc.)

Configurer le mode de communication APM et DogstatsD

Depuis la version 1.20.0 de l’Agent de cluster Datadog, il est possible de configurer le contrôleur d’admission Datadog afin d’injecter différents modes de communication entre l’application et l’Agent Datadog.

Cette fonctionnalité peut être configurée en définissant admission_controller.inject_config.mode ou en définissant un mode spécifique au Pod en utilisant l’étiquette de Pod admission.datadoghq.com/config.mode.

À partir de la version 3.22.0 du chart Helm et de la version 1.1.0 de Datadog Operator, le mode de communication est automatiquement défini sur socket si soit le socket APM soit le socket DSD est activé.

Options possibles :

Remarque : Le mode spécifique au pod a la priorité sur le mode global défini au niveau du contrôleur d’admission.

Dépannage

Voir Dépannage du contrôleur d’admission.

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Dépannage de l'Agent de cluster DatadogDOCUMENTATION Dépannage du contrôleur d'admissionDOCUMENTATION Utilisez l'injection de bibliothèque pour auto-instrumenter le traçage des applications Kubernetes avec Datadog APMBLOG Apportez une observabilité haute performance aux environnements Kubernetes sécurisés avec le pilote CSI de DatadogBLOG Instrumentez votre application à l'aide de l'opérateur Datadog et du contrôleur d'admissionCENTRE D'ARCHITECTURE Désactivez le contrôleur d'admission Datadog avec l'Agent de cluster.DOCUMENTATION