Auto-hébergement

Uptime Kuma et Beszel : pourquoi les opérateurs de homelab utilisent les deux outils de surveillance

Une comparaison pratique montre qu'Uptime Kuma vérifie les points d'accès des services tandis que Beszel suit les ressources des hôtes, ce qui amène de nombreux ingénieurs à déployer les deux pour une visibilité complète.

Illustration combinant les vérifications de disponibilité des services et les métriques de surveillance des ressources de l'hôte
Illustration créée pour cet article

Traduit automatiquement depuis l’original en anglais.

Les passionnés d'auto-hébergement et les responsables informatiques associent de plus en plus deux outils de surveillance distincts pour obtenir une visibilité totale sur leur infrastructure. Une analyse détaillée publiée le 20 novembre 2026 souligne comment Uptime Kuma et Beszel résolvent des problèmes différents, incitant de nombreux opérateurs à les exécuter côte à côte plutôt que de choisir l'un au détriment de l'autre.

Ce qui s'est passé

La distinction fondamentale réside dans ce que chaque outil mesure. Uptime Kuma fonctionne comme un vérificateur externe de points d'accès. Il vérifie si un service répond sur un port, une URL ou un enregistrement DNS spécifique en initiant des connexions à intervalles définis. Si une vérification échoue, il consigne le temps de réponse et déclenche des alertes via plus de 90 plateformes prises en charge, dont Discord, Telegram et l'e-mail. Il fonctionne indépendamment du système d'exploitation de la cible, ce qui le rend idéal pour confirmer que les applications sont accessibles depuis le réseau.

Beszel, en revanche, agit comme un moniteur d'hôte léger. Il utilise une architecture hub-and-spoke (centre et rayons) où un centre collecteur rassemble les données provenant d'agents installés sur des machines physiques ou virtuelles. Ces agents extraient directement les métriques internes du noyau Linux et des sockets Docker, suivant la charge CPU, l'utilisation de la RAM, l'activité swap et les E/S disque. Cette approche offre un aperçu des goulots d'étranglement en matière de ressources que les vérifications externes pourraient manquer, comme une fuite de mémoire lente qui n'a pas encore provoqué de crash.

Les utilisateurs expérimentés de homelab recommandent désormais de déployer les deux outils simultanément. Les vérifications de points d'accès seules ne peuvent pas avertir de l'épuisement des ressources avant qu'une application ne tombe complètement en panne, tandis que les métriques de l'hôte ne révèlent pas si une application génère des erreurs internes malgré des niveaux de CPU et de RAM sains. L'exécution des deux fournit une vue complète à la fois de la disponibilité des services et de la santé du système.

Détails clés

  • Uptime Kuma stocke sa configuration dans une base de données SQLite locale située dans /app/data, qui doit être montée sur un système de fichiers local rapide pour éviter toute corruption due aux problèmes de verrouillage des partages réseau.
  • Beszel utilise un modèle d'agent sécurisé avec des clés cryptographiques Ed25519, garantissant que seuls les centres autorisés peuvent demander des métriques aux agents écoutant sur le port 45876.
  • Uptime Kuma prend en charge les moniteurs push pour les tâches cron, permettant aux scripts d'envoyer un signal de vie (heartbeat) via curl ; si aucune requête n'arrive dans la fenêtre définie, la tâche est marquée comme échouée.
  • Les agents Beszel consomment moins de 20 Mo de RAM, et le centre tourne autour de 50 Mo, ce qui le rend adapté aux environnements contraints en ressources comme les anciens mini-PC.
  • Les deux outils nécessitent des proxys inverses avec le support WebSocket activé pour gérer les mises à jour des tableaux de bord en temps réel et assurer la terminaison SSL sécurisée.
  • Le mappage du socket Docker vers Uptime Kuma accorde un contrôle de niveau root sur l'hôte, posant un risque de sécurité si l'instance est compromise.

Contexte

La surveillance d'une infrastructure auto-hébergée implique généralement deux couches : la disponibilité et la performance. La surveillance de la disponibilité vérifie si un service est actif et répond aux requêtes, similaire au ping d'un site web. La surveillance des performances regarde à l'intérieur du serveur pour voir à quel point le matériel travaille, en suivant des métriques comme la pression mémoire et la vitesse disque. Les piles traditionnelles d'entreprise comme Prometheus et Grafana peuvent gérer les deux, mais nécessitent une configuration importante et beaucoup de ressources. Des outils légers comme Uptime Kuma et Beszel visent à simplifier cela pour les petites configurations, en mettant l'accent sur la facilité de déploiement et la faible surcharge.

SQLite, utilisé par Uptime Kuma, est une base de données basée sur fichier qui repose sur des mécanismes stricts de verrouillage de fichiers. Lorsqu'elle est stockée sur des systèmes de fichiers réseau comme NFS ou SMB, ces verrous échouent souvent, entraînant une corruption des données. C'est un piège courant pour les utilisateurs qui stockent tous leurs volumes Docker sur un stockage attaché au réseau par commodité. De même, l'accès au socket Docker est une permission puissante mais dangereuse, permettant à tout conteneur y ayant accès de contrôler l'ensemble des conteneurs de l'hôte.

Pourquoi c'est important

Pour les équipes qui hébergent leurs propres logiciels, les angles morts dans la surveillance peuvent entraîner des pannes prolongées. Si vous ne surveillez que les points d'accès, vous risquez de ne pas savoir qu'un serveur manque d'espace disque jusqu'à ce que la base de données plante. Si vous ne surveillez que les ressources de l'hôte, vous risquez de manquer une situation où le serveur web renvoie des erreurs 500 dues à un bug backend, même si l'utilisation du CPU est normale. La combinaison des deux outils garantit la détection à la fois des défaillances d'infrastructure et des défauts au niveau de l'application.

La sécurité est un autre facteur critique. L'article souligne les risques liés à l'exposition directe des tableaux de bord de surveillance sur Internet. Les ports 3001 et 8090 deviennent des cibles pour les attaques par force brute. L'utilisation d'un proxy inverse ajoute une couche de protection nécessaire. De plus, comprendre les permissions accordées aux outils de surveillance, telles que l'accès au socket Docker, aide à prévenir les vulnérabilités d'élévation de privilèges dans votre environnement.

L'efficacité des ressources est également cruciale pour les petites et moyennes entreprises. L'empreinte mémoire réduite de Beszel lui permet de fonctionner sur du matériel économique sans affecter les applications principales. Cela rend la surveillance avancée accessible aux organisations qui ne peuvent pas se permettre de lourdes piles d'observabilité d'entreprise, mais qui ont toujours besoin d'informations fiables sur la santé de leur infrastructure.

Ce que vous pouvez faire

  • Déployez Uptime Kuma et Beszel ensemble en utilisant une pile Docker Compose combinée pour surveiller à la fois la disponibilité des points d'accès et les ressources de l'hôte.
  • Montez les répertoires de données SQLite et PocketBase uniquement sur des systèmes de fichiers locaux, en évitant les partages NFS ou SMB pour prévenir la corruption de la base de données.
  • Placez les deux tableaux de bord de surveillance derrière un proxy inverse avec le support WebSocket activé pour les sécuriser et garantir le bon fonctionnement des mises à jour en temps réel.
  • Évitez de mapper le socket Docker vers Uptime Kuma ; utilisez plutôt des vérifications HTTP et TCP à travers les réseaux Docker pour réduire les risques de sécurité.
  • Configurez les agents Beszel avec des clés cryptographiques uniques générées par le centre pour assurer une collecte de métriques sécurisée et autorisée.
  • Utilisez les moniteurs push d'Uptime Kuma pour les tâches cron critiques et les sauvegardes, en ajoutant un heartbeat curl pour vérifier leur achèvement réussi.

Autres actualités

Toutes les actualités