Présentation

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.

Voir aussi : Versions minimales de Kubernetes et de l’Agent de cluster.

Installation

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

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

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

   • Datadog Operator (recommandé) : un operator Kubernetes que vous pouvez utiliser pour déployer l’Agent Datadog sur Kubernetes et OpenShift. Il indique l’état du déploiement, la santé et les erreurs dans le statut de sa Custom Resource, et réduit le risque de mauvaise configuration grâce à des options de configuration de plus haut niveau.
   • Helm
   • Installation manuelle. Consultez la rubrique Manually install and configure the Datadog Agent with a DaemonSet (en anglais)

5. Confirm Agent installation

   Verify that Agent pods (tagged with app.kubernetes.io/component:agent) appear on the Containers page in Datadog. Agent pods are detected within a few minutes of deployment.

Unprivileged installation

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
agent:
  config:
    securityContext:
      runAsUser: <USER_ID>
      supplementalGroups:
        - <GROUP_ID>

kubectl apply -f datadog-agent.yaml

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

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

Container registries

Datadog publishes container images to Google Artifact Registry, Amazon ECR, Azure ACR, and Docker Hub:

By default, the Agent image is pulled from Google Artifact Registry (gcr.io/datadoghq). If Artifact Registry is not accessible in your deployment region, use another registry.

If you are deploying the Agent in an AWS environment, Datadog recommend that you use Amazon ECR.

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>

For more information, see Changing your container registry.

Uninstall

kubectl delete datadogagent datadog
helm delete datadog-operator

helm uninstall datadog-agent

Étapes suivantes

Surveiller votre infrastructure dans Datadog

Utilisez la page Containers pour avoir de la visibilité sur votre infrastructure de conteneurs, avec des métriques de ressources et une recherche par facettes. Pour en savoir plus sur l’utilisation de cette page, consultez Containers View (en anglais).

Utilisez la page Container Images (en anglais) pour obtenir des informations sur chaque image utilisée dans votre environnement. Cette page affiche aussi les vulnérabilités détectées dans vos images de conteneurs par Cloud Security. Pour en savoir plus, consultez la section Containers Images View (en anglais).

La section Kubernetes propose un aperçu de toutes vos ressources Kubernetes. L’Orchestrator Explorer vous permet de surveiller l’état des pods, des déploiements et d’autres concepts Kubernetes dans un espace de nommage ou une zone de disponibilité donnée, de consulter les spécifications des ressources pour les pods défaillants au sein d’un déploiement, de mettre en corrélation l’activité des nœuds avec les logs associés, et bien plus. La page Utilisation des ressources fournit des informations sur la manière dont vos workloads Kubernetes consomment les ressources informatiques dans toute votre infrastructure. Pour en savoir plus, consultez les rubriques Orchestrator Explorer et Utilisation des ressources Kubernetes.

Activer les fonctionnalités

Pour aller plus loin

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