Installer l'Agent Watchflare sous macOS

Installez l'agent Watchflare sous macOS via Homebrew. Couvre l'installation en une commande, la configuration manuelle, la gestion du service launchd et le réenrôlement.

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

Avant de commencer, créez l’hôte dans le tableau de bord Watchflare (Hosts → Add host) et copiez le jeton d’enrôlement.

Installation en une commande (recommandée)

Cette commande installe l’agent via Homebrew, l’enrôle auprès du Hub et démarre le service en une seule étape :

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

L’hôte passe de pending à online dans le tableau de bord dans les 5 secondes.

Attention

Les jetons d’enrôlement expirent au bout de 24 heures. Lancez la commande d’installation avant que le jeton n’expire.

Astuce

Vous faites tourner Docker Desktop ou Colima sur ce Mac ? Ajoutez --containers pour collecter les métriques CPU, mémoire et réseau par conteneur. Voir Métriques de conteneurs Docker/Podman.

Installation manuelle

Étape 1 : Ajouter le tap et installer

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

Étape 2 : Enrôler

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

Étape 3 : Démarrer le service

brew services start watchflare-agent

Gestion du service

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

Suivez les journaux :

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

Emplacement des fichiers

$(brew --prefix) vaut /opt/homebrew sur Apple Silicon et /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/`	Dossier de données
`$(brew --prefix)/var/watchflare/metrics.wal`	Write-Ahead Log
`$(brew --prefix)/var/watchflare/packages.state.json`	État de l’inventaire des paquets
`$(brew --prefix)/var/log/watchflare-agent.log`	Journaux

Réenrôler

Pour connecter l’agent à un autre Hub, ou après avoir supprimé puis recréé un hôte :

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 enrôlé	Exécutez `watchflare-agent register ...`
`connection refused`	Mauvais hôte/port	Vérifiez que le port 50051 est joignable
`Invalid agent credentials`	Clé qui ne correspond pas	Réenrôlez l’agent
L’hôte reste offline après le démarrage	Horloge désynchronisée	Vérifiez l’horloge système, car le Hub refuse les horodatages décalés de ±5 min

Consultez les journaux récents :

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

Vérifiez l’état du service :

brew services list | grep watchflare

Installer sans Homebrew

Si vous ne pouvez pas utiliser Homebrew, l’agent peut être compilé depuis les sources. Go 1.26+ est requis. Consultez le dépôt source pour les instructions de compilation. Utilisez les variables d’environnement WATCHFLARE_CONFIG_DIR et WATCHFLARE_DATA_DIR pour pointer l’agent vers des chemins personnalisés, et lancez-le à la main ou avec votre propre gestionnaire de services.

Remarque

Un installeur macOS autonome (sans dépendance Homebrew) est prévu pour une version ultérieure.