Diagnostiquer un site auto-hébergé
Diagnostiquer un site auto-hébergé
S'applique à : auto-hébergé, Dokos v5. Sur Dokos Cloud, voir Résoudre un problème de site Cloud.
Commencez par le rapport de santé dans Dokos, puis passez aux commandes bench sur le serveur. Les commandes s'exécutent dans le dossier du bench. Avec Docker, préfixez-les par docker compose exec backend.
1. Lire le rapport de santé
Ouvrez Aide > System Health (rôle Responsable système). Le rapport Analyse de la santé du système montre :
- l'état du planificateur et le nombre de workers en ligne ;
- les files d'attente et les tâches planifiées en échec sur 7 jours ;
- les emails en échec ou en attente ;
- les erreurs de la veille ;
- la taille de la base, des fichiers et des sauvegardes.
2. Planificateur inactif
Symptôme : les emails restent en attente, les tâches récurrentes ne tournent pas, l'import de données affiche « Le planificateur est inactif. Le système ne peut pas importer les données. »
bench --site dokompany.fr scheduler status
bench doctor
bench doctor indique pour chaque site si le planificateur est désactivé, en pause, inactif ou si le mode maintenance est actif.
| Cause | Correction |
|---|---|
| Planificateur désactivé (case Activer les Tâches Planifiées décochée) | bench --site dokompany.fr scheduler enable |
Planificateur en pause (pause_scheduler dans la configuration) | bench --site dokompany.fr scheduler resume |
| Mode maintenance resté actif après une mise à jour | bench --site dokompany.fr set-maintenance-mode off |
Processus schedule arrêté (installation manuelle ; avec Docker : docker compose restart) | sudo supervisorctl status, puis sudo supervisorctl restart all |
mute_emails, mute_notifications, mute_payment_gateways) avant d'activer le planificateur.3. Workers et tâches en arrière-plan
Symptôme : les rapports préparés, les imports ou les PDF en masse ne se terminent pas.
bench doctor
bench --site dokompany.fr show-pending-jobs
bench doctor affiche le nombre de workers en ligne et les tâches en attente par file. Si aucun worker n'est en ligne, redémarrez les processus : sudo supervisorctl restart all en installation manuelle, docker compose restart avec Docker. Si une file déborde de tâches obsolètes, bench --site dokompany.fr purge-jobs --queue default les supprime.
4. Lire les journaux
En production, les journaux sont dans le dossier logs/ du bench :
| Fichier | Contenu |
|---|---|
web.error.log | Erreurs du serveur web |
worker.error.log | Erreurs des tâches en arrière-plan |
schedule.error.log | Erreurs du planificateur |
node-socketio.error.log | Erreurs du temps réel (notifications instantanées) |
backup.log | Résultat des sauvegardes planifiées |
tail -n 100 logs/worker.error.log
Dans Dokos, le Journal des Erreurs liste les erreurs de chaque site avec leur trace complète.
5. Espace disque
Un disque plein bloque les sauvegardes, la base de données et les mises à jour.
df -h
du -sh sites/*/private/backups sites/*/private/files sites/*/public/files
Réduisez le Nombre de Sauvegardes conservées dans Paramètres Système si les sauvegardes occupent trop de place. Copiez les sauvegardes hors du serveur avant de les supprimer.
Exemple
Les emails de Dokompany ne partent plus depuis lundi. L'administrateur lance bench doctor et lit « Maintenance mode on for dokompany.fr ». La dernière mise à jour s'est arrêtée sur une erreur. Il corrige l'erreur, relance bench update, puis vérifie que le mode maintenance est désactivé.
Vérifier
bench --site dokompany.fr scheduler statusafficheScheduler is enabled for site dokompany.fr.- Dans System Health, les workers sont en ligne et les emails en attente diminuent.
Ce qui n'est pas une panne
Dans l'onglet Liens d'un formulaire, un compteur affiche « 99+ » au-delà de 99 documents liés. Dokos ne compte pas plus loin pour garder les formulaires rapides. Pour connaître le nombre exact, utilisez un rapport ou un tableau de bord Insights.