Consulter les Logs Applicatifs

🎯 Objectif

Les logs applicatifs (journaux) de TEIF MANAGER enregistrent toutes les actions et erreurs de l'application.

Ils sont essentiels pour :

• ✅ Diagnostiquer les erreurs
• ✅ Comprendre le comportement de l'application
• ✅ Fournir des informations au support BTB LABS
• ✅ Auditer les opérations effectuées

---

📂 Accéder aux Logs

Méthode 1 : Depuis l'Interface (Recommandée)

1. Ouvrez TEIF MANAGER
2. Menu Aide (en haut à droite)
3. Cliquez sur "Ouvrir les journaux"
4. ✅ L'explorateur Windows s'ouvre sur le dossier des logs

Méthode 2 : Manuellement

Les logs sont stockés dans :

Pour y accéder :

1. Appuyez sur Windows + R
2. Tapez : %APPDATA%\teif-manager\logs
3. Appuyez sur Entrée

---

📄 Structure des Fichiers de Logs

Types de Fichiers

Fichier	Description
main.log	Log principal de l'application
renderer.log	Log de l'interface utilisateur
ttn.log	Log des interactions avec le réseau TTN
signature.log	Log des opérations de signature
database.log	Log des opérations de base de données

Rotation des Logs

Les logs sont automatiquement archivés :

• 📅 Quotidien : Un nouveau fichier par jour
• 📦 Archivage : Les anciens logs sont compressés (.gz)
• 🗑️ Nettoyage : Les logs de plus de 30 jours sont supprimés

Exemple de fichiers :

---

🔍 Lire et Comprendre les Logs

Format des Entrées

Chaque ligne de log suit ce format :

Niveaux de Gravité

Niveau	Description	Priorité
[DEBUG]	Informations de débogage détaillées	Faible
[INFO]	Informations générales	Normale
[WARN]	Avertissements (non bloquants)	Moyenne
[ERROR]	Erreurs (problèmes bloquants)	Haute
[FATAL]	Erreurs critiques (crash)	Critique

Rechercher des Informations Spécifiques

Avec Notepad++ ou VS Code

1. Ouvrez le fichier de log avec un éditeur de texte
2. Utilisez Ctrl + F pour rechercher
3. Recherchez par :
   • Mot-clé : "ERROR", "TTN", "signature", etc.
   • Date/heure : "2025-01-08 14:30"
   • Nom de fichier : "facture_001.xml"

Avec PowerShell (Avancé)

Pour extraire toutes les erreurs d'aujourd'hui :

---

📊 Cas d'Usage Courants

1. Diagnostiquer une Erreur de Signature

1. Ouvrez signature.log
2. Recherchez [ERROR]
3. Identifiez le message d'erreur et la facture concernée
4. Utilisez cette information pour résoudre le problème

Exemple d'entrée :

2. Diagnostiquer une Erreur de Soumission TTN

1. Ouvrez ttn.log
2. Recherchez le nom de la facture ou l'heure de soumission
3. Identifiez le code d'erreur HTTP (401, 403, 500, etc.)

Exemple d'entrée :

3. Vérifier les Factures Traitées

1. Ouvrez main.log
2. Recherchez [INFO] et "facture"
3. Consultez l'historique des factures téléchargées, signées, soumises

4. Auditer les Changements d'Entité

1. Ouvrez main.log
2. Recherchez "switch entity" ou "basculement"
3. Consultez qui a basculé vers quelle entité et quand

---

📤 Envoyer les Logs au Support

Quand Envoyer les Logs ?

Envoyez les logs au support BTB LABS quand :

• ⚠️ Vous rencontrez une erreur que vous ne pouvez pas résoudre
• ⚠️ L'application se comporte de manière inattendue
• ⚠️ Le support vous le demande explicitement

Comment Préparer les Logs ?

1. Menu Aide → Ouvrir les journaux
2. Sélectionnez les fichiers de log du jour :
   • main.log
   • renderer.log
   • ttn.log (si problème de soumission)
   • signature.log (si problème de signature)
3. Faites un clic droit → Envoyer vers → Dossier compressé
4. Joignez le fichier ZIP à votre email au support

---

🧹 Nettoyer les Logs Manuellement

Pourquoi Nettoyer ?

• 💾 Libérer de l'espace disque
• 🔍 Faciliter la recherche dans les logs récents
• 🔒 Supprimer les anciens logs contenant des données sensibles

Comment Nettoyer ?

1. Fermez TEIF MANAGER
2. Accédez au dossier des logs (voir ci-dessus)
3. Supprimez les fichiers de log anciens (ex: > 30 jours)
4. ✅ Conservez les logs récents (derniers 7 jours)

---

⚙️ Niveau de Verbosité des Logs

Activer le Mode Debug

Si le support BTB LABS vous demande des logs plus détaillés :

1. Menu ⚙️ Paramètres → Avancé
2. Section "Logs"
3. Niveau de log : Sélectionnez "DEBUG"
4. Cliquez sur "Appliquer"
5. Redémarrez TEIF MANAGER

---

❓ Questions Fréquentes

Les logs ralentissent-ils l'application ?

❌ Non. L'impact sur les performances est négligeable.

Puis-je supprimer tous les logs ?

✅ Oui, mais fermez TEIF MANAGER d'abord. De nouveaux logs seront créés au prochain démarrage.

Les logs sont-ils chiffrés ?

❌ Non. Ils sont en texte clair pour faciliter le diagnostic. Protégez l'accès à votre PC.

Puis-je désactiver les logs ?

❌ Non recommandé. Les logs sont essentiels pour le diagnostic en cas de problème.

Combien d'espace les logs prennent-ils ?

💾 Environ 10-50 MB pour 30 jours de logs selon l'utilisation.

---

🔗 Guides Associés

• 👉 Contacter le support
• 👉 Dépannage général
• 👉 Erreur de soumission TTN
• 👉 Token non détecté

---

📞 Support

Pour toute question sur les logs :

📧 Email : support@teif.tn
⏰ Lundi - Vendredi, 9h - 17h (GMT+1)

---

✅ Résumé

• ✅ Les logs sont accessibles via Menu Aide → Ouvrir les journaux
• ✅ Recherchez [ERROR] pour identifier les problèmes
• ✅ Envoyez les logs au support en cas de problème persistant
• ✅ Le nettoyage automatique conserve 30 jours d'historique