HYPHApar S33D
Documentation › Installer l'agent

Lancer l'agent en conteneur Docker

L'image de l'agent observe l'hôte qui la porte, ses processus, son réseau et ses conteneurs.

Lancer

docker run -d --name hypha-agent --restart unless-stopped --network host --pid host \
  --cap-add SYS_PTRACE --security-opt apparmor=unconfined \
  -v /proc:/host/proc:ro -v /sys:/host/sys:ro -v /:/host/root:ro \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v hypha-agent:/var/lib/hypha \
  -e HYPHA_API_KEY=hph_votre_cle -e HYPHA_URL=https://hypha.s33d.fr \
  registre-vm.s33d.fr/hypha/agent-docker:0.4.21

La page Réglages › Installer l'agent, onglet Docker, donne la commande avec la version publiée du moment.

OptionPourquoi
--network host, --pid hostvoir le réseau et les processus de l'hôte, pas ceux du conteneur
--cap-add SYS_PTRACE, apparmor=unconfinedrattacher chaque connexion à son processus
/proc, /sys, / en lecture seulemesures du système et des disques de l'hôte
docker.sock en lecture seuleliste et mesures des conteneurs
volume hypha-agentidentité de l'agent et tampon d'envoi, gardés d'un redémarrage à l'autre

Suivre des fichiers journaux

L'image ne lit pas le journal systemd de l'hôte : pour lui, installez l'agent sur l'hôte (Linux). Pour suivre des fichiers, montez-les puis montez une configuration qui les déclare :

-v /var/log/nginx:/host/log/nginx:ro \
-v /etc/hypha/hypha.yaml:/etc/hypha/hypha.yaml:ro
logs:
  enabled: true
  journald: false
  files:
    - {path: /host/log/nginx/*.log, service: nginx, source: nginx}

HYPHA_API_KEY et HYPHA_URL passés par -e l'emportent sur le fichier.

Ce qui change en conteneur

Relais OpenTelemetry et StatsD

Avec --network host, les applications de l'hôte joignent le relais OTLP de l'agent sur 127.0.0.1:4318 et StatsD sur 127.0.0.1:8125/udp. Activez otlp.enabled: true dans la configuration montée. Voir Traces.

Mise à jour : 19 novembre 2026