Agente Docker

O agente Docker do Status200 é um contêiner que você executa em um host Docker. Ele lê as estatísticas e os arquivos de log de cada contêiner do host e os envia ao Status200, onde o host aparece com os contêineres, as métricas e os logs dele. Um segundo contêiner, o agente de IA do Docker, permite que a Status200 AI investigue o host. Os monitores de Docker alertam com base no que o agente envia.

Como funciona#

O agente é um OpenTelemetry Collector com a configuração do Status200 embutida. Pelo socket do Docker, ele lê as estatísticas de cada contêiner a cada 30 segundos e lista cada contêiner, imagem, rede e volume a cada 5 minutos. Ele acompanha os arquivos de log dos contêineres e envia tudo para a sua URL do Status200 via OTLP, com a chave de ingestão que você fornece.

O host se registra com os primeiros dados, com o nome que você define em DOCKER_HOST_NAME. O agente de IA é opcional: deixe-o de fora e o coletor funciona do mesmo jeito.

Antes de começar#

• Docker Engine 20.10 ou posterior e acesso root no host: o agente lê /var/run/docker.sock.
• Docker Compose v2 (o comando docker compose), se você instalar com Docker Compose.
• Uma chave de ingestão. Crie uma em Configurações do projeto → Telemetria e APM → Chaves de ingestão e copie o valor.
• HTTPS de saída do host para a sua URL do Status200.
• Para logs de contêineres, contêineres que usam o driver de log json-file do Docker, que é o padrão do Docker. Veja Logs de contêineres precisam do driver de log json-file.

Instale o agente#

1. Inicie o agente#

   Substitua YOUR_STATUS200_URL pela sua URL do Status200, YOUR_TELEMETRY_INGESTION_TOKEN pela chave de ingestão e my-docker-host por um nome para este host, como prod-docker-01. O nome é como o host aparece no Status200, então mantenha-o estável: um nome novo registra um host novo.

   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

   Depois inicie o agente de IA ao lado dele, com os mesmos valores. As investigações de IA vêm ativadas por padrão: enquanto a Status200 AI investiga um incidente ou alerta neste host, ela executa comandos docker somente leitura pelo agente de IA, e não altera nada a menos que você permita correções. Para instalar sem investigações de IA, pule 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

   Salve isto como docker-compose.yml em uma pasta no host. O segundo serviço é o agente de IA: deixe-o de fora para executar o coletor sem investigações de 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

   Inicie-o nessa pasta:

   Bash

   docker compose up -d

2. Verifique se o agente está em execução#

   Bash

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

   Os logs devem mostrar esta linha assim que o coletor iniciar:

   Everything is ready. Begin running and processing data.

3. Encontre o host no Status200#

   Abra Produtos → Infraestrutura → Docker → Todos os hosts. O host aparece com o DOCKER_HOST_NAME dele em cerca de um minuto, com os contêineres, as métricas e os logs dele. O agente de IA aparece como conectado na página Agente de IA do host e no fim da Visão geral dele. A página Topologia do host desenha os seus projetos do Compose, contêineres, imagens, redes e volumes em um único mapa: veja Topologia.

Variáveis de ambiente#

Para mudar um valor, remova o agente e execute o comando dele de novo (Docker CLI), ou edite docker-compose.yml e execute docker compose up -d (Docker Compose).

O que o agente coleta#

As métricas e os logs de cada contêiner são arquivados em um serviço com o nome do contêiner. Cada linha de log recebe uma severidade a partir do nível que ela cita, como [ERROR], level=warn ou {"level":"info"}; uma linha que não cita nenhum fica com a do fluxo dela: stderr é ERROR, stdout é INFO. Linhas que começam com espaço em branco ou com um colchete de fechamento se juntam à linha anterior, então um stack trace chega como um único registro. Os logs do próprio agente ficam de fora.

Monitor de Docker lista cada métrica e o que ela significa.

Logs de contêineres precisam do driver de log json-file#

O agente acompanha /var/lib/docker/containers/*/*-json.log, os arquivos que o driver de log json-file do Docker grava. Um contêiner que usa outro driver não deixa arquivo para ler: local grava arquivos binários, e journald, syslog, fluentd e gelf enviam os logs para outro lugar. As métricas dele continuam chegando; os logs, não.

Verifique o driver de log de um contêiner e o padrão do daemon:

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

Mude um serviço do Compose para json-file, com rotação:

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

Ou torne-o o padrão para todo contêiner criado depois, em /etc/docker/daemon.json:

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

Depois reinicie o Docker e recrie os contêineres. Um contêiner mantém o driver de log com que foi criado, então reiniciá-lo não basta.

Atualizando o agente#

Quando o agente é mais antigo que o seu Status200, um sinal de aviso aparece ao lado de Versão do agente na Visão geral do host. Selecione-o para ver estes 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

A tag release sempre aponta para a versão mais recente. Para fixar uma versão, use status200/docker-agent:<version>, como status200/docker-agent:10.0.31. A mesma imagem está no GitHub Container Registry como ghcr.io/status200/docker-agent:release.

Desinstalando o agente#

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

docker compose down

O host continua no Status200 com os dados que enviou. Se não precisar mais dele, exclua-o com Excluir host no menu dele.

Agente de IA#

Os comandos e o arquivo do Compose acima, o install.sh do agente Docker e o docker-compose.yml no [diretório DockerAgent](<YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerAgent) dele executam todos o Agente de IA do Docker: um segundo contêiner, status200-docker-ai-agent (imagem status200/resource-ai-agent:release), que executa os comandos docker somente leitura que a Status200 AI pede enquanto investiga um incidente ou alerta neste host — docker ps -a, docker logs --tail 200 web, docker container inspect web, docker stats --no-stream — e, só se você permitir, aplica correções como reiniciar um contêiner específico. Ele lê os mesmos STATUS200_URL, STATUS200_SERVICE_TOKEN e DOCKER_HOST_NAME que o coletor, então atende exatamente este host, e aparece na página Agente de IA do host no Status200.

• As investigações de IA vêm ativadas por padrão. Assim que o agente se conecta, a Status200 AI investiga com ele os incidentes e alertas deste host, e a Visão geral do host mostra o status do agente. Para parar, defina STATUS200_AI_INVESTIGATION=false onde o agente é executado (Alterar, em O que a IA pode fazer na página do agente de IA, mostra como), ou deixe o agente de fora.
• Ele é somente leitura, a menos que você o inicie com STATUS200_AI_ALLOW_WRITES=true; STATUS200_AI_WRITE_TARGETS (por exemplo web-*,api-*) limita quais contêineres uma correção pode tocar. Inicie-o também com STATUS200_AI_FIXES, para dizer como as correções são executadas — ask-for-approval (uma pessoa aprova cada uma), automatic ou bypass-approval — e a página do agente de IA mostra isso somente para leitura (O que a IA pode fazer, definido pelo agente).
• Ele é executado como root com o socket do Docker montado, porque o socket pertence ao root — e quem pode usar o socket é root neste host, com :ro ou não. O limite é a política de comandos do agente: ele nunca executa exec, run, rm ou prune, e nunca altera a si mesmo, o coletor ou qualquer coisa em STATUS200_AI_PROTECTED_TARGETS (globs de nomes de contêineres). Os valores de ambiente na saída de docker inspect são mascarados antes que qualquer coisa saia do host.
• install.sh --no-ai-agent o deixa de fora; docker rm -f status200-docker-ai-agent o remove. Atualize-o como o coletor: docker pull status200/resource-ai-agent:release, remova-o e inicie-o de novo.

O que ele pode executar, como as correções funcionam e como solucionar problemas: Infrastructure AI Agents.

Solução 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 passos#