Logging

<< Klicken Sie, um das Inhaltsverzeichnis anzuzeigen >>

Navigation:  Technisches >

Logging

Die Server-Komponenten von EMIL schreiben ihren Ablauf in Protokolldateien. Die Ausführlichkeit stellen Sie in der config.ini des Servers im Abschnitt [LOGGING] ein. Jeder Serverprozess (Applikationsserver, ITC-Connect, Wartung, RITA-Worker) liest die Einstellung nur beim Start. Nach einer Änderung starten Sie den Applikationsserver deshalb über den Dienst ITC Server Guard neu.

Einstellungen in der config.ini

Beide Werte sind optional; fehlen sie, gelten diese Voreinstellungen:

[LOGGING]
LEVEL=error
IMPORTLEVEL=info

•LEVEL – allgemeine Server-Protokolle (Applikationsserver, ITC-Connect, RITA-Worker, Wartung sowie Auswertungs- und Pflegeläufe), Datei server.log. Voreinstellung error.

•IMPORTLEVEL – Datenimport-Läufe (z. B. EMIL4, KRhOKo, DocuMed.Rh, Rheumadok), eigene Datei itcimport.log. Getrennt gesteuert, damit ein Import sein ausführliches Protokoll unabhängig von LEVEL behält. Voreinstellung info.

Log-Level

Groß-/Kleinschreibung ist egal. Jede Stufe schließt alle schwereren Meldungen ein (info liefert also Informationen, Warnungen und Fehler). Ein nicht erkannter Wert wird wie error behandelt.

Level

Enthält

Genutzt von

error

nur Fehler; knappstes Protokoll, Voreinstellung für LEVEL

im Normalbetrieb genutzt

warning

zusätzlich Warnungen

im Normalbetrieb genutzt

info

zusätzlich Meldungen zu Ablauf und Fortschritt; Voreinstellung für IMPORTLEVEL

im Normalbetrieb genutzt

trace

vorgesehen für sehr ausführliche Ablaufmeldungen

derzeit keiner Komponente; das Protokoll entspricht praktisch info

debug

alles, inklusive Entwickler-Detailmeldungen

nur Gateway und RITA-Worker; für die allgemeinen Server- und Import-Protokolle keine zusätzliche Ausgabe

Start- und einige Statusmeldungen (z. B. dass ein Lauf wegen laufender Wartung übersprungen wurde) werden unabhängig vom Level immer geschrieben.

Protokolldateien

Die Dateien liegen im Stammverzeichnis der Serverinstallation: server.log (gesteuert über LEVEL) und itcimport.log (gesteuert über IMPORTLEVEL). Erreicht eine Datei ihre Größengrenze, wird sie umbenannt und eine neue begonnen; ältere Dateien werden in begrenzter Zahl aufbewahrt.

Alle config.ini-Schlüssel im Überblick: config.ini-Referenz.