Vérification du bon fonctionnement
Voici une checklist de vérification du bon fonctionnement du système, suivie d’un tableau récapitulatif des problèmes possibles en cas d’indisponibilité.
✅ Checklist de vérification du bon fonctionnement
| Élément à vérifier | Procédure de vérification | Statut (✓/✗) |
|---|---|---|
| 1. Containers dans Portainer | Accéder à l’interface Portainer et s’assurer que tous les conteneurs sont en état "Running" : - openwebui, qdrant, postgres, sophia-nodered-openwebui-1- infomaniak-xinference-1, infomaniak-docling-1, infomaniak-portainer_agent-1- searxng, firecrawl-api-1 (et les containers de la stack firecrawl) |
|
| 2. Interface Sophia (OpenWebUI) | Accéder à : https://sophia.vincennes.fr→ Vérifier que la page charge correctement et que l’interface est interactive. |
|
| 3. Interface Node-RED | Accéder à : http://sp26.vincennes.fr:1886→ Vérifier que l’éditeur s’ouvre et que les flux sont actifs. |
|
| 4. Firecrawl (API et message par défaut) | Accéder à : http://sp26.vincennes.fr:3003→ Vérifier que la réponse "SCRAPERS-JS: Hello, world! K8s! "s’affiche. |
|
| 5. Interface Docling | Accéder à : http://sp26.vincennes.fr:5002/ui→ Vérifier que l’interface utilisateur de Docling est accessible. |
|
| 6. XInference et modèle de reranking | 1. Accéder à l’interface XInference via le tunnel : http://sp26.vincennes.fr:99952. Vérifier que le modèle bge-reranker-v2-m3 est chargé et en cours d’exécution dans la section /reranker. |
|
| 7. SearXNG | Accéder à : http://sp26.vincennes.fr:8056→ Vérifier que l’interface de recherche s’affiche. → Effectuer une recherche test (ex: "test"). |
|
| 8. Endpoint OpenAI | Depuis l’interface Sophia (Menu Images) : → Lancer une génération d’image. → Vérifier que la requête atteint OpenAI et retourne une image. |
|
| 9. Endpoints Infomaniak (via Node-RED) | Vérifier dans les menus Sophia : - Connexions : état des endpoints texte/audio/image - Documents, Audio, Recherche : que les appels passent via http://sp26.vincennes.fr:1886→ Vérifier les logs Node-RED en cas d’erreur. |
|
| 10. Logs des conteneurs de tunnel SSH | Vérifier les logs des conteneurs suivants dans Portainer : - infomaniak-xinference-1- infomaniak-docling-1- infomaniak-portainer_agent-1→ Rechercher des erreurs de connexion SSH, timeout ou refus. → S’assurer que la VM Infomaniak est joignable (ping ou test de connexion réseau). |
⚠️ Tableau des problèmes possibles en cas d’indisponibilité
| Service indisponible | Symptôme observé | Cause probable | Impact fonctionnel |
|---|---|---|---|
| Conteneur non démarré dans Portainer | Interface inaccessible, erreur 502/503 | Conteneur crashé, mauvaise configuration, dépendance manquante | Blocage total du service associé |
| Sophia (OpenWebUI) | Page blanche, erreur de chargement | Problème réseau, conteneur down, certificat SSL expiré | Interface principale inutilisable |
| Node-RED | Éditeur inaccessible ou flux inactifs | Conteneur down, erreur dans un flux critique | Toutes les intégrations (recherche, audio, embedding) bloquées |
| Firecrawl | API ne répond pas ou timeout | Conteneur down, VM surchargée, erreur de scraping | Impossible d’extraire du contenu web pour les recherches |
| Docling | /ui inaccessible ou erreur 500 |
Tunnel SSH rompu, service Docling arrêté sur Infomaniak | Analyse des documents PDF/HTML impossible |
| XInference / bge-reranker-v2-m3 | Modèle non chargé ou erreur 404/500 | Modèle non démarré, mémoire insuffisante, tunnel SSH défaillant | Détérioration de la qualité des réponses (RAG) |
| SearXNG | Page de recherche inaccessible | Conteneur down ou configuration réseau incorrecte | Recherche web impossible via Sophia |
| Endpoint OpenAI | Génération d’image échoue | Clé API invalide, réseau bloqué, quota dépassé | Fonctionnalité d’image inactive |
| Endpoints Infomaniak | Erreurs dans les menus Sophia (Connexions, Audio, etc.) | Tunnel SSH rompu, VM éteinte, problème d’authentification | Toutes les fonctions IA distantes (transcription, embedding) inactives |
| Logs des tunnels SSH | Messages répétés : Connection refused, Broken pipe, Failed to connect |
VM Infomaniak éteinte, firewall, clé SSH expirée, réseau instable | Perte de contrôle et de données vers les services distants |
🔍 Recommandation : Cette checklist peut être utilisée quotidiennement ou après chaque déploiement/mise à jour. En cas d’indisponibilité, consulter en priorité les logs des conteneurs de tunnel SSH et vérifier la connectivité réseau vers la VM Infomaniak.
Pas de commentaires