Kubernetes

Pour installer le chart avec un nom de version <RELEASE_NAME> personnalisé (p. ex., datadog-agent) :

1. Installez Helm.
2. Téléchargez le fichier de configuration values.yaml Datadog.

3. S’il s’agit d’une nouvelle installation, ajoutez le référentiel du Helm Datadog et le référentiel de Helm stable (pour le chart Kube State Metrics) :

   helm repo add datadog https://helm.datadoghq.com
   helm repo add stable https://kubernetes-charts.storage.googleapis.com/
   helm repo update

4. Récupérez votre clé d’API Datadog à partir des instructions d’installation de l’Agent et exécutez ce qui suit :

• Helm v3 et ultérieur

  helm install <RELEASE_NAME> -f values.yaml  --set datadog.apiKey=<DATADOG_API_KEY> datadog/datadog --set targetSystem=<TARGET_SYSTEM>

  Remplacez <TARGET_SYSTEM> par le nom de votre système d’exploitation : linux ou windows.

• Helm v1 ou v2

  helm install -f values.yaml --name <RELEASE_NAME> --set datadog.apiKey=<DATADOG_API_KEY> datadog/datadog

Ce chart ajoute l’Agent Datadog à l’ensemble des nœuds dans votre cluster via un DaemonSet. Il peut également déployer le chart kube-state-metrics et l’utiliser comme source supplémentaire de métriques concernant le cluster. Quelques minutes après l’installation, Datadog commence à transmettre les hosts et les métriques.

Activez ensuite les fonctionnalités Datadog que vous souhaitez utiliser, comme l’APM ou les logs.

Remarque : pour obtenir la liste complète des paramètres disponibles pour le chart Datadog et leurs valeurs par défaut, consultez le README du référentiel Helm Datadog.

Mise à niveau depuis le chart v1.x

Le chart Datadog a été réusiné dans la v2.0 afin de regrouper plus logiquement les paramètres du fichier values.yaml.

Si vous déployez actuellement un chart antérieur à v2.0.0, suivez le guide de migration (en anglais) afin de mapper vos anciens paramètres avec les nouveaux champs.

Tirez profit des DaemonSets pour déployer l’Agent Datadog sur l’ensemble de vos nœuds (ou sur un nœud donné grâce aux nodeSelectors).

Pour installer l’Agent Datadog sur votre cluster Kubernetes :

1. Configurez les autorisations de l’Agent : si le contrôle d’accès basé sur des rôles (RBAC) est activé pour votre déploiement Kubernetes, configurez les autorisations RBAC pour le compte de service de votre Agent Datadog. Depuis la version 1.6 de Kubernetes, le RBAC est activé par défaut. Créez les ClusterRole, ServiceAccount et ClusterRoleBinding appropriés à l’aide de la commande suivante :

   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/clusterrole.yaml"
   
   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/serviceaccount.yaml"
   
   kubectl apply -f "https://raw.githubusercontent.com/DataDog/datadog-agent/master/Dockerfiles/manifests/rbac/clusterrolebinding.yaml"

   Remarque : ces configurations sont par défaut définies pour l’espace de nommage default. Si vous utilisez un espace de nommage personnalisé, modifiez le paramètre namespace avant d’appliquer les configurations.

2. Créez un secret qui contient votre clé d’API Datadog. Remplacez <DATADOG_API_KEY> ci-dessous par la clé d’API de votre organisation. Ce secret est utilisé dans le manifeste pour déployer l’Agent Datadog.

   kubectl create secret generic datadog-agent --from-literal api-key="<DATADOG_API_KEY>" --namespace="default"

   Remarque : cette opération crée un secret dans l’espace de nommage default. SI vous utilisez un espace de nommage personnalisé, modifiez le paramètre namespace de la commande avant de l’exécuter.

3. Créez le manifeste de l’Agent Datadog. Créez le manifeste datadog-agent.yaml à partir de l’un des modèles suivants :

   • Manifeste avec activation des logs, de l’APM, des processus et de la collecte des métriques
   • Manifeste avec activation des logs, de l’APM et de la collecte des métriques
   • Manifeste avec activation des logs et de la collecte des métriques
   • Manifeste avec activation de l’APM et de la collecte des métriques
   • Manifeste avec activation de la surveillance des performances réseau
   • Manifeste de base avec activation de la collecte des métriques uniquement

   Pour activer toutes les fonctionnalités de collecte de traces, vous devez suivre plusieurs étapes supplémentaires lors de la configuration des pods de votre application. Consultez également les sections relatives aux logs, à l’APM, aux processus et à la surveillance des performances réseau pour découvrir comment activer chacune de ces fonctionnalités.

   Remarque : ces manifestes sont par défaut définis pour l’espace de nommage default. Si vous utilisez un espace de nommage personnalisé, modifiez le paramètre metadata.namespace avant d’appliquer les manifestes.

4. Définissez votre site Datadog (facultatif). Si vous utilisez le site européen de Datadog, définissez la variable d’environnement DD_SITE sur datadoghq.eu dans le manifeste datadog-agent.yaml.

5. Déployez le DaemonSet avec cette commande :

   kubectl apply -f datadog-agent.yaml

6. Vérification : pour vérifier que l’Agent Datadog s’exécute dans votre environnement en tant que DaemonSet, exécutez :

   kubectl get daemonset

   Si l’Agent est déployé, une sortie similaire au texte ci-dessous s’affiche. Les valeurs DESIRED et CURRENT correspondent au nombre de nœuds exécutés dans votre cluster.

   NAME            DESIRED   CURRENT   READY     UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   datadog-agent   2         2         2         2            2           <none>          10s

7. Configurez des métriques Kubernetes State (facultatif) : téléchargez le dossier de manifestes Kube-State, puis appliquez-les à votre cluster Kubernetes pour recueillir automatiquement des métriques kube-state :

   kubectl apply -f <NAME_OF_THE_KUBE_STATE_MANIFESTS_FOLDER>

L’Operator Datadog est actuellement en bêta publique. Il s’agit d’une fonctionnalité vous permettant de déployer l’Agent Datadog sur Kubernetes et OpenShift. L’Operator transmet des données sur le statut de déploiement, la santé et les erreurs dans le statut de sa ressource personnalisée. Ses paramètres de niveau supérieur permettent également de réduire les erreurs de configuration. Pour commencer à utiliser l’Operator, consultez la page de présentation dans le référentiel Datadog Operator ou installez l’Opérator depuis la page Datadog Operator du site OperatorHub.io.

Définissez les options datadog.leaderElection, datadog.collectEvents et agents.rbac.create sur true dans votre fichier value.yaml afin d’activer la collecte d’événements Kubernetes.

Si vous souhaitez recueillir des événements à partir de votre cluster Kubernetes, définissez les variables d’environnement DD_COLLECT_KUBERNETES_EVENTS et DD_LEADER_ELECTION sur true dans le manifeste de votre Agent. Vous pouvez également utiliser le processus de collecte d’événements de l’Agent de cluster Datadog.