Agente de Docker

El agente de Docker de Status200 es un contenedor que ejecutas en un host de Docker. Lee las estadísticas y los archivos de log de cada contenedor del host y los envía a Status200, donde el host aparece con sus contenedores, métricas y logs. Un segundo contenedor, el agente de IA de Docker, permite a Status200 AI investigar el host. Los monitores de Docker alertan según lo que envía el agente.

Cómo funciona#

El agente es un OpenTelemetry Collector con la configuración de Status200 integrada. A través del socket de Docker lee las estadísticas de cada contenedor cada 30 segundos y enumera cada contenedor, imagen, red y volumen cada 5 minutos. Sigue los archivos de log de los contenedores y lo envía todo a tu URL de Status200 por OTLP, con la clave de ingesta que le das.

El host se registra con sus primeros datos, con el nombre que le das en DOCKER_HOST_NAME. El agente de IA es opcional: si lo omites, el colector funciona igual.

Antes de empezar#

• Docker Engine 20.10 o posterior, y acceso root en el host: el agente lee /var/run/docker.sock.
• Docker Compose v2 (el comando docker compose), si instalas con Docker Compose.
• Una clave de ingesta. Crea una en Ajustes del proyecto → Telemetría y APM → Claves de ingesta y copia su valor.
• HTTPS saliente desde el host hacia tu URL de Status200.
• Para los logs de contenedores, contenedores que usen el controlador de logs json-file de Docker, que es el predeterminado de Docker. Consulta Los logs de contenedores necesitan el controlador json-file.

Instala el agente#

1. Inicia el agente#

   Reemplaza YOUR_STATUS200_URL por tu URL de Status200, YOUR_TELEMETRY_INGESTION_TOKEN por la clave de ingesta y my-docker-host por un nombre para este host, como prod-docker-01. El nombre es como aparece el host en Status200, así que mantenlo estable: un nombre nuevo registra un host nuevo.

   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

   Luego inicia el agente de IA a su lado, con los mismos valores. Las investigaciones con IA están activadas por defecto: mientras Status200 AI investiga un incidente o una alerta en este host, ejecuta comandos docker de solo lectura a través del agente de IA, y no cambia nada salvo que permitas correcciones. Para instalar sin investigaciones con IA, omite este comando.

   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

   Guarda esto como docker-compose.yml en una carpeta del host. El segundo servicio es el agente de IA: omítelo para ejecutar el colector sin investigaciones con 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

   Inícialo en esa carpeta:

   Bash

   docker compose up -d

2. Comprueba que el agente se está ejecutando#

   Bash

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

   Los logs deberían mostrar esta línea cuando el colector haya arrancado:

   Everything is ready. Begin running and processing data.

3. Busca el host en Status200#

   Abre Productos → Infraestructura → Docker → Todos los hosts. El host aparece con su DOCKER_HOST_NAME en más o menos un minuto, con sus contenedores, métricas y logs. El agente de IA aparece como conectado en la página Agente de IA del host y al final de su Vista general. La página Topología del host dibuja sus proyectos de Compose, contenedores, imágenes, redes y volúmenes en un solo mapa: consulte Topología.

Variables de entorno#

Para cambiar un valor, quita el agente y vuelve a ejecutar su comando (Docker CLI), o edita docker-compose.yml y ejecuta docker compose up -d (Docker Compose).

Qué recopila el agente#

Las métricas y los logs de cada contenedor se archivan en un servicio con el nombre del contenedor. Cada línea de log recibe una severidad a partir del nivel que menciona, como [ERROR], level=warn o {"level":"info"}; una línea que no menciona ninguno toma la de su flujo: stderr es ERROR, stdout es INFO. Las líneas que empiezan con un espacio en blanco o un corchete de cierre se unen a la línea anterior, así que un stack trace llega como un solo registro. Los logs del propio agente se omiten.

Monitor de Docker enumera cada métrica y lo que significa.

Los logs de contenedores necesitan el controlador json-file#

El agente sigue /var/lib/docker/containers/*/*-json.log, los archivos que escribe el controlador de logs json-file de Docker. Un contenedor que usa otro controlador no deja ningún archivo que leer: local escribe archivos binarios, y journald, syslog, fluentd y gelf envían los logs a otro sitio. Sus métricas siguen llegando; sus logs no.

Comprueba el controlador de logs de un contenedor y el predeterminado del daemon:

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

Cambia un servicio de Compose a json-file, con rotación:

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

O conviértelo en el predeterminado para cada contenedor creado a partir de entonces, en /etc/docker/daemon.json:

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

Luego reinicia Docker y vuelve a crear los contenedores. Un contenedor conserva el controlador de logs con el que se creó, así que reiniciarlo no basta.

Actualizar el agente#

Cuando el agente es más antiguo que tu Status200, aparece una señal de advertencia junto a Versión del agente en la Vista general del host. Selecciónala para ver estos comandos.

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

La etiqueta release siempre apunta a la versión más reciente. Para fijar una versión, usa status200/docker-agent:<version>, como status200/docker-agent:10.0.31. La misma imagen está en GitHub Container Registry como ghcr.io/status200/docker-agent:release.

Desinstalar el agente#

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

docker compose down

El host se queda en Status200 con los datos que envió. Si ya no lo necesitas, elimínalo con Eliminar host en su menú.

Agente de IA#

Los comandos y el archivo de Compose de arriba, el install.sh del agente de Docker y el docker-compose.yml de su [directorio DockerAgent](<YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerAgent) ejecutan todos el Agente de IA de Docker: un segundo contenedor, status200-docker-ai-agent (imagen status200/resource-ai-agent:release), que ejecuta los comandos docker de solo lectura que pide Status200 AI mientras investiga un incidente o una alerta en este host — docker ps -a, docker logs --tail 200 web, docker container inspect web, docker stats --no-stream — y, solo si lo permites, aplica correcciones como reiniciar un contenedor concreto. Lee los mismos STATUS200_URL, STATUS200_SERVICE_TOKEN y DOCKER_HOST_NAME que el colector, así que atiende exactamente a este host, y aparece en la página Agente de IA del host en Status200.

• Las investigaciones con IA están activadas por defecto. En cuanto el agente se conecta, Status200 AI investiga con él los incidentes y alertas de este host, y la Vista general del host muestra el estado del agente. Para detenerlo, establece STATUS200_AI_INVESTIGATION=false donde se ejecuta el agente (Cambiar en Lo que puede hacer la IA, en la página del agente de IA, muestra cómo), u omite el agente.
• Es de solo lectura salvo que lo inicies con STATUS200_AI_ALLOW_WRITES=true; STATUS200_AI_WRITE_TARGETS (por ejemplo web-*,api-*) limita qué contenedores puede tocar una corrección. Inícialo también con STATUS200_AI_FIXES para indicar cómo se ejecutan las correcciones — ask-for-approval (una persona aprueba cada una), automatic o bypass-approval — y la página del agente de IA lo muestra en solo lectura (Lo que puede hacer la IA, según el agente).
• Se ejecuta como root con el socket de Docker montado, porque el socket pertenece a root — y quien puede usar el socket es root en este host, con :ro o sin él. El límite es la política de comandos del agente: nunca ejecuta exec, run, rm ni prune, y nunca se cambia a sí mismo, al colector ni nada de STATUS200_AI_PROTECTED_TARGETS (globs de nombres de contenedores). Los valores de entorno de la salida de docker inspect se enmascaran antes de que nada salga del host.
• install.sh --no-ai-agent lo omite; docker rm -f status200-docker-ai-agent lo quita. Actualízalo como el colector: docker pull status200/resource-ai-agent:release, quítalo y vuelve a iniciarlo.

Qué puede ejecutar, cómo funcionan las correcciones y cómo solucionar sus problemas: Infrastructure AI Agents.

Solución de problemas#

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

Próximos pasos#