Agent Docker

L'agent Docker de Status200 est un conteneur que vous exécutez sur un hôte Docker. Il lit les statistiques et les fichiers de journaux de chaque conteneur de l'hôte et les envoie à Status200, où l'hôte apparaît avec ses conteneurs, ses métriques et ses journaux. Un deuxième conteneur, l'agent IA Docker, permet à Status200 AI d'enquêter sur l'hôte. Les moniteurs Docker déclenchent des alertes à partir de ce qu'envoie l'agent.

Fonctionnement#

L'agent est un OpenTelemetry Collector avec la configuration de Status200 intégrée. Via le socket Docker, il lit les statistiques de chaque conteneur toutes les 30 secondes et liste chaque conteneur, image, réseau et volume toutes les 5 minutes. Il suit les fichiers de journaux des conteneurs et envoie le tout à votre URL Status200 via OTLP, avec la clé d'ingestion que vous lui donnez.

L'hôte s'enregistre avec ses premières données, sous le nom que vous lui donnez dans DOCKER_HOST_NAME. L'agent IA est optionnel : sans lui, le collecteur fonctionne de la même façon.

Avant de commencer#

• Docker Engine 20.10 ou ultérieur, et un accès root sur l'hôte : l'agent lit /var/run/docker.sock.
• Docker Compose v2 (la commande docker compose), si vous installez avec Docker Compose.
• Une clé d'ingestion. Créez-en une sous Paramètres du projet → Télémétrie & APM → Clés d'ingestion et copiez sa valeur.
• Du HTTPS sortant de l'hôte vers votre URL Status200.
• Pour les journaux de conteneurs, des conteneurs qui utilisent le pilote de journalisation json-file de Docker, qui est celui de Docker par défaut. Voir Les journaux de conteneurs nécessitent le pilote json-file.

Installer l'agent#

1. Démarrer l'agent#

   Remplacez YOUR_STATUS200_URL par votre URL Status200, YOUR_TELEMETRY_INGESTION_TOKEN par la clé d'ingestion, et my-docker-host par un nom pour cet hôte, comme prod-docker-01. C'est sous ce nom que l'hôte apparaît dans Status200 : gardez-le donc stable, car un nouveau nom enregistre un nouvel hôte.

   Docker CLIDocker Compose

   Docker CLI

   Bash

   docker run -d \
     --name status200-docker-agent \
     --user 0:0 \
     --restart unless-stopped \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     -v /var/lib/docker/containers:/var/lib/docker/containers:ro \
     -e STATUS200_URL="YOUR_STATUS200_URL" \
     -e STATUS200_SERVICE_TOKEN="YOUR_TELEMETRY_INGESTION_TOKEN" \
     -e DOCKER_HOST_NAME="my-docker-host" \
     status200/docker-agent:release

   Démarrez ensuite l'agent IA à côté, avec les mêmes valeurs. Les enquêtes IA sont activées par défaut : pendant que Status200 AI enquête sur un incident ou une alerte sur cet hôte, elle exécute des commandes docker en lecture seule via l'agent IA, et ne modifie rien tant que vous n'autorisez pas de corrections. Pour installer sans enquêtes IA, ignorez cette commande.

   Bash

   docker run -d \
     --name status200-docker-ai-agent \
     --user 0:0 \
     --restart unless-stopped \
     --read-only --tmpfs /tmp \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     -e STATUS200_URL="YOUR_STATUS200_URL" \
     -e STATUS200_SERVICE_TOKEN="YOUR_TELEMETRY_INGESTION_TOKEN" \
     -e STATUS200_AI_AGENT_RESOURCE_TYPE=docker \
     -e DOCKER_HOST_NAME="my-docker-host" \
     status200/resource-ai-agent:release

   Docker Compose

   Enregistrez ceci sous le nom docker-compose.yml dans un dossier de l'hôte. Le second service est l'agent IA : retirez-le pour exécuter le collecteur sans enquêtes IA.

   docker-compose.ymlYAML

   services:
     status200-docker-agent:
       image: status200/docker-agent:release
       container_name: status200-docker-agent
       user: "0:0"
       restart: unless-stopped
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
         - /var/lib/docker/containers:/var/lib/docker/containers:ro
       environment:
         - STATUS200_URL=YOUR_STATUS200_URL
         - STATUS200_SERVICE_TOKEN=YOUR_TELEMETRY_INGESTION_TOKEN
         - DOCKER_HOST_NAME=my-docker-host
       logging:
         driver: json-file
         options:
           max-size: "10m"
           max-file: "3"
     status200-docker-ai-agent:
       image: status200/resource-ai-agent:release
       container_name: status200-docker-ai-agent
       user: "0:0"
       restart: unless-stopped
       read_only: true
       tmpfs:
         - /tmp
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
       environment:
         - STATUS200_URL=YOUR_STATUS200_URL
         - STATUS200_SERVICE_TOKEN=YOUR_TELEMETRY_INGESTION_TOKEN
         - STATUS200_AI_AGENT_RESOURCE_TYPE=docker
         - DOCKER_HOST_NAME=my-docker-host

   Démarrez-le dans ce dossier :

   Bash

   docker compose up -d

2. Vérifier que l'agent s'exécute#

   Bash

   docker ps --filter name=status200-docker-agent
   docker logs -f status200-docker-agent

   Les journaux doivent afficher cette ligne une fois le collecteur démarré :

   Everything is ready. Begin running and processing data.

3. Trouver l'hôte dans Status200#

   Ouvrez Produits → Infrastructure → Docker → Tous les hôtes. L'hôte apparaît sous son DOCKER_HOST_NAME en une minute environ, avec ses conteneurs, ses métriques et ses journaux. L'agent IA apparaît comme connecté sur la page Agent IA de l'hôte, et en bas de sa Vue d'ensemble. La page Topologie de l'hôte dessine ses projets Compose, conteneurs, images, réseaux et volumes sur une seule carte : voir Topologie.

Variables d'environnement#

Pour modifier une valeur, supprimez l'agent et exécutez de nouveau sa commande (Docker CLI), ou modifiez docker-compose.yml et exécutez docker compose up -d (Docker Compose).

Ce que collecte l'agent#

Les métriques et les journaux de chaque conteneur sont classés sous un service portant le nom du conteneur. Chaque ligne de journal reçoit une gravité d'après le niveau qu'elle mentionne, comme [ERROR], level=warn ou {"level":"info"} ; une ligne qui n'en mentionne aucun prend celle de son flux : stderr vaut ERROR, stdout vaut INFO. Les lignes qui commencent par un espace ou un crochet fermant sont rattachées à la ligne précédente : une stack trace arrive donc en un seul enregistrement. Les journaux de l'agent lui-même sont ignorés.

Surveillance Docker liste chaque métrique et sa signification.

Les journaux de conteneurs nécessitent le pilote json-file#

L'agent suit /var/lib/docker/containers/*/*-json.log, les fichiers qu'écrit le pilote de journalisation json-file de Docker. Un conteneur qui utilise un autre pilote ne laisse aucun fichier à lire : local écrit des fichiers binaires, et journald, syslog, fluentd et gelf envoient les journaux ailleurs. Ses métriques arrivent toujours ; ses journaux, non.

Vérifiez le pilote de journalisation d'un conteneur, et celui du daemon par défaut :

docker inspect <container> --format '{{.HostConfig.LogConfig.Type}}'
docker info --format '{{.LoggingDriver}}'

Passez un service Compose à json-file, avec rotation :

services:
  my-app:
    image: my-app:latest
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "5"

Ou faites-en la valeur par défaut pour chaque conteneur créé ensuite, dans /etc/docker/daemon.json :

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "5"
  }
}

Redémarrez ensuite Docker et recréez les conteneurs. Un conteneur garde le pilote de journalisation avec lequel il a été créé : le redémarrer ne suffit donc pas.

Mettre à jour l'agent#

Lorsque l'agent est plus ancien que votre Status200, un signe d'avertissement apparaît à côté de Version de l'agent dans la Vue d'ensemble de l'hôte. Sélectionnez-le pour voir ces commandes.

docker pull status200/docker-agent:release
docker pull status200/resource-ai-agent:release
docker rm -f status200-docker-agent status200-docker-ai-agent

docker compose pull
docker compose up -d

Le tag release pointe toujours vers la version la plus récente. Pour épingler une version, utilisez status200/docker-agent:<version>, comme status200/docker-agent:10.0.31. La même image se trouve sur GitHub Container Registry sous ghcr.io/status200/docker-agent:release.

Désinstaller l'agent#

docker rm -f status200-docker-agent
docker rm -f status200-docker-ai-agent

docker compose down

L'hôte reste dans Status200 avec les données qu'il a envoyées. Si vous n'en avez plus besoin, supprimez-le avec Supprimer l'hôte dans son menu.

Agent IA#

Les commandes et le fichier Compose ci-dessus, l'install.sh de l'agent Docker et le docker-compose.yml de son [répertoire DockerAgent](<YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerAgent) exécutent tous l'Agent IA Docker : un deuxième conteneur, status200-docker-ai-agent (image status200/resource-ai-agent:release), qui exécute les commandes docker en lecture seule que demande Status200 AI pendant qu'elle enquête sur un incident ou une alerte sur cet hôte — docker ps -a, docker logs --tail 200 web, docker container inspect web, docker stats --no-stream — et, uniquement si vous l'autorisez, applique des corrections comme le redémarrage d'un conteneur donné. Il lit les mêmes STATUS200_URL, STATUS200_SERVICE_TOKEN et DOCKER_HOST_NAME que le collecteur : il sert donc exactement cet hôte, et apparaît sur la page Agent IA de l'hôte dans Status200.

• Les enquêtes IA sont activées par défaut. Dès que l'agent se connecte, Status200 AI enquête avec lui sur les incidents et les alertes de cet hôte, et la Vue d'ensemble de l'hôte affiche l'état de l'agent. Pour arrêter, définissez STATUS200_AI_INVESTIGATION=false là où l'agent s'exécute (Modifier, sous Ce que l'IA peut faire sur la page de l'agent IA, montre comment), ou ne lancez pas l'agent.
• Il est en lecture seule, sauf si vous le démarrez avec STATUS200_AI_ALLOW_WRITES=true ; STATUS200_AI_WRITE_TARGETS (par exemple web-*,api-*) limite les conteneurs qu'une correction peut toucher. Démarrez-le aussi avec STATUS200_AI_FIXES pour indiquer comment les corrections s'exécutent — ask-for-approval (une personne approuve chacune), automatic ou bypass-approval — et la page de l'agent IA l'affiche en lecture seule (Ce que l'IA peut faire, défini par l'agent).
• Il s'exécute en tant que root avec le socket Docker monté, car le socket appartient à root — et quiconque peut utiliser le socket est root sur cet hôte, :ro ou non. La limite est la politique de commandes de l'agent : il n'exécute jamais exec, run, rm ni prune, et ne modifie jamais lui-même, le collecteur ni quoi que ce soit dans STATUS200_AI_PROTECTED_TARGETS (des globs de noms de conteneurs). Les valeurs d'environnement de la sortie de docker inspect sont masquées avant que quoi que ce soit ne quitte l'hôte.
• install.sh --no-ai-agent l'omet ; docker rm -f status200-docker-ai-agent le supprime. Mettez-le à jour comme le collecteur : docker pull status200/resource-ai-agent:release, supprimez-le, puis redémarrez-le.

Ce qu'il peut exécuter, comment fonctionnent les corrections et comment le dépanner : Infrastructure AI Agents.

Dépannage#

Error: cannot start pipelines: failed to start "docker_stats" receiver:
Error response from daemon: client version 1.44 is too new.
Maximum supported API version is 1.41

docker version --format '{{ .Server.APIVersion }}'

docker run -d ... -e DOCKER_API_VERSION= ...

docker logs status200-docker-agent 2>&1 | grep -E "Started watching file|no files match"
docker inspect <container> --format '{{.HostConfig.LogConfig.Type}}'

docker inspect status200-docker-agent --format '{{range .Config.Env}}{{println .}}{{end}}' | grep DOCKER_HOST_NAME

Étapes suivantes#