Agent Podman

L'agent Podman di Status200 è un container che esegui su un host Podman. Legge le statistiche e i file di log di ogni container dell'host e li invia a Status200, dove l'host compare con i suoi container, le metriche e i log. Un secondo container, l'agente IA Podman, permette a Status200 AI di indagare sull'host. I monitor Podman generano avvisi in base a ciò che l'agent invia.

Come funziona#

L'agent è un OpenTelemetry Collector con la configurazione di Status200 integrata. Tramite il socket dell'API compatibile con Docker di Podman legge le statistiche di ogni container ogni 30 secondi ed elenca ogni container, immagine, rete e volume ogni 5 minuti. Segue i file di log dei container e invia tutto al tuo URL di Status200 tramite OTLP, con la chiave di acquisizione che gli fornisci.

L'host si registra con i suoi primi dati, con il nome che gli dai in PODMAN_HOST_NAME. L'agente IA è opzionale: se lo ometti, il collector funziona allo stesso modo.

Prima di iniziare#

• Podman 4.0 o successivo, e accesso root sull'host.
• Il socket dell'API di Podman in /run/podman/podman.sock. Attivalo con sudo systemctl enable --now podman.socket.
• Una chiave di acquisizione. Creane una in Impostazioni del progetto → Telemetria e APM → Chiavi di acquisizione e copiane il valore.
• HTTPS in uscita dall'host verso il tuo URL di Status200.
• Per i log dei container, container che usano il driver di log k8s-file. Podman in modalità rootful scrive i log in journald per impostazione predefinita, che l'agent non può leggere. Vedi I log dei container richiedono il driver k8s-file.

Installa l'agent#

1. Avvia l'agent#

   Sostituisci YOUR_STATUS200_URL con il tuo URL di Status200, YOUR_TELEMETRY_INGESTION_TOKEN con la chiave di acquisizione e my-podman-host con un nome per questo host, come prod-podman-01. Il nome è quello con cui l'host compare in Status200, quindi mantienilo stabile: un nome nuovo registra un nuovo host.

   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

   Poi avvia accanto l'agente IA, con gli stessi valori. Le indagini IA sono attive per impostazione predefinita: mentre Status200 AI indaga su un incidente o un avviso su questo host, esegue comandi docker in sola lettura tramite l'agente IA, sull'API compatibile con Docker di Podman, e non modifica nulla a meno che tu non consenta le correzioni. Per installare senza indagini IA, salta questo 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

   Salva questo file come docker-compose.yml in una cartella sull'host. Il secondo servizio è l'agente IA: omettilo per eseguire il collector senza indagini 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

   Avvialo in quella cartella:

   Bash

   podman compose up -d

2. Verifica che l'agent sia in esecuzione#

   Bash

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

   I log dovrebbero mostrare questa riga una volta avviato il collector:

   Everything is ready. Begin running and processing data.

3. Trova l'host in Status200#

   Apri Prodotti → Infrastruttura → Podman → Tutti gli host. L'host compare con il suo PODMAN_HOST_NAME entro un minuto circa, con i suoi container, le metriche e i log. L'agente IA risulta connesso nella pagina Agente IA dell'host e in fondo alla sua Panoramica. La pagina Topologia dell'host disegna i suoi progetti Compose, container, immagini, reti e volumi su un'unica mappa: vedi Topologia.

Variabili d'ambiente#

Per cambiare un valore, rimuovi l'agent ed esegui di nuovo il suo comando (Podman CLI), oppure modifica docker-compose.yml ed esegui podman compose up -d (Podman Compose).

Cosa raccoglie l'agent#

Le metriche e i log di ogni container vengono archiviati sotto un servizio con il nome del container. Ogni riga di log riceve una severità in base al livello che indica, come [ERROR], level=warn o {"level":"info"}; una riga che non ne indica nessuno prende quella del suo flusso: stderr è ERROR, stdout è INFO. Le righe che iniziano con uno spazio o una parentesi di chiusura vengono unite alla riga precedente, quindi uno stack trace arriva come un unico record. I log dell'agent stesso vengono esclusi.

Monitor Podman elenca ogni metrica e il suo significato.

I log dei container richiedono il driver k8s-file#

L'agent segue /var/lib/containers/storage/overlay-containers/*/userdata/ctr.log, i file che scrive il driver di log k8s-file di Podman (json-file è lo stesso driver in Podman). Il driver predefinito di Podman in modalità rootful è journald, che non lascia alcun file da leggere, e lo stesso vale per un driver remoto come syslog. Le metriche di un container del genere arrivano comunque; i suoi log no.

Controlla il driver di log di un container e quello predefinito di Podman:

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

Esegui un container con k8s-file, oppure passa a esso un servizio Compose:

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"

Oppure rendilo il predefinito per ogni container creato in seguito, in containers.conf (/etc/containers/containers.conf in modalità rootful, ~/.config/containers/containers.conf in modalità rootless):

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

Poi ricrea i container. Un container mantiene il driver di log con cui è stato creato, quindi riavviarlo non basta.

Aggiornare l'agent#

Quando l'agent è più vecchio del tuo Status200, compare un segnale di avviso accanto a Versione dell'agente nella Panoramica dell'host. Selezionalo per vedere questi comandi.

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

Il tag release punta sempre alla release più recente. Per fissare una versione, usa status200/podman-agent:<version>, come status200/podman-agent:10.0.31. La stessa immagine si trova nel GitHub Container Registry come ghcr.io/status200/podman-agent:release.

Disinstallare l'agent#

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

podman compose down

L'host resta in Status200 con i dati che ha inviato. Se non ti serve più, eliminalo con Elimina host nel suo menu.

Agente IA#

I comandi e il file Compose qui sopra, l'install.sh dell'agent Podman e il docker-compose.yml nella sua [directory PodmanAgent](<YOUR_STATUS200_URL>/docs/static/scripts/agents/PodmanAgent) eseguono tutti l'Agente IA Podman: un secondo container, status200-podman-ai-agent (immagine status200/resource-ai-agent:release), che esegue i comandi in sola lettura richiesti da Status200 AI mentre indaga su un incidente o un avviso su questo host — tramite l'API compatibile con Docker di Podman, con la CLI docker: docker ps -a, docker logs --tail 200 web, docker container inspect web — e, solo se lo consenti, applica correzioni come il riavvio di un container specifico. Legge gli stessi STATUS200_URL, STATUS200_SERVICE_TOKEN e PODMAN_HOST_NAME del collector, quindi serve esattamente questo host, e compare nella pagina Agente IA dell'host in Status200.

• Le indagini IA sono attive per impostazione predefinita. Appena l'agent si connette, Status200 AI lo usa per indagare sugli incidenti e sugli avvisi di questo host, e la Panoramica dell'host mostra lo stato dell'agent. Per fermarlo, imposta STATUS200_AI_INVESTIGATION=false dove viene eseguito l'agent (Cambia sotto Cosa può fare l'IA, nella pagina dell'agente IA, mostra come), oppure ometti l'agent.
• È in sola lettura a meno che tu non lo avvii con STATUS200_AI_ALLOW_WRITES=true; STATUS200_AI_WRITE_TARGETS (per esempio web-*,api-*) limita i container che una correzione può toccare. Avvialo anche con STATUS200_AI_FIXES per indicare come vengono eseguite le correzioni — ask-for-approval (una persona approva ciascuna), automatic o bypass-approval — e la pagina dell'agente IA lo mostra in sola lettura (Cosa può fare l'IA, impostato dall'agent).
• Richiede lo stesso socket del collector e viene eseguito come root con il socket montato, perché il socket appartiene a root — e per Podman in modalità rootful chi può usare il socket è root su questo host, :ro o no. Il limite è la policy dei comandi dell'agent: non esegue mai exec, run, rm o prune, e non modifica mai sé stesso, il collector o qualsiasi cosa in STATUS200_AI_PROTECTED_TARGETS (glob di nomi di container).
• install.sh --no-ai-agent lo omette; podman rm -f status200-podman-ai-agent lo rimuove. Aggiornalo come il collector: podman pull status200/resource-ai-agent:release, rimuovilo e avvialo di nuovo.

Cosa può eseguire, come funzionano le correzioni e come risolverne i problemi: Infrastructure AI Agents.

Risoluzione dei problemi#

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

Passaggi successivi#