docs(hermes): rapport analyse 2026-06-06_09-30 — 5 fichiers

Analysés : litellm.md, llama_server.md, rag.md, rocm.md, incidents.md
À améliorer : 0/5

Co-Authored-By: Hermes <hermes@funk.lab>
This commit is contained in:
Hermes Bot 2026-06-06 09:32:51 +02:00
parent c1ee4a3ad0
commit 647455206b

View file

@ -0,0 +1,112 @@
# Rapport Hermes — 2026-06-06_09-30
> Branche : `hermes/daily-work` · Fichiers analysés : 5
---
## Résumé
- ✅ À jour : 5
- ⚠️ À améliorer : 0
## ✅ `admin/ia/litellm.md` — 7/10
**Statut** : à_jour
**Résumé** : Documentation complète sur la configuration et l'utilisation de LiteLLM avec des informations sur les modèles, coûts et intégration Ansible, mais présentant des lacunes dans la gestion des modèles CPU.
**Problèmes :**
- Les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) sont manuellement ajoutés dans /etc/litellm/config.yaml alors qu'ils manquent du template Ansible
- La table des coûts Claude contient des caractères non valides ($ dans les colonnes de coût)
- La ligne 'Utilisation courante' manque de chiffres concrets
- Le script hermes-switch n'est pas documenté en détail dans le fichier
**Suggestions :**
- Mettre à jour le template Ansible (config.yaml.j2) pour inclure les modèles CPU
- Corriger le formatage de la table des coûts Claude
- Ajouter des exemples concrets de coûts pour 'Utilisation courante'
- Documenter les paramètres et les étapes du script hermes-switch
**État réel connu de Hermes :**
Les modèles CPU sont présents dans la configuration actuelle mais manquent du déploiement automatique via Ansible, créant un point de fragilité dans le CI/CD
---
## ✅ `admin/ia/llama_server.md` — 8/10
**Statut** : à_jour
**Résumé** : Documentation complète sur la configuration et les performances du llama-server sur gpu-01, avec des instructions opérationnelles et des métriques de surveillance.
**Problèmes :**
- Manque la mention de l'environment variable HSA_OVERRIDE_GFX_VERSION=10.3.0 requise pour ROCm
- Le paragraphe sur les performances mentionne un 'bug parallel' sans expliquer la cause ni la solution
- Les métriques Prometheus ne mentionnent pas les endpoints spécifiques aux instances CPU (1236/1237)
**Suggestions :**
- Ajouter la configuration requise pour ROCm (HSA_OVERRIDE_GFX_VERSION)
- Documenter la solution au bug de parallélisme Hermes
- Spécifier les endpoints metrics pour chaque instance systemd
- Ajouter une note sur la limitation VRAM et les priorités de charge
**État réel connu de Hermes :**
Le setup est opérationnel avec des performances conformes, mais nécessite des ajustements pour optimiser la compatibilité ROCm et la surveillance complète des instances CPU.
---
## ✅ `admin/ia/rag.md` — 8/10
**Statut** : à_jour
**Résumé** : Documentation complète sur l'implémentation RAG du homelab, avec architecture, composants, modèles et procédures de mise à jour.
**Problèmes :**
- Utilisation d'un modèle génératif (Qwen3-8B) pour les embeddings, ce qui limite la discrimination sémantique
- Scores de similarité uniformément élevés (0.90-0.95) indiquant une perte de pertinence dans les résultats
**Suggestions :**
- Déployer un modèle d'embedding dédié comme bge-m3 pour améliorer la précision sémantique
- Mettre à jour la documentation avec les étapes de migration vers un modèle optimisé
- Ajouter des tests de validation des résultats de recherche
**État réel connu de Hermes :**
Le système RAG est actif sur storage-01 avec Qdrant et rag-query. L'index contient 339 chunks, mais les résultats de recherche souffrent de la limitation du modèle actuel.
---
## ✅ `admin/ia/rocm.md` — 9/10
**Statut** : à_jour
**Résumé** : Document détaillé sur la configuration ROCm pour RX 6700XT avec vérifications complètes et état actualisé au 05/06/2026
**Problèmes :**
- Manque une section sur la gestion des mises à jour ROCm
- Aucune mention des limites connues avec Gemma 4
- Le check 'rocm-smi' non disponible n'est pas expliqué
**Suggestions :**
- Ajouter une section sur la surveillance thermique proactive
- Inclure des exemples de scripts pour automatiser les vérifications
- Mettre en évidence les prérequis spécifiques à AlmaLinux 9.7
- Ajouter une note de sécurité sur les accès GPU via sudo
**État réel connu de Hermes :**
ROCm configuré correctement avec HSA_OVERRIDE_GFX_VERSION=10.3.0, noyau 5.14.0, aucun incident signalé, services NFS exportés normalement
---
## ✅ `admin/incidents.md` — 8/10
**Statut** : à_jour
**Résumé** : Document d'historique des incidents technique avec résolutions détaillées et état post-migration
**Problèmes :**
- Formatage markdown incohérent entre tables et sections
- Manque de hiérarchisation visuelle pour les résolutions techniques
- Tableau 'État post-migration' incomplet (colonnes tronquées)
**Suggestions :**
- Ajouter des balises de niveau 3 (#) pour les sections de résolution
- Utiliser des listes à puces pour les étapes de résolution
- Compléter le tableau d'état post-migration avec les colonnes 'Avant/Après'
- Ajouter un résumé visuel des actions clés en fin de document
**État réel connu de Hermes :**
Migration RAID5 → NVMe réussie, système stable, composants déployés sur stockage NVMe (XFS), RAID5 décommissionné
---