Agente Podman

O agente Podman do Status200 é um contêiner que você executa em um host Podman. 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 Podman, permite que a Status200 AI investigue o host. Os monitores de Podman alertam com base no que o agente envia.

Como funciona#

O agente é um OpenTelemetry Collector com a configuração do Status200 embutida. Pelo socket de API compatível com Docker do Podman, 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 PODMAN_HOST_NAME. O agente de IA é opcional: deixe-o de fora e o coletor funciona do mesmo jeito.

Antes de começar#

• Podman 4.0 ou posterior e acesso root no host.
• O socket de API do Podman em /run/podman/podman.sock. Ative-o com sudo systemctl enable --now podman.socket.
• 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 k8s-file. O Podman rootful grava os logs por padrão no journald, que o agente não consegue ler. Veja Logs de contêineres precisam do driver de log k8s-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-podman-host por um nome para este host, como prod-podman-01. O nome é como o host aparece no Status200, então mantenha-o estável: um nome novo registra um host novo.

   Podman CLIPodman Compose

   Podman CLI

   Bash

   podman run -d \
     --name status200-podman-agent \
     --user 0:0 \
     --restart unless-stopped \
     -v /run/podman/podman.sock:/run/podman/podman.sock:ro \
     -v /var/lib/containers/storage:/var/lib/containers/storage:ro \
     -e STATUS200_URL="YOUR_STATUS200_URL" \
     -e STATUS200_SERVICE_TOKEN="YOUR_TELEMETRY_INGESTION_TOKEN" \
     -e PODMAN_HOST_NAME="my-podman-host" \
     status200/podman-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, contra a API compatível com Docker do Podman, e não altera nada a menos que você permita correções. Para instalar sem investigações de IA, pule este comando.

   Bash

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

   Podman 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-podman-agent:
       image: status200/podman-agent:release
       container_name: status200-podman-agent
       user: "0:0"
       restart: unless-stopped
       volumes:
         - /run/podman/podman.sock:/run/podman/podman.sock:ro
         - /var/lib/containers/storage:/var/lib/containers/storage:ro
       environment:
         - STATUS200_URL=YOUR_STATUS200_URL
         - STATUS200_SERVICE_TOKEN=YOUR_TELEMETRY_INGESTION_TOKEN
         - PODMAN_HOST_NAME=my-podman-host
       logging:
         driver: json-file
         options:
           max-size: "10m"
           max-file: "3"
     status200-podman-ai-agent:
       image: status200/resource-ai-agent:release
       container_name: status200-podman-ai-agent
       user: "0:0"
       restart: unless-stopped
       read_only: true
       tmpfs:
         - /tmp
       volumes:
         - /run/podman/podman.sock:/run/podman/podman.sock:ro
       environment:
         - STATUS200_URL=YOUR_STATUS200_URL
         - STATUS200_SERVICE_TOKEN=YOUR_TELEMETRY_INGESTION_TOKEN
         - STATUS200_AI_AGENT_RESOURCE_TYPE=podman
         - PODMAN_HOST_NAME=my-podman-host

   Inicie-o nessa pasta:

   Bash

   podman compose up -d

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

   Bash

   podman ps --filter name=status200-podman-agent
   podman logs -f status200-podman-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 → Podman → Todos os hosts. O host aparece com o PODMAN_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 (Podman CLI), ou edite docker-compose.yml e execute podman compose up -d (Podman 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 Podman lista cada métrica e o que ela significa.

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

O agente acompanha /var/lib/containers/storage/overlay-containers/*/userdata/ctr.log, os arquivos que o driver de log k8s-file do Podman grava (json-file é o mesmo driver no Podman). O driver padrão do Podman rootful é journald, que não deixa arquivo para ler, e o mesmo vale para um driver remoto como syslog. As métricas de um contêiner assim continuam chegando; os logs, não.

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

podman inspect <container> --format '{{.HostConfig.LogConfig.Type}}'
podman info --format '{{.Host.LogDriver}}'

Execute um contêiner com k8s-file, ou mude um serviço do Compose para ele:

podman run --log-driver k8s-file --log-opt max-size=100m ... <image>

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

Ou torne-o o padrão para todo contêiner criado depois, em containers.conf (/etc/containers/containers.conf no modo rootful, ~/.config/containers/containers.conf no modo rootless):

[containers]
log_driver = "k8s-file"
log_size_max = 104857600

Depois 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.

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

podman compose pull
podman compose up -d

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

Desinstalando o agente#

podman rm -f status200-podman-agent
podman rm -f status200-podman-ai-agent

podman 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 Podman e o docker-compose.yml no [diretório PodmanAgent](<YOUR_STATUS200_URL>/docs/static/scripts/agents/PodmanAgent) dele executam todos o Agente de IA do Podman: um segundo contêiner, status200-podman-ai-agent (imagem status200/resource-ai-agent:release), que executa os comandos somente leitura que a Status200 AI pede enquanto investiga um incidente ou alerta neste host — pela API compatível com Docker do Podman, com a CLI docker: docker ps -a, docker logs --tail 200 web, docker container inspect web — 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 PODMAN_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 precisa do mesmo socket que o coletor e é executado como root com ele montado, porque o socket pertence ao root — e, no Podman rootful, 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).
• install.sh --no-ai-agent o deixa de fora; podman rm -f status200-podman-ai-agent o remove. Atualize-o como o coletor: podman 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

curl -s -o /dev/null -D - --unix-socket /run/podman/podman.sock http://localhost/_ping | grep -i '^api-version'

podman run -d ... -e DOCKER_API_VERSION= ...

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

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

Próximos passos#