Basculer Dolibarr en mode debug

Le mode debug permet de collecter le maximum d'informations techniques pour nous aider à « y voir plus clair » dans l'objectif de corriger un bug ou un problème précis. Le mode debug est temporaire et sans conséquence, à part pour la durée pendant laquelle il est actif. Durant ce laps de temps, votre Dolibarr sera beaucoup plus lent que d'habitude car il collecte et stocke toutes les informations dans un fichier. C'est la raison pour laquelle il est important de désactiver le mode debug une fois l'intervention terminée.

1. Supprimez les anciens fichiers de logs

Pour éviter de nous envoyer un historique de plusieurs mois et un fichier énorme, commencez avant tout par :

• Désactiver le module log :
  • Identifiez-vous sur votre Dolibarr à l'aide d'un compte administrateur, puis suivez le guide :
    • Accueil
    • Configuration
    • Modules/Applications
    • Puis cherchez le module « Journaux et traces de Debug » et désactivez-le s'il était actif. S'il n'était pas actif, ne faites rien et passez à l'étape suivante.
• Supprimez le fichier dolibarr.log de votre dossier documents (via un accès (s)FTP) ainsi que les autres fichiers .log présents dans ce dossier.

2. Activez le mode debug

Identifiez-vous sur votre Dolibarr à l'aide d'un compte administrateur, puis suivez le guide :

• Accueil
• Configuration
• Modules/Applications
• Puis cherchez le module « Journaux et traces de Debug » et activez-le puis cliquez sur l'icône de configuration du module :

Dans la configuration du module de debug, vérifiez que :

1. La destination du debug est bien le fichier dolibarr.log
2. Le niveau de log est bien positionné sur « debug »

(Modifiez la configuration le cas échéant et pensez à cliquer sur le bouton « modifier » si nécessaire.)

3. Provoquez le bug

Maintenant que le mode debug est actif, provoquez le bug pour lequel nous vous avons demandé d'activer le mode debug. Notez bien les différentes étapes qui permettent de provoquer le bug et faites des captures d'écran éventuellement si vous avez des messages d'erreurs qui s'affichent. Essayez de capturer également l'horloge si elle est visible sur votre écran, cela nous permettra de chercher au bon endroit dans le fichier log.

Une fois le bug provoqué, retournez sur la configuration du module de debug.

4. Téléchargez les fichiers .log

Cliquez sur le lien de téléchargement, sauvegardez le fichier dolibarr.log et envoyez-le par courrier électronique ou copiez-le sur notre interface de suivi technique.

Si possible, connectez-vous également en (s)FTP pour récupérer et nous transmettre les autres fichiers .log qui se trouvent dans le même dossier et dont vous avez probablement supprimé les précédentes versions à l'étape 1. C'est particulièrement vrai si nous devons débusquer des bugs lancés par les tâches planifiées ou sur des modules un peu spécifiques qui génèrent des fichiers logs à part (par exemple pour le module Stancer ou UptoSign).

5. Désactivez le module de debug

Retournez cette fois sur la liste des modules Dolibarr : Accueil > Configuration > Modules/Applications puis décochez le module « Journaux et traces de Debug ». Cela évitera de ralentir votre Dolibarr pour rien et de saturer votre espace de stockage.