Kula : Surveillance de serveur Linux autonome sans aucune dépendance.

Ce que fait Kula

Kula collecte les métriques système chaque seconde en lisant directement depuis /proc et /sys, les stocke dans un moteur de stockage à tampon circulaire à plusieurs niveaux intégré, et les sert via un tableau de bord web en temps réel et une interface utilisateur en terminal (TUI).

Métriques collectées

• CPU : Utilisation totale (utilisateur, système, iowait, irq, softirq, steal) + nombre de cœurs
• Charge : Moyennes 1/5/15 min, tâches en cours & totales
• Mémoire : Totale, libre, disponible, utilisée, tampons, cache, shmem
• Swap : Totale, libre, utilisée
• Réseau : Débit par interface (Mbps), paquets/s, erreurs, pertes ; erreurs TCP/s, réinitialisations/s, connexions établies ; nombre de sockets
• Disques : E/S par périphérique (octets lus/écrits/s, lectures/s, écritures/s IOPS) ; utilisation du système de fichiers
• Système : Temps de fonctionnement, entropie, synchronisation d'horloge, nom d'hôte, nombre d'utilisateurs connectés
• Processus : Nombre en cours d'exécution, en sommeil, bloqués, zombies
• Auto-surveillance : % CPU de Kula, mémoire RSS, descripteurs de fichiers ouverts

Moteur de stockage

Les données sont persistées dans des fichiers de tampon circulaire pré-alloués par niveau avec des tailles maximales fixes. Lorsqu'un fichier est plein, les nouvelles données écrasent les entrées les plus anciennes.

• Niveau 1 : Échantillons bruts d'une seconde (par défaut 250 Mo)
• Niveau 2 : Agrégats d'une minute : CPU et réseau moyennés, jauges de dernière valeur (par défaut 150 Mo)
• Niveau 3 : Agrégats de 5 minutes, même logique (par défaut 50 Mo)

Fonctionnalités du tableau de bord

Le serveur HTTP expose une API REST et un point de terminaison WebSocket pour la diffusion en direct. L'authentification est facultative - lorsqu'elle est activée, elle utilise le hachage Argon2id avec sel et cookies de session. Le frontend est une application à page unique intégrée dans le binaire avec des fonctionnalités incluant :

• Zoom interactif avec sélection par glisser-déposer (met en pause automatiquement le flux en direct)
• Mode focus pour afficher uniquement les graphiques sélectionnés
• Basculer entre disposition en grille / liste empilée
• Système d'alerte pour la synchronisation d'horloge, les problèmes d'entropie, la surcharge

Installation

Exemples de méthodes d'installation pour GNU/Linux amd64 (x86_64). Consultez les versions pour les paquets ARM et RISC-V.

Autonome

wget https://github.com/c0m4r/kula/releases/download/0.7.1/kula-0.7.1-amd64.tar.gz
echo " 6baff6bee9f9bbf56adc6e264e7ff9e1dfa763e7bab76a21dbc1e7d4be0397f4 kula-0.7.1-amd64.tar.gz " | sha256sum -c || rm kula-0.7.1-amd64.tar.gz
tar -xvf kula-0.7.1-amd64.tar.gz
cd kula
./kula

Debian/Ubuntu

wget https://github.com/c0m4r/kula/releases/download/0.7.1/kula_0.7.1_amd64.deb
echo " bbcd6ee65441c85f5bc835c40a1afaabc78b78d976c25e535c051b29ad514185 kula_0.7.1_amd64.deb " | sha256sum -c || rm kula_0.7.1_amd64.deb
sudo dpkg -i kula_0.7.1_amd64.deb
systemctl status kula

Compilation depuis les sources

git clone https://github.com/c0m4r/kula.git
cd kula
bash addons/build.sh

Utilisation

Démarrage rapide

# 1. Copier et modifier la configuration (facultatif)
cp config.example.yaml config.yaml
# 2. Démarrer le serveur
./kula serve
# Tableau de bord à http://127.0.0.1:8080
# 3. Ou utiliser l'interface utilisateur en terminal
./kula tui

Authentification (Facultative)

# Générer le hachage du mot de passe
./kula hash-password
# Ajouter la sortie à config.yaml sous web.auth

Le projet est actuellement en version 0.7.1 et l'auteur note qu'il présente encore quelques imperfections et doit mûrir, mais il est déjà utilisé sur plusieurs serveurs en production.