Beszel, l'outil d'infrastructure à connaître
Deux binaires, 17 Mo d'images et un historique par conteneur : pourquoi Beszel mérite une place dans ta boîte à outils d'infrastructure.
L'image Docker de l'agent pèse 4,4 Mo. Tu la poses sur un serveur, tu colles deux variables d'environnement, et la machine apparaît dans un dashboard qui tourne ailleurs. Beszel prend l'exact contre-pied de Prometheus : l'agent pousse ses métriques vers un hub central au lieu d'exposer un endpoint que le serveur de collecte vient aspirer.
Toutes les tailles sont vérifiées sur Docker Hub : 12,8 Mo pour le hub, 4,4 Mo pour l'agent, dernière publication des tags latest le 22 octobre 2026. Ce n'est pas le genre de chiffre qu'on voit sur une stack d'observabilité classique.
Un hub, un agent, et rien d'autre
L'architecture tient en deux composants. Le hub est une application web bâtie sur PocketBase, donc une base SQLite et une UI servies par un seul binaire. L'agent tourne sur chaque machine à surveiller et se connecte au hub par websocket.
Sur un serveur isolé, tu peux même éviter le réseau : le hub et l'agent partagent un socket Unix monté dans les deux conteneurs. Voilà le squelette du docker-compose.yml fourni par la doc officielle :
services:
beszel:
image: henrygd/beszel:latest
restart: unless-stopped
ports:
- "8090:8090"
environment:
APP_URL: https://beszel.mondomaine.fr
volumes:
- ./beszel_data:/beszel_data
- ./beszel_socket:/beszel_socket
beszel-agent:
image: henrygd/beszel-agent:latest
restart: unless-stopped
network_mode: host
volumes:
- ./beszel_socket:/beszel_socket
- /var/run/docker.sock:/var/run/docker.sock:ro
environment:
LISTEN: /beszel_socket/beszel.sock
HUB_URL: http://localhost:8090
TOKEN: "ton-token"
KEY: "ta-cle-publique"Le montage de docker.sock en lecture seule est ce qui débloque les stats par conteneur. C'est la fonctionnalité qui justifie à elle seule l'installation, j'y reviens juste après.
Ce que l'agent remonte vraiment
La liste des métriques est plus large que ce que la promesse « léger » laisse deviner. Côté hôte : CPU, mémoire avec swap et ZFS ARC, occupation et I/O par partition, réseau, load average, température, vitesse des ventilateurs via /sys/class/hwmon, et consommation des GPU Nvidia, AMD ou Intel.
Côté stockage, l'agent lit le S.M.A.R.T. des disques et remonte l'usure des eMMC ainsi que l'état des arrays mdraid. Sur un mini-PC ou un Raspberry qui tourne sur carte SD, c'est la métrique qui t'évite une panne muette six mois plus tard.
Il y a aussi les sondes réseau actives : ICMP, TCP, HTTP et DNS, exécutées depuis l'agent. Tu surveilles donc la réponse d'un service depuis chaque machine, pas depuis un point central qui ne voit qu'une partie du chemin.
Et les conteneurs, enfin. CPU, mémoire et réseau par conteneur, avec l'historique. Quand une image part en fuite mémoire à 3 h du matin, tu sais lequel des douze services est responsable sans ouvrir un terminal.
Les alertes qui servent le jour où ça casse
Chaque métrique importante accepte un seuil, et le hub envoie la notification vers un webhook générique, Telegram ou un service de messagerie. Concrètement, je pose une alerte mémoire à 90 % maintenue cinq minutes : un pic de build ne déclenche rien, une fuite réelle oui.
Le vrai confort, c'est l'alerte disque. Un seuil à 85 % sur / avec notification, et tu as le temps de nettoyer les logs et les images Docker avant que Postgres refuse d'écrire. C'est basique, et c'est exactement ce que 80 % des petits serveurs n'ont pas.
Le hub gère aussi plusieurs utilisateurs, l'authentification OAuth/OIDC avec possibilité de couper le mot de passe, et une sauvegarde automatique des données vers un stockage compatible S3. Sur un outil de monitoring, la sauvegarde de la config compte : la reconstruction d'un dashboard à la main est une corvée.
Là où je ne l'attends pas
Beszel ne parle pas PromQL et ne remplace pas un serveur de métriques applicatives. Pas d'histogrammes de latence par route, pas d'exemplars, pas de dashboards composables à partager avec une équipe produit. Ce n'est pas son terrain, et forcer l'outil dessus te coûtera plus qu'une stack classique.
Ma règle est simple, et je l'assume : Prometheus et OpenTelemetry pour l'instrumentation du code, Beszel pour l'état de la machine. J'ai détaillé la maintenance d'un Prometheus de production dans ce retour d'expérience, et les deux outils cohabitent très bien.
Le poser derrière Traefik en quelques labels
Le hub écoute en clair sur 8090. Pour l'exposer proprement, tu le déclares comme n'importe quel service dans ton reverse proxy :
labels:
- "traefik.enable=true"
- "traefik.http.routers.beszel.rule=Host(`beszel.mondomaine.fr`)"
- "traefik.http.routers.beszel.entrypoints=websecure"
- "traefik.http.routers.beszel.tls.certresolver=letsencrypt"
- "traefik.http.services.beszel.loadbalancer.server.port=8090"Pense à poser une protection devant, un basicauth Traefik suffit, ou l'OIDC intégré au hub si tu as déjà un fournisseur d'identité. La configuration complète du proxy est dans ce guide Traefik.
Trois cas où je le déploie sans hésiter
- Un seul VPS qui héberge dix conteneurs. Le hub prend 8090, l'agent surveille le même hôte, et tu as un historique gratuit en dix minutes.
- Une flotte de petites machines chez plusieurs hébergeurs. Depuis la version 0.12.0, un token universel dans
/settings/tokenspermet de brancher un agent sans le déclarer à l'avance dans l'interface. - Un parc Docker où personne ne sait ce qui consomme. Les stats par conteneur remplacent trois scripts
docker statsbricolés dans un cron.
Verdict
Installation en dix minutes, images de 17 Mo au total, alertes utiles, sauvegarde S3, licence MIT : à ce niveau de rapport simplicité/valeur, l'outil mérite une place dans ta boîte à outils d'infrastructure. La version courante, 0.21.0, est déjà stable sur les fonctions de base.
Le revers de la médaille, c'est un projet jeune, porté par une équipe très réduite. Garde une sauvegarde de tes données et ne mets pas tous tes œufs d'observabilité dedans. Pour le reste, surveiller l'hôte et les conteneurs sans monter une usine à gaz, c'est exactement le trou que Beszel comble.