Remarque : le check Docker Daemon est toujours tenu à jour, mais fonctionne uniquement avec la version 5 de l’Agent.

Présentation

Configurez ce check d’Agent pour obtenir des métriques du service Docker_daemon en temps réel pour :

• Visualiser et surveiller les états de Docker_daemon
• Être informé des failovers et des événements de Docker_daemon

Configuration

Installation

Pour recueillir des métriques Docker sur tous vos conteneurs, exécutez un Agent Datadog sur chaque host. Il existe deux façons d’exécuter l’Agent : directement sur chaque host, ou au sein d’un conteneur docker-dd-agent (conseillé).

Dans les deux cas, pour que le check Docker n’échoue pas, vos hosts requièrent l’activation de la gestion de mémoire cgroup. Consultez le référentiel docker-dd-agent pour savoir comment l’activer.

Installation sur un host

1. Vérifiez que Docker est en cours d’exécution sur le host.
2. Installez l’Agent comme décrit dans les instructions d’installation de l’Agent pour le système d’exploitation de votre host.
3. Activez le carré d’intégration Docker dans l’application.
4. Ajoutez l’utilisateur de l’Agent au groupe Docker : usermod -a -G docker dd-agent.
5. Créez un fichier docker_daemon.yaml en copiant le fichier d’exemple dans le répertoire conf.d de l’Agent. Si vous avez effectué l’installation standard de Docker sur votre host, vous n’avez rien à changer pour faire fonctionner l’intégration.
6. Pour activer d’autres intégrations, utilisez docker ps afin d’identifier les ports utilisés par les applications correspondantes.

Installation sur un conteneur

1. Vérifiez que Docker est en cours d’exécution sur le host.

2. Conformément aux instructions d’installation du conteneur Docker, exécutez ce qui suit :

    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 API_KEY={VOTRE_CLÉ_API_DD} \
      datadog/docker-dd-agent:latest
   

Dans la commande ci-dessus, vous pouvez transmettre votre clé d’API à l’Agent Datadog à l’aide du flag de variable d’environnement -e de Docker. Le tableau ci-dessous répertorie d’autres variables disponibles :

Remarque : ajoutez --restart=unless-stopped si vous souhaitez limiter les redémarrages de votre Agent.

Exécuter le conteneur de l’Agent sur Amazon Linux

Pour exécuter le conteneur de l’Agent Datadog sur Amazon Linux, apportez les modifications suivantes au niveau du montage du volume cgroup :

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 API_KEY={VOTRE CLÉ D'API} \
  datadog/docker-dd-agent:latest

Conteneur basé sur Alpine Linux

L’image Docker standard repose sur Debian Linux, mais depuis la version 5.7 de l’Agent Datadog, il existe une image basée sur Alpine Linux. L’image Alpine Linux est beaucoup plus petite que l’image traditionnelle Debian. Elle hérite également des conceptions axées sur la sécurité d’Alpine.

Pour utiliser l’image Alpine Linux, ajoutez -alpine au tag de version. 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 API_KEY={VOTRE CLÉ D'API} \
  datadog/docker-dd-agent:latest-alpine

Contrôle de version de l’image

Depuis la version 5.5.0 de l’Agent Datadog, l’image Docker suit un nouveau modèle de contrôle de version. Il permet de valider les modifications apportées à l’image Docker de l’Agent Datadog tout en conservant la même version de l’Agent.

La version de l’image Docker est exprimée de la façon suivante : X.Y.Z. X correspond à la version majeure de l’image Docker, Y à la version mineure et Z à la version de l’Agent.

Par exemple, la première version de l’image Docker qui est fournie avec l’Agent 5.5.0 de Datadog est 10.0.550.

Conteneurs personnalisés et informations supplémentaires

Pour en savoir plus sur l’élaboration de conteneurs Docker personnalisés avec l’Agent Datadog, l’image Alpine Linux, le contrôle de version et plus encore, consultez le projet docker-dd-agent sur Github.

Validation

Lancez la sous-commande status de l’Agent et cherchez docker_daemon dans la section Checks.

Agent v6

Le dernier check Docker s’intitule docker. Il est rédigé en Go pour tirer pleinement parti de la nouvelle architecture interne. Depuis la v6.0, l’Agent ne charge plus le check docker_daemon, même s’il est toujours disponible et maintenu à jour pour l’Agent v5. Toutes les fonctionnalités ont été incluses dans les versions >6.0, à l’exception de ce qui suit :

• Les options url, api_version et tags* sont obsolètes. Nous vous conseillons d’utiliser directement les variables d’environnement Docker standard.
• Les options ecs_tags, performance_tags et container_tags sont obsolètes. Tous les tags pertinents sont recueillis par défaut.
• L’option collect_container_count permettant d’activer la métrique docker.container.count n’est plus prise en charge. Vous devez utiliser docker.containers.running et .stopped.

Certaines options ont été déplacées du fichier docker_daemon.yaml vers le fichier datadog.yaml principal :

• collect_labels_as_tags a été renommé docker_labels_as_tags et prend désormais en charge les tags dotés d’une cardinalité élevée. Consultez les informations détaillées dans datadog.yaml.example.
• Les listes exclude et include ont été renommées ac_include et ac_exclude. Afin d’obtenir un filtrage cohérent entre tous les composants de l’Agent, le filtrage des tags arbitraires a été abandonné. Les seuls tags de filtrage pris en charge sont image (nom de l’image) et name (nom du conteneur). Le filtrage à l’aide d’expressions régulières est toujours disponible. Consultez datadog.yaml.example pour obtenir des exemples.
• L’option docker_root a été divisée en deux options : container_cgroup_root et container_proc_root.
• exclude_pause_container a été ajouté afin d’exclure les conteneurs en pause sur Kubernetes et Openshift (valeur par défaut : true). Cela évite de les supprimer de la liste d’exclusion par erreur.

Autres modifications :

• La variable d’environnement TAGS a été renommée DD_TAGS.
• Le référentiel Docker Hub est passé de datadog/docker-dd-agent à datadog/agent.

La commande import effectue la conversion de l’ancien docker_daemon.yaml vers le nouveau docker.yaml. Elle déplace également les paramètres requis de docker_daemon.yaml vers datadog.yaml.

Données collectées

Métriques

Événements

L’intégration Docker génère les événements suivants :

• Delete Image
• Die
• Erreur
• Fail
• Kill
• Out of memory (oom)
• Pause
• Restart container
• Restart Daemon
• Update

Checks de service

docker.service_up
Renvoie CRITICAL si l’Agent n’est pas capable de recueillir la liste des conteneurs du daemon Docker. Si ce n’est pas le cas, renvoie OK.
Statuses: ok, critical

docker.container_health
Renvoie CRITICAL si un conteneur n’est pas sain, renvoie OK si ce n’est pas le cas ou renvoie UNKNOWN si l’état de santé est inconnu.
Statuses: ok, critical, unknown

docker.exit
Renvoie CRITICAL si un conteneur est fermé avec un code de sortie différent de zéro. Si ce n’est pas le cas, renvoie OK.
Statuses: ok, critical

Remarque : pour utiliser docker.exit, ajoutez collect_exit_code: true dans votre fichier YAML Docker et redémarrez l’Agent.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin

• Compose et l’Agent Datadog
• DogStatsD et Docker
• Le problème de la surveillance Docker (série d’articles)
• Comment surveiller les métriques de ressource Docker
• Comment recueillir des métriques Docker
• 8 faits surprenants sur l’adoption concrète de Docker
• Surveiller Docker sur AWS ECS
• Optimiser Datadog pour Docker
• Surveiller Docker avec Datadog