Exploitation

Diagnostiquer un site auto-hébergé

Vérifiez le planificateur, les workers, les journaux et l'espace disque d'un site Dokos auto-hébergé qui ne se comporte pas comme prévu.

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`

Sur une copie de la production, coupez les envois (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 status affiche Scheduler 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.