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
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 ~~lancement~~tunnel : http://sp26.vincennes.fr:9995
2. 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 ~~containers~~endpoints ~~précisés~~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 ~~l'architecture~~Portainer ~~générale,~~:
- 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 2menus 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.