Dépannage
Diagnostiquez les problèmes courants de connexion, d'exécution, de mises à jour en temps réel, d'e-mail et de services auto-hébergés.
Commencez par déterminer à quelle couche appartient le problème : le service Multica, le daemon, le runtime ou l'outil de codage IA. Ces commandes suffisent généralement à faire apparaître la première erreur significative :
multica version
multica auth status
multica daemon status --output json
multica daemon logs --lines 100/health indique seulement que le processus API répond ; /readyz vérifie aussi la base de données et les migrations. Lorsque vous signalez un problème, incluez l'erreur, les journaux pertinents, la version du CLI et le système d'exploitation ; retirez les jetons, les adresses e-mail et les autres informations sensibles avant l'envoi.
Connexion et authentification
Exécutions et outils de codage IA
Application web et service auto-hébergé
Emplacement des journaux
| Composant | Comment consulter |
|---|---|
| Daemon en arrière-plan | multica daemon logs --lines 100 |
| Suivre les journaux du daemon en direct | multica daemon logs --follow |
| Fichier journal du profil par défaut | ~/.multica/daemon.log |
| Journal de démarrage ou de plantage du profil par défaut | ~/.multica/daemon.err.log |
| Profils nommés | les journaux correspondants sous ~/.multica/profiles/<name>/ |
| Backend Docker | docker compose -f docker-compose.selfhost.yml logs -f backend |
| Navigateur | Onglets Console et Network (Réseau) des outils de développement |
Le fichier actif parmi ceux-ci dépend du profil avec lequel le daemon a été démarré, et un journal obsolète laissé par un daemon précédent reste parfaitement lisible : c'est le moyen le plus simple de déboguer le mauvais fichier. N'en ouvrez pas un au hasard : multica daemon logs affiche le chemin absolu qu'il a résolu avant d'en diffuser le contenu. Ajoutez --profile <name> pour lire le journal d'un profil nommé.
Pour observer directement le démarrage du daemon, exécutez-le plutôt au premier plan :
multica daemon stop
multica daemon start --foregroundSi vous ne parvenez toujours pas à cerner le problème, recherchez parmi les issues existantes ou ouvrez-en une nouvelle sur GitHub Issues.
Étapes suivantes
- Daemon et runtimes — comment les runtimes s'enregistrent et signalent leur statut en ligne.
- Exécutions — référence des statuts, des délais d'expiration et des échecs.
- Variables d'environnement — la référence complète de configuration de l'auto-hébergement.