Aperçu

Cette page fournit des instructions pour installer l’Agent Datadog dans un environnement Kubernetes.

Pour parcourir la documentation dédiée aux principales distributions Kubernetes, y compris AWS Elastic Kubernetes Service (EKS), Azure Kubernetes Service (AKS), Google Kubernetes Engine (GKE), Red Hat OpenShift, Rancher et Oracle Container Engine pour Kubernetes (OKE) et découvrir des exemples, référez-vous à la section Distributions Kubernetes.

Pour parcourir la documentation dédiée à la surveillance du plan de contrôle Kubernetes ainsi que des exemples, consultez la section Surveillance du plan de contrôle Kubernetes.

Versions minimales de Kubernetes et de l’Agent Datadog

Pour utiliser certaines fonctionnalités des versions récentes de Kubernetes, vous devez exécuter des versions minimales de l’Agent Datadog et de l’Agent de cluster.

Pour une compatibilité optimale, Datadog recommande de maintenir votre Cluster Agent et votre Agent sur des versions identiques.

Installation

Aidez-vous de la page Installation sur Kubernetes dans Datadog pour vous guider tout au long du processus d’installation.

1. Sélectionnez la méthode d’installation

   Choisissez l’une des méthodes d’installation suivantes :

   • Opérateur Datadog (recommandé) : un opérateur Kubernetes que vous pouvez utiliser pour déployer l’Agent Datadog sur Kubernetes et OpenShift. Il rapporte l’état de déploiement, la santé et les erreurs dans son statut de Ressource Personnalisée, et il limite le risque de mauvaise configuration grâce à des options de configuration de niveau supérieur.
   • Helm
   • Installation manuelle. Voir Installer et configurer manuellement l’Agent Datadog avec un DaemonSet

5. Confirmez l’installation de l’Agent

   Vérifiez que les pods de l’Agent (étiquetés avec app.kubernetes.io/component:agent) apparaissent sur la page Conteneurs dans Datadog. Les pods de l’Agent sont détectés dans les quelques minutes suivant le déploiement.

Installation non privilégiée

Pour exécuter une installation non privilégiée, ajoutez ce qui suit securityContext à votre configuration par rapport à votre <USER_ID> et <GROUP ID> souhaités:

• Remplacez <USER_ID> par l’UID pour exécuter l’Agent Datadog. Datadog recommande de définir cette valeur sur 100 pour l’utilisateur dd-agent préexistant pour l’Agent Datadog v7.48+.
• Remplacez <GROUP_ID> par l’ID de groupe qui possède le socket Docker ou containerd.

Cela définit le securityContext au niveau du pod pour l’Agent.

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    clusterName: <CLUSTER_NAME>
    site: <DATADOG_SITE>
    credentials:
      apiSecret:
        secretName: datadog-secret
        keyName: api-key

  override:
    nodeAgent:
      securityContext:
        runAsUser:  <USER_ID>
        supplementalGroups:
          - <GROUP_ID>

kubectl apply -f datadog-agent.yaml

datadog:
  apiKeyExistingSecret: datadog-secret
  clusterName: <CLUSTER_NAME>
  site: <DATADOG_SITE>
  securityContext:
    runAsUser: <USER_ID>
    supplementalGroups:
      - <GROUP_ID>

helm install datadog-agent -f datadog-values.yaml datadog/datadog

Registres de conteneurs

Datadog publie des images de conteneurs dans le Registre de Conteneurs Datadog, Google Artifact Registry (GAR), Amazon ECR, Azure ACR et Docker Hub:

Par défaut, le graphique Helm de l’Agent Datadog détermine le registre d’images de l’Agent à partir de votre site Datadog, du type de cluster et de registryMigrationMode. En fonction de ces valeurs et des exclusions d’environnement, les images de l’Agent peuvent être tirées du Registre de Conteneurs Datadog (registry.datadoghq.com) ou d’un registre spécifique au site. Le graphique Datadog Operator est inclus par défaut comme dépendance du graphique Helm de l’Agent Datadog. Depuis la version 2.19.0 du graphique Datadog Operator, lorsque vous installez l’Operator via cette dépendance, le registryMigrationMode du graphique Helm de l’Agent Datadog s’applique aux images de l’Agent gérées par l’Operator. Le chart Helm de l’Operator lui-même ne définit pas registryMigrationMode ; l’image du pod de l’Operator est contrôlée séparément par la valeur image.repository du chart de l’Operator.

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    clusterName: <CLUSTER_NAME>
    registry: public.ecr.aws/datadog
    site: <DATADOG_SITE>
    credentials:
      apiSecret:
        secretName: datadog-secret
        keyName: api-key

registry: public.ecr.aws/datadog
datadog:
  apiKeyExistingSecret: datadog-secret
  site: <DATADOG_SITE>

Pour plus d’informations, voir Changer votre registre de conteneurs.

Désinstaller

kubectl delete datadogagent datadog
helm delete datadog-operator

helm uninstall datadog-agent

Étapes suivantes

Surveillez votre infrastructure dans Datadog

Utilisez la page Conteneurs pour avoir une visibilité sur votre infrastructure de conteneurs, avec des métriques de ressources et une recherche facettée. Pour des informations sur l’utilisation de la page Conteneurs, voir Vue des Conteneurs.

Utilisez la page Images de Conteneurs pour obtenir des informations sur chaque image utilisée dans votre environnement. Cette page affiche également les vulnérabilités trouvées dans vos images de conteneurs provenant de Sécurité Cloud. Pour des informations sur l’utilisation de la page Images de Conteneurs, voir la Vue des Images de Conteneurs.

La section Kubernetes présente un aperçu de toutes vos ressources Kubernetes. Orchestrator Explorer vous permet de surveiller l’état des pods, des déploiements et d’autres concepts Kubernetes dans un espace de noms ou une zone de disponibilité spécifique, de consulter les spécifications des ressources pour les pods échoués dans un déploiement, de corréler l’activité des nœuds avec les journaux associés, et plus encore. La page Resource Utilization fournit des informations sur la manière dont vos charges de travail Kubernetes utilisent vos ressources informatiques à travers votre infrastructure. Pour des informations sur l’utilisation de ces pages, consultez Orchestrator Explorer et Kubernetes Resource Utilization.

Activer les fonctionnalités

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Configuration avancée de l'Agent Datadog sur KubernertesDOCUMENTATION Chart Helm Datadog - Toutes les options de configurationCODE SOURCE Mise à niveau du chart Helm DatadogCODE SOURCE