Installer l'Agent Watchflare sous macOS

Installez l'agent Watchflare sous macOS via Homebrew. Une commande, Homebrew à la main, service launchd, changement de Hub.

Prérequis : macOS 11 (Big Sur) ou plus récent, Intel ou Apple Silicon, et Homebrew.

Dans le tableau de bord : Hosts → Add host. Copiez le jeton d’enregistrement.

Une seule commande (recommandé)

Homebrew pose l’agent, l’enrôle auprès du Hub, et démarre le service :

curl -sSL https://get.watchflare.io/brew | bash -s -- \
  --token wf_reg_YOUR_TOKEN \
  --host YOUR_HUB_IP \
  --port 50051

Dans Hosts, le statut passe de pending à online en moins de 5 secondes.

Attention

Le jeton expire au bout de 24 heures. Installez avant.

Astuce

Docker Desktop ou Colima sur ce Mac ? Ajoutez --containers pour remonter CPU, mémoire et réseau par conteneur. Voir Métriques Docker/Podman.

À la main (Homebrew)

1. Ajouter le tap et installer

brew tap watchflare-io/watchflare
brew install watchflare-agent

2. Enrôler

watchflare-agent register \
  --token wf_reg_YOUR_TOKEN \
  --host YOUR_HUB_IP \
  --port 50051

3. Démarrer le service

brew services start watchflare-agent

Service launchd

brew services info watchflare-agent        # état
brew services start watchflare-agent       # démarrer
brew services stop watchflare-agent        # arrêter
brew services restart watchflare-agent     # redémarrer

Suivre les journaux :

tail -f $(brew --prefix)/var/log/watchflare-agent.log

Fichiers

$(brew --prefix) vaut /opt/homebrew sur Apple Silicon, /usr/local sur Intel.

Chemin	Rôle
`$(brew --prefix)/bin/watchflare-agent`	Binaire
`$(brew --prefix)/etc/watchflare/agent.conf`	Config (identifiants)
`$(brew --prefix)/etc/watchflare/ca.pem`	Certificat CA du Hub
`$(brew --prefix)/var/watchflare/`	Données
`$(brew --prefix)/var/watchflare/metrics.wal`	Journal d’écriture anticipée
`$(brew --prefix)/var/watchflare/packages.state.json`	État de l’inventaire des paquets
`$(brew --prefix)/var/log/watchflare-agent.log`	Journaux

Changer de Hub

Pour pointer vers un autre Hub, ou après avoir supprimé puis recréé l’hôte dans le tableau de bord :

brew services stop watchflare-agent
rm $(brew --prefix)/etc/watchflare/agent.conf
rm $(brew --prefix)/etc/watchflare/ca.pem
watchflare-agent register --token wf_reg_YOUR_TOKEN --host YOUR_HUB_IP
brew services start watchflare-agent

Dépannage

Symptôme	Cause	Correctif
`configuration error` (fichier de config introuvable)	Pas encore enrôlé	`watchflare-agent register ...`
`connection refused`	Mauvais hôte/port	Le port 50051 est-il joignable ?
`Invalid agent credentials`	Clé qui ne correspond pas	Réenrôlez l’agent
L’hôte reste hors ligne après le démarrage	Horloge décalée	Vérifiez l’horloge : le Hub refuse un écart de plus de ±5 min

Journaux récents :

tail -50 $(brew --prefix)/var/log/watchflare-agent.log

État du service :

brew services list | grep watchflare

Compiler sans Homebrew

Si Homebrew n’est pas possible, compilez depuis les sources (Go 1.26+). La procédure est dans le dépôt. WATCHFLARE_CONFIG_DIR et WATCHFLARE_DATA_DIR indiquent où l’agent lit et écrit. Lancez-le vous-même, ou via le gestionnaire de services de votre choix.

Remarque

Un installeur macOS autonome, sans Homebrew, est prévu.