Diagnostics et signalement

Chatbotaurus fournit plusieurs outils integres pour vous aider a diagnostiquer les problemes, signaler des bugs et demander de nouvelles fonctionnalites.

Fonctionnalite	Objectif	Emplacement	Resultat
Diagnostics infrastructure	Verifier l'etat des services	Scripts PowerShell	Rapport console
Diagnostics backend	Verifier les logs et metriques	Logs serveur	Fichiers JSON
Signaler un bug	Soumettre un rapport de bug	Forgejo Issues	Issue structuree
Demander une fonctionnalite	Suggerer une amelioration	Forgejo Issues	Issue structuree

Diagnostics infrastructure

Verification de l'etat des services

Utilisez le script de validation pour verifier l'ensemble de l'infrastructure :

.\scripts\validate-infrastructure.ps1

Ce script verifie :

• L'etat de tous les conteneurs Podman (core et MGaaS)
• La connectivite reseau entre les services
• La disponibilite des modeles Ollama
• Le statut de Vault (sealed/unsealed)
• Les ports exposes et les conflits eventuels

Verification manuelle des services

# Etat de tous les conteneurs
sudo podman ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

# Sante d'un service specifique
curl -s http://localhost:3000/api/v1/health | jq .

# Modeles Ollama disponibles
sudo podman exec chatbotaurus-ollama ollama list

# Statut Vault
sudo podman exec chatbotaurus-vault vault status

# Connexion PostgreSQL
sudo podman exec chatbotaurus-postgres pg_isready

# Statut Qdrant
curl -s http://localhost:6333/healthz

# Statut Valkey
sudo podman exec chatbotaurus-valkey valkey-cli ping

Metriques de performance

Les metriques cles a collecter pour le diagnostic :

# Utilisation memoire par conteneur
sudo podman stats --no-stream --format "table {{.Name}}\t{{.MemUsage}}\t{{.CPUPerc}}"

# Espace disque
df -h /var/lib/containers

# Latence reseau entre VPS1 et VPS2 (mode demo)
ping -c 5 72.60.92.14

Diagnostics backend

Logs du serveur

Les logs du backend sont disponibles dans la sortie standard du conteneur :

# Logs en temps reel
sudo podman logs -f chatbotaurus-backend

# 100 dernieres lignes
sudo podman logs --tail 100 chatbotaurus-backend

Logs structures

Le backend produit des logs structures (JSON) qui incluent :

• resolveMs : temps de resolution des outils
• credentialsMs : temps de recuperation des credentials
• executeMs : temps d'execution de l'outil
• level : niveau de log (info, warn, error)
• service : nom du service source

Diagnostics MCP Gateway

Pour diagnostiquer les problemes du MCP Gateway :

# Tester l'endpoint Streamable HTTP
curl -X POST http://localhost:3000/api/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{}},"id":1}'

# Verifier le catalogue
curl -s http://localhost:3000/api/v1/mcp/catalog | jq .

# Verifier le catalogue business
curl -s http://localhost:3000/api/v1/mcp/catalog-business | jq .

Signaler un bug

Pour signaler un bug, ouvrez une issue sur notre depot Forgejo :

1. Rendez-vous sur Forgejo Issues
2. Cliquez sur "Nouvelle issue"
3. Incluez les informations suivantes :
   • Description du probleme
   • Etapes pour reproduire
   • Comportement attendu vs observe
   • Logs pertinents (anonymises)
   • Version de Chatbotaurus et environnement (VPS1/VPS2/local)

Confidentialite

Avant de partager des logs, assurez-vous de supprimer toute information sensible (cles API, tokens, donnees personnelles). Ne partagez jamais les cles de descellement Vault.

Demander une fonctionnalite

Pour suggerer une amelioration :

1. Rendez-vous sur Forgejo Issues
2. Creez une issue avec le prefixe [Feature] dans le titre
3. Decrivez :
   • Le cas d'usage
   • La solution proposee
   • Les alternatives envisagees
   • L'impact sur la conformite EU (si applicable)

Debogage avance

Pour les problemes non resolus par les diagnostics standards :

• Problemes connus : solutions aux erreurs courantes
• Logs : acces detaille aux logs de chaque service
• Architecture : comprendre les interactions entre composants