Métriques Docker et Podman

CPU, mémoire et réseau par conteneur, depuis Docker et Podman. À activer avec --containers, ou en éditant agent.conf.

L’agent peut remonter CPU, mémoire et réseau par conteneur, Docker ou Podman. Désactivé par défaut : il faut le socket du runtime, et le dire explicitement.

Prérequis : Docker Engine 23.0+ (API v1.44+), ou Podman avec le socket /run/podman/podman.sock.

À l’installation

Passez --containers à l’installeur ou à register :

curl -sSL https://get.watchflare.io | sudo bash -s -- \
  --token wf_reg_YOUR_TOKEN \
  --host YOUR_HUB_IP \
  --containers

Ou à l’enregistrement à la main :

sudo watchflare-agent register \
  --token wf_reg_YOUR_TOKEN \
  --host YOUR_HUB_IP \
  --containers

--containers écrit container_metrics = true dans agent.conf et ajoute watchflare au groupe docker.

Sur un agent déjà en place

Trois gestes.

1. Ajouter watchflare au groupe docker

sudo usermod -aG docker watchflare

2. container_metrics = true dans /etc/watchflare/agent.conf

container_metrics = true

3. Redémarrer l’agent

sudo systemctl restart watchflare-agent

Remarque

Le groupe n’est pris en compte qu’au prochain démarrage du service. Le redémarrage de l’étape 3 charge les deux : groupe et config.

macOS

Sous macOS (Docker Desktop ou Colima), l’agent tourne sous le compte qui a lancé Homebrew. Ce compte voit déjà le socket Docker : pas de groupe à modifier.

--containers à l’enregistrement :

watchflare-agent register \
  --token wf_reg_YOUR_TOKEN \
  --host YOUR_HUB_IP \
  --containers

Puis redémarrez le service :

brew services restart watchflare-agent

Ce qui remonte

Métrique	Description
CPU %	Usage CPU du conteneur, rapporté à tous les cœurs
Mémoire utilisée	Consommation actuelle
Limite mémoire	Limite du conteneur (si elle est posée)
Network RX	Débit entrant (octets/s)
Network TX	Débit sortant (octets/s)

Même intervalle que les métriques système (30 secondes par défaut). Affichage : onglet Containers de la page de l’hôte.

Remarque

Les métriques de conteneurs partent telles quelles, sans passer par le WAL. Si le Hub est injoignable, ces points-là sont perdus. CPU, mémoire, disque et le reste du système restent dans le journal et sont rejoués à la reconnexion.

Vérifier

Après le redémarrage, les journaux doivent mentionner la collecte des conteneurs :

journalctl -u watchflare-agent -n 30

Les chiffres apparaissent dans l’onglet Containers en moins de 30 secondes. Pour le détail : WATCHFLARE_DEBUG=1.

Si l’onglet reste vide :

watchflare est bien dans le groupe docker : groups watchflare
Docker tourne : docker ps
container_metrics = true dans agent.conf