80.2 Fehler-Log
80.2.1 Übersicht ¶
Das Fehler-Log ist eine zweite, vom Verarbeitungs-Log getrennte Aufzeichnung. Es protokolliert technische Fehler aus dem Programm-Betrieb - Code-Exceptions, fehlgeschlagene Verbindungen, korrupte Dateien, Zustände, die zu einer Hinweis-Anzeige führen. Anders als das Verarbeitungs-Log (das pro Mail einen Eintrag hat) beinhaltet das Fehler-Log technische Programm-Logs, unabhängig von einzelnen E-Mails.
Aufgeteilt nach vier Anwendungs-Komponenten wird pro Komponente eine eigene Log-Datei geführt:
- Main - UI-Anwendung
- Watcher - Service-Watchdog
- Processor - Verarbeitungs-Engine (im Service-Modus)
- PostProcessor - Nachgelagerte Aufgaben (z.B. ZIP, Mapping-Resolver)
So lassen sich Probleme einer einzelnen Komponente isolieren, ohne im Misch-Log nach der Quelle zu suchen.
80.2.2 Speicherort ¶
Die Log-Dateien liegen im AppData-Verzeichnis:
%APPDATA%\AutomaticEmailProcessor\ErrorLog_Main.json
%APPDATA%\AutomaticEmailProcessor\ErrorLog_Watcher.json
%APPDATA%\AutomaticEmailProcessor\ErrorLog_Processor.json
%APPDATA%\AutomaticEmailProcessor\ErrorLog_PostProcessor.json
Im Service-Modus liegen die Watcher- und Processor-Dateien im AppData des Service-Accounts, nicht des UI-Benutzers.
80.2.3 Zugriff auf das Fehler-Log ¶
Das Fehler-Log liegt als JSON-Datei im AppData-Verzeichnis (siehe 80.2.2). Direkt in der UI gibt es keinen Anzeige-Dialog - stattdessen stehen im Hauptmenü → Weiteres zwei Funktionen zur Verfügung:
| Menü-Punkt |
Wirkung |
| Fehlerbericht erzeugen… |
Bündelt die Fehler-Logs aller Komponenten samt System- und Versions-Informationen in einer Datei auf dem Desktop. Sinnvoll für Support-Anfragen |
| Fehlerprotokolle leeren |
Löscht die Fehler-Logs (alle Komponenten). Verarbeitungs-Logs bleiben unberührt |
Wer den Roh-Inhalt sehen möchte, öffnet die JSON-Datei direkt aus dem AppData-Verzeichnis (Hauptmenü → Weiteres → Anwendungsdaten-Ordner öffnen…).
Hinweis: Der Fehlerbericht kann personenbezogene Inhalte (Profil-Namen, Konto-Adressen) enthalten - vor Versand prüfen.
80.2.4 Aufbewahrung ¶
Das Fehler-Log bewahrt Einträge 7 Tage auf. Beim Programm-Start oder bei jedem neuen Eintrag werden ältere Einträge automatisch entfernt. Die Dauer ist nicht konfigurierbar - eine Woche reicht typischerweise, um aktuelle Probleme zu diagnostizieren.
Wer länger archivieren möchte, kopiert die JSON-Datei manuell oder lässt sie über die normale Backup-Funktion mitsichern.