Installer l'agent Unix

Mis à jour le

L’agent est un programme Python autonome qui lit l’état de la machine et le pousse vers le cockpit. Il n’ouvre aucun port et n’accepte aucune commande venue du réseau : la connexion part toujours de votre serveur.

Prérequis

  • Debian 11+ ou Ubuntu 20.04+ (les autres distributions viendront ; l’agent lui-même n’utilise que la bibliothèque standard de Python 3.9+).
  • Un accès sudo le temps de l’installation.
  • Un accès sortant en HTTPS vers votre instance StatHall.

Installation

Créez la cible serveur dans le cockpit : Cibles → Nouvelle cible → Serveur. Le jeton et la commande complète s’affichent alors — le jeton une seule fois.

La commande ajoute le dépôt de paquets signé, installe stathall-agent, écrit la configuration avec votre jeton et démarre le service.

Vérifier

systemctl status stathall-agent
journalctl -u stathall-agent -n 50 --no-pager

Côté cockpit, la fiche du serveur passe de « en attente » à « connecté » dans la minute qui suit, et les premières métriques apparaissent au cycle suivant.

Ce que l’agent lit

Charge, mémoire, disques et inodes, températures et SMART, unités systemd, conteneurs Docker et les images qu’ils font tourner, mises à jour de sécurité en attente, inventaire des paquets installés, et les journaux réduits à leur motif — les nombres, adresses et identifiants sont remplacés par des marqueurs avant l’envoi.

Pour les images, l’agent compare celle qui tourne à celle que son tag désigne sur la machine, et note d’où elle vient. C’est le cockpit, pas la machine, qui demande ensuite au registre public d’origine si une version plus récente existe ; le nom d’une image construite chez vous n’est jamais envoyé.

Ce qu’il n’atteint jamais

Le contenu de vos fichiers, vos bases de données, vos variables d’environnement, vos clés. Il n’exécute aucune commande reçue du cockpit : cette voie n’existe pas dans le protocole.

Mettre à jour, désinstaller

sudo apt update && sudo apt install --only-upgrade stathall-agent
sudo apt remove --purge stathall-agent

La désinstallation retire le service, la configuration et le jeton local. Révoquez aussi le jeton côté cockpit : c’est le geste qui coupe réellement l’accès.