L’Agent Docker Datadog est la version conteneurisée de l'Agent pour host. L'image Docker officielle est disponible sur Docker Hub et GCR.
L’image est disponible en versions pour architectures x86 64 bits et Arm v8.
| Docker Hub | GCR |
|---|---|
Agent v6+docker pull datadog/agent | Agent v6+docker pull gcr.io/datadoghq/agent |
Agent v5docker pull datadog/docker-dd-agent | Agent v5docker pull gcr.io/datadoghq/docker-dd-agent |
Si vous n’avez pas encore installé l’Agent Docker, consultez les informations ci-dessous ou les instructions d’installation intégrées à l’application. Consultez la documentation de l’Agent pour connaître les versions prises en charge. Utilisez la commande d’installation en une seule étape. Remplacez <CLÉ_API_DATADOG> par votre clé d’API Datadog.
docker run -d --name dd-agent -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e DD_API_KEY=<CLÉ_API_DATADOG> gcr.io/datadoghq/agent:7
Remarque : mettez à jour l’image si vous utilisez un autre registre que GCR.
docker run -d --name dd-agent -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /cgroup/:/host/sys/fs/cgroup:ro -e DD_API_KEY=<CLÉ_API_DATADOG> gcr.io/datadoghq/agent:7
L’Agent Datadog est pris en charge dans Windows Server version 2019 (LTSC) et 1909 (SAC).
docker run -d --name dd-agent -e DD_API_KEY=<CLÉ_API> -v \\.\pipe\docker_engine:\\.\pipe\docker_engine gcr.io/datadoghq/agent
(Facultatif) Pour exécuter une installation sans privilèges, ajoutez --group-add=<ID_GROUPE_DOCKER> à la commande d’installation. Par exemple :
docker run -d --name dd-agent -v /var/run/docker.sock:/var/run/docker.sock:ro -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e DD_API_KEY=<CLÉ_API_DATADOG> gcr.io/datadoghq/agent:7 --group-add=<ID_GROUPE_DOCKER>
Remarque : pour Docker Compose, consultez Compose et l’Agent Datadog.
Dès lors que votre Agent s’exécute, vous pouvez utiliser la fonctionnalité Autodiscovery de Datadog pour recueillir automatiquement des métriques et des logs à partir des conteneurs de votre application.
Le fichier de configuration principal de l’Agent est datadog.yaml. Pour l’Agent Docker, les options de configuration datadog.yaml sont envoyées via des variables d’environnement.
| Variable d’environnement | Description |
|---|---|
DD_API_KEY | Votre clé d’API Datadog (obligatoire). |
DD_ENV | Définit le tag env global pour toutes les données émises. |
DD_HOSTNAME | Le hostname à utiliser pour les métriques (si la détection automatique échoue). |
DD_TAGS | Tags de host séparés par des espaces. Exemple : tag-simple-0 clé-tag-1:valeur-tag-1. |
DD_SITE | Le site auquel vous transmettez vos métriques, traces et logs. Vous pouvez choisir entre datadoghq.com pour le site américain de Datadog et datadoghq.eu pour le site européen. |
DD_DD_URL | Paramètre facultatif pour remplacer l’URL utilisée pour l’envoi de métriques. |
DD_CHECK_RUNNERS | Par défaut, l’Agent exécute tous les checks simultanément (valeur par défaut : 4 runners). Pour exécuter les checks de manière séquentielle, définissez la valeur sur 1. Si vous devez exécuter un grand nombre de checks (ou plusieurs checks lents), le composant collector-queue peut prendre du retard et renvoyer un échec au check de santé. Vous pouvez accroître le nombre de runners pour exécuter davantage de checks en parallèle. |
À partir de l’Agent v6.4.0 (et v6.5.0 pour l’Agent de trace), vous pouvez remplacer les paramètres de proxy de l’Agent via les variables d’environnement suivantes :
| Variable d’environnement | Description |
|---|---|
DD_PROXY_HTTP | URL HTTP à utiliser comme proxy pour les requêtes http. |
DD_PROXY_HTTPS | URL HTTPS à utiliser comme proxy pour les requêtes https. |
DD_PROXY_NO_PROXY | Une liste d’URL, séparées par des espaces, pour lesquelles aucun proxy ne doit être utilisé. |
Pour en savoir plus sur les paramètres de proxy, consultez la documentation relative au proxy de l’Agent v6.
Par défaut, les Agents de collecte facultatifs sont désactivés pour des raisons de sécurité et de performance. Utilisez les variables d’environnement suivantes pour les activer :
| Variable d’environnement | Description |
|---|---|
DD_APM_ENABLED | Active la collecte de traces via l’Agent de traces. |
DD_LOGS_ENABLED | Active la collecte de logs via l’Agent de logs. |
DD_PROCESS_AGENT_ENABLED | Active la collecte de live processes via l’Agent de processus. Par défaut, la vue Live Container est déjà activée si le socket Docker est disponible. Si définie sur false, la collecte de live processes et la vue Live Container sont désactivées. |
Envoyez des métriques custom avec le protocole StatsD :
| Variable d’environnement | Description |
|---|---|
DD_DOGSTATSD_NON_LOCAL_TRAFFIC | Effectue une écoute des paquets DogStatsD issus d’autres conteneurs (requis pour envoyer des métriques custom). |
DD_HISTOGRAM_PERCENTILES | Les centiles de l’histogramme à calculer (séparés par des espaces). Valeur par défaut : 0.95. |
DD_HISTOGRAM_AGGREGATES | Les agrégations à calculer pour l’histogramme (séparées par des espaces). Valeur par défaut : « max median avg count ». |
DD_DOGSTATSD_SOCKET | Le chemin vers le socket Unix à écouter. Doit être dans un volume rw monté. |
DD_DOGSTATSD_ORIGIN_DETECTION | Active la détection de conteneurs et l’ajout de tags pour les métriques de socket Unix. |
DD_DOGSTATSD_TAGS | Les tags supplémentaires à ajouter à l’ensemble des métriques, événements et checks de service reçus par ce serveur DogStatsD. Par exemple : "env:golden group:retrievers". |
En savoir plus sur l’utilisation de DogStatsD via un socket de domaine Unix.
Datadog recommande d’utiliser le tagging de service unifié pour attribuer des tags.
Datadog recueille automatiquement les tags courants à partir de Docker, Kubernetes, ECS, Swarm, Mesos, Nomad et Rancher. Pour extraire des tags supplémentaires, utilisez les options suivantes :
| Variable d’environnement | Description |
|---|---|
DD_DOCKER_LABELS_AS_TAGS | Extrait les étiquettes de conteneur Docker. |
DD_DOCKER_ENV_AS_TAGS | Extrait les variables d’environnement de conteneur Docker. |
DD_COLLECT_EC2_TAGS | Extrait les tags EC2 personnalisés sans utiliser l’intégration AWS. |
Consultez la documentation relative à l’extraction de tags Docker pour en savoir plus.
Les identifiants des intégrations peuvent être conservés dans des secrets Docker ou Kubernetes et utilisés dans les modèles Autodiscovery. Pour en savoir plus, consultez la documentation relative à la gestion des secrets.
Excluez les conteneurs de la collecte de logs, de la collecte de métriques et d’Autodiscovery. Par défaut, Datadog exclut les conteneurs pause de Kubernetes et d’OpenShift. Ces listes d’inclusion et d’exclusion s’appliquent uniquement à Autodiscovery. Elles n’ont aucun impact sur les traces ni sur DogStatsD. La valeur de ces variables d’environnement prend en charge les expressions régulières.
| Variable d’environnement | Description |
|---|---|
DD_CONTAINER_INCLUDE | Liste des conteneurs à inclure (séparés par des espaces). Utilisez .* pour tous les inclure. Exemple : "image:nom_image_1 image:nom_image_2", image:.* Lorsque vous utilisez ImageStreams au sein d’environnements OpenShift, utilisez le nom du conteneur à la place de l’image. Par exemple : “name:nom_conteneur_1 name:nom_conteneur_2”, name:.* |
DD_CONTAINER_EXCLUDE | Liste des conteneurs à exclure (séparés par des espaces). Utilisez .* pour tous les exclure. Exemple : "image:nom_image_3 image:nom_image_4" (cette variable est seulement traitée pour Autodiscovery), image:.*. |
DD_CONTAINER_INCLUDE_METRICS | Liste des conteneurs dont vous souhaitez inclure les métriques. |
DD_CONTAINER_EXCLUDE_METRICS | Liste des conteneurs dont vous souhaitez exclure les métriques. |
DD_CONTAINER_INCLUDE_LOGS | Liste des conteneurs dont vous souhaitez inclure les logs. |
DD_CONTAINER_EXCLUDE_LOGS | Liste des conteneurs dont vous souhaitez exclure les logs. |
DD_AC_INCLUDE | Obsolète. Liste des conteneurs à inclure (séparés par des espaces). Utilisez .* pour tous les inclure. Exemple : "image:nom_image_1 image:nom_image_2", image:.*. |
DD_AC_EXCLUDE | Obsolète. Liste des conteneurs à exclure (séparés par des espaces). Utilisez .* pour tous les exclure. Exemple : "image:nom_image_3 image:nom_image_4" (cette variable est seulement traitée pour Autodiscovery), image:.*. |
Des exemples supplémentaires sont disponibles sur la page Gestion de la découverte de conteneurs.
Remarque : ces paramètres n’ont aucun effet sur les métriques kubernetes.containers.running, kubernetes.pods.running, docker.containers.running, .stopped, .running.total et .stopped.total, qui prennent en compte l’ensemble des conteneurs. Cela n’a aucune incidence sur le nombre de conteneurs facturés.
| Variable d’environnement | Description |
|---|---|
DD_PROCESS_AGENT_CONTAINER_SOURCE | Remplace la détection automatique des sources de conteneurs par une source unique, comme "docker", "ecs_fargate" ou "kubelet". |
DD_HEALTH_PORT | Définissez cette variable sur 5555 pour exposer le check de santé de l’Agent sur le port 5555. |
Vous pouvez ajouter d’autres écouteurs et fournisseurs de configuration à l’aide des variables d’environnement DD_EXTRA_LISTENERS et DD_EXTRA_CONFIG_PROVIDERS. Elles viennent s’ajouter aux variables définies dans les sections listeners et config_providers du fichier de configuration datadog.yaml.
Consultez les guides sur les commandes de l’Agent pour découvrir toutes les commandes de l’Agent Docker.
Par défaut, l’Agent Docker recueille les métriques associées aux checks principaux suivants. Pour recueillir les métriques associées à d’autres technologies, consultez la section Intégrations.
| Check | Métriques |
|---|---|
| CPU | Système |
| Disk | Disque |
| Docker | Docker |
| File Handle | Système |
| IO | Système |
| Load | Système |
| Memory | Système |
| Réseau | Réseau |
| NTP | NTP |
| Uptime | Système |
L’Agent Docker envoie des événements à Datadog lorsqu’un Agent est démarré ou redémarré.
datadog.agent.up :
Renvoie CRITICAL si l’Agent ne parvient pas à se connecter à Datadog. Si ce n’est pas le cas, renvoie OK.
datadog.agent.check_status :
Renvoie CRITICAL si un check de l’Agent ne parvient pas à envoyer des métriques à Datadog. Si ce n’est pas le cas, renvoie OK.
Documentation, liens et articles supplémentaires utiles:
