addon

docs/INSTRUCTIONS_BENCHMARK.md

@@ -0,0 +1,138 @@
+# Instructions - Exécuter un Benchmark Complet
+
+## 🎯 Problème Actuel
+
+Les données affichées sont incomplètes car le dernier benchmark du device "aorus" (ID: 2) est **ancien** et ne contient pas toutes les informations :
+
+### Données manquantes :
+- ❌ **CPU Cores** : 0 (au lieu du nombre réel)
+- ❌ **RAM utilisée** : null
+- ❌ **RAM libre** : null
+- ❌ **SMART disques** : null (pas de température ni statut)
+- ❌ **Layout RAM** : null (pas de détail des barrettes)
+- ❌ **Vitesse réseau** : null
+
+## ✅ Solution : Lancer un Nouveau Benchmark
+
+### Option 1 : Benchmark Local (machine actuelle)
+
+```bash
+cd /home/gilles/Documents/vscode/serv_benchmark
+sudo bash scripts/bench.sh
+```
+
+**Ce script va** :
+1. Collecter toutes les infos hardware (CPU, RAM, disques, réseau)
+2. Exécuter les benchmarks (CPU, mémoire, disque, réseau)
+3. Envoyer les données au backend
+
+**Durée** : ~3-5 minutes
+
+### Option 2 : Benchmark sur une Autre Machine
+
+Sur la machine distante :
+```bash
+curl -s http://<IP_SERVEUR>:8087/scripts/bench.sh | sudo bash
+```
+
+Remplacez `<IP_SERVEUR>` par l'IP de votre serveur (ex: 10.0.0.50)
+
+## 📊 Après le Benchmark
+
+Une fois le benchmark terminé, rafraîchissez la page :
+```
+http://localhost:8087/device_detail.html?id=2
+```
+
+**Vous devriez voir** :
+- ✅ CPU Cores : 12 (au lieu de 0)
+- ✅ CPU Threads : 24
+- ✅ RAM utilisée : XX GB (%)
+- ✅ RAM libre : XX GB
+- ✅ Disques avec température (si SMART activé)
+- ✅ Layout RAM détaillé (si dmidecode fonctionne)
+
+## 🔍 Vérifier les Données Actuelles
+
+### Check API
+```bash
+curl http://localhost:8007/api/devices/2 | jq '{
+  cpu_cores: .last_hardware_snapshot.cpu_cores,
+  cpu_threads: .last_hardware_snapshot.cpu_threads,
+  ram_used: .last_hardware_snapshot.ram_used_mb,
+  ram_free: .last_hardware_snapshot.ram_free_mb,
+  storage_json: (.last_hardware_snapshot.storage_devices_json | length),
+  ram_layout: .last_hardware_snapshot.ram_layout_json
+}'
+```
+
+### Données Attendues (après benchmark)
+```json
+{
+  "cpu_cores": 12,           // Au lieu de 0
+  "cpu_threads": 24,         // OK
+  "ram_used": 12345,         // Au lieu de null
+  "ram_free": 35751,         // Au lieu de null
+  "storage_json": 7,         // Nombre de disques
+  "ram_layout": "[...]"      // JSON des barrettes
+}
+```
+
+## ⚡ Benchmark Rapide (si vous êtes pressé)
+
+Si vous voulez juste tester l'interface sans attendre les benchmarks complets :
+
+```bash
+# Désactiver les benchmarks longs
+export SKIP_BENCHMARKS=1
+sudo bash scripts/bench.sh
+```
+
+Cela collectera uniquement les infos hardware sans les tests de performance.
+
+**Note** : Cette option n'existe pas encore dans le script, il faudrait la coder.
+
+## 🐛 Si le Benchmark Échoue
+
+### Vérifier les permissions
+```bash
+sudo -v
+```
+
+### Vérifier les dépendances
+```bash
+which sysbench fio iperf3 smartctl
+```
+
+### Logs backend
+```bash
+docker compose logs backend --tail 50
+```
+
+## 📝 Données par Device
+
+### Device 1 : lenovo-bureau
+- ✅ Données complètes
+- ✅ Benchmark du 7 décembre 2025
+- ✅ CPU : Intel Core i5-2400
+
+### Device 2 : aorus
+- ⚠️ Données **partielles**
+- ⚠️ Benchmark **ancien**
+- ✅ CPU : AMD Ryzen 9 5900X (mais cores=0)
+- ❌ Besoin d'un **nouveau benchmark**
+
+## 🎯 Action Immédiate
+
+**Lancer maintenant** :
+```bash
+cd /home/gilles/Documents/vscode/serv_benchmark
+sudo bash scripts/bench.sh
+```
+
+Ensuite rafraîchir la page dans le navigateur (Ctrl+Shift+R pour vider le cache).
+
+---
+
+**Temps estimé** : 3-5 minutes
+**Impact** : Toutes les sections seront remplies avec les données à jour