Systeme de logs
Chatbotaurus utilise un systeme de logs structure pour faciliter le debogage et le monitoring. Tous les logs restent locaux et ne sont jamais envoyes a des serveurs externes.
Confidentialite
Chatbotaurus est une application souveraine. Tous les logs sont stockes localement sur vos serveurs (VPS1/VPS2) et ne sont jamais transmis a des tiers.
Logs des conteneurs Podman
Chaque service produit des logs accessibles via Podman :
# Logs en temps reel d'un service
sudo podman logs -f chatbotaurus-<service>
# 100 dernieres lignes
sudo podman logs --tail 100 chatbotaurus-<service>
# Logs avec timestamps
sudo podman logs -t chatbotaurus-backend
Services principaux
| Service | Conteneur | Type de logs |
|---|---|---|
| Backend | chatbotaurus-backend | Requetes HTTP, MCP Gateway, tool calling |
| Ollama | chatbotaurus-ollama | Inference LLM, chargement modeles |
| PostgreSQL | chatbotaurus-postgres | Requetes SQL, connexions |
| Qdrant | chatbotaurus-qdrant | Operations vectorielles |
| Valkey | chatbotaurus-valkey | Operations cache |
| Keycloak | chatbotaurus-keycloak | Authentification, sessions |
| Vault | chatbotaurus-vault | Acces secrets, audit |
Logs structures du backend
Le backend produit des logs JSON structures incluant des metriques de performance :
{
"level": "info",
"service": "mcp-gateway",
"method": "tools/call",
"toolName": "odoo_search_read",
"resolveMs": 12,
"credentialsMs": 3,
"executeMs": 145,
"cacheHit": false,
"timestamp": "2026-02-23T10:30:00.000Z"
}
Metriques cles dans les logs
| Metrique | Description | Seuil d'alerte |
|---|---|---|
resolveMs | Temps de resolution de l'outil | > 100ms |
credentialsMs | Temps de recuperation des credentials | > 50ms |
executeMs | Temps d'execution de l'outil | > 2000ms (simple), > 8000ms (complexe) |
cacheHit | Requete servie depuis le cache | Taux < 80% |
Logs de developpement
En mode developpement local :
# Backend - logs dans la console
cd packages/server
pnpm build && node start-direct.js
# Frontend - logs Next.js dans la console
cd packages/new-ui
pnpm dev --port 3001
Monitoring avec VictoriaMetrics
En production, les metriques sont collectees par VictoriaMetrics :
- Latence des requetes MCP
- Utilisation CPU/RAM par conteneur
- Taux de cache hit
- Nombre de sessions actives
- Sante des services deployes
Rotation des logs
Les logs Podman sont automatiquement geres par le runtime. Pour les logs applicatifs volumineux :
# Nettoyer les logs d'un conteneur
sudo podman logs --since 24h chatbotaurus-backend > /dev/null
# Verifier l'espace disque utilise par les logs
sudo du -sh /var/lib/containers/storage/
Voir aussi
- Diagnostics et signalement - Outils de diagnostic
- Problemes connus - Solutions aux erreurs courantes