Zum Hauptinhalt springen

Protokollierung (Logging)

Die Anwendung protokolliert jede wichtige Aktion über log4net — hilfreich zur Fehlersuche, wenn ein Anwender eine unerwartete Meldung erhalten hat.

Speicherort​

Log\VWGCBS.log

relativ zum Installationsordner der Anwendung. Die Datei rollt täglich (rollingStyle="Date", Muster yyyy-MM-dd'.log'), mit einer Aufbewahrung von 30 Tagen (maxSizeRollBackups).

Was protokolliert wird​

  • Jeder Menüpunkt- und Hauptschaltflächen-Klick — auch wenn dabei nichts gespeichert wird (z. B. „Funktion aufgerufen: Handbuch (F1)").
  • Jede tatsächliche Zustandsänderung mit Klartext-Meldung, identisch zu dem, was der Anwender in der Statusliste im Hauptfenster sieht (z. B. „Exportiert nach C:...", „Maschinentypen aktualisiert").
  • Ausnahmen bei Fehlern während Prüfung, Aufbau oder Export, jeweils mit vollständigem Stacktrace auf Log-Level Error bzw. Warn.

Log-Level anpassen​

Konfiguriert in App.config:

<log4net>
  <appender name="DateiAppender" type="log4net.Appender.RollingFileAppender">
    <file value="Log\VWGCBS.log"/>
    ...
  </appender>
  <root>
    <level value="INFO"/>
    <appender-ref ref="DateiAppender"/>
  </root>
</log4net>

Für eine detailliertere Fehlersuche kann der Level testweise auf DEBUG gesetzt werden — dann erscheinen zusätzlich interne Zwischenschritte wie „AusfuellenVerbinden betreten" oder die zerlegten Bestandteile der DGL-Nummer bei jedem Aufbau. Für den produktiven Betrieb empfiehlt sich INFO, um die Logdatei nicht unnötig zu füllen.

Für Anwender: Logdatei öffnen​

Anwender erreichen dieselbe Datei über Hilfe → LogDatei öffnen in der Anwendung (siehe Einstellungen) — praktisch, um bei einer Support-Anfrage die passende Zeile mitzuschicken.