Aller au contenu

Journaux pour l'assistance

Quand quelque chose coince, les journaux sont le chemin le plus rapide vers la cause : YouniqMail écrit en continu les opérations, les avertissements et les erreurs dans des fichiers qui retiennent précisément ce qui a échoué et quand. Une demande d’assistance accompagnée des journaux évite presque toujours l’aller-retour « peux-tu décrire cela plus précisément ? ».

Le chemin le plus commode passe par l’application : sous Paramètres → Avancé, dans la section Journalisation, le chemin figure sous forme de lien à côté de Emplacement des fichiers journaux :. Un clic dessus ouvre le dossier.

Si l’application ne démarre même pas, tu atteins le dossier directement dans le système de fichiers. Il se trouve dans le répertoire de données sous logs :

Système d'exploitation :
~/Library/Application Support/YouniqMail/logs/

Dans le Finder : Aller → Aller au dossier… puis coller le chemin.

%APPDATA%\YouniqMail\logs\

Colle la ligne telle quelle dans la barre d’adresse de l’Explorateur : Windows résout %APPDATA% tout seul.

~/.config/YouniqMail/logs/

Le fichier courant s’appelle main.log. Quand il atteint 5 Mo, il devient main.old.log et un nouveau fichier commence ; les états plus anciens sont alors écrasés.

Pour les cas tenaces, il existe le niveau détaillé : l’interrupteur Activer la journalisation de débogage sous Paramètres → Avancé. L’application écrit alors nettement plus de détails, y compris la durée de nombreuses opérations, et devient un peu plus lente. La marche à suivre :

  1. Activer la journalisation de débogage.
  2. Provoquer le problème une fois, de façon ciblée.
  3. Récupérer les journaux, puis désactiver le niveau de débogage.

Ce qui figure dans les journaux, et ce qui n’y figure pas

Section intitulée « Ce qui figure dans les journaux, et ce qui n’y figure pas »

Les journaux contiennent des déroulés techniques : horodatages, messages d’erreur, identifiants des comptes concernés et noms de serveurs. YouniqMail filtre les mots de passe, jetons d’accès et clés avant l’écriture, et les noms de dossiers sont raccourcis à de nombreux endroits. Le texte et l’objet des e-mails n’y figurent pas, mais des adresses e-mail peuvent apparaître. Jette un coup d’œil avant de transmettre si cela compte pour toi : les fichiers sont du texte ordinaire.

Envoie le fichier main.log (pour un problème tout juste reproduit, il suffit, sinon joins aussi main.old.log) avec trois indications :

  • Qu’as-tu fait ? (« relevé le compte X », « ouvert un e-mail avec une grosse pièce jointe »)
  • Que s’est-il passé, et à quoi t’attendais-tu ?
  • Depuis quand ? (« après la mise à jour », « depuis le changement de fournisseur »)

Un rapport de diagnostic aide aussi : sous Paramètres → Import / Export, dans la section Signaler un problème, Exporter le rapport de diagnostic crée un fichier avec la version de l’application, le système d’exploitation, des statistiques de la base de données (uniquement des nombres) et la structure anonymisée de tes règles. Le contenu des e-mails, les contacts et les mots de passe n’y figurent pas.

Avec cela, la recherche de la cause est courte dans la plupart des cas.