Logging
Zur Fehlersuche werden Code-Ausführungsinformationen, Warnungen und Fehler in Log-Dateien geschrieben. Im Folgenden wird beschrieben wo diese zu finden sind, konfiguriert werden können und der Log Level festgelegt werden kann.
Konfigurationsdatei
Vom Karaf wird zum Logging Apache Log4j 2 verwendet.
Dessen Properties basierte Konfigurationsdatei befindet sich unter [karaf]/etc/org.ops4j.pax.logging.cfg
.
Logging-Dateien
Die Logging-Dateien werden in das Verzeichnis [karaf]/data/log
geschrieben.
Diese Location wird in der zuvor genannten Konfigurationsdatei über das Java-Systemproperty ${karaf.log}
festgelegt.
In der Voreinstellung werden mehrere Logging-Dateien erstellt. Die folgenden Beiden sind BPC spezifisch.
Logger | Level | Datei |
---|---|---|
authentication |
WARN |
authentication.log |
de.virtimo.bpc |
WARN |
bpc.log |
Log Level einstellen
Der Detailgrad der zu loggenden Daten, kann pro Logger per Log Level festgelegt werden.
Die möglichen Log Level sind TRACE
, DEBUG
, INFO
, WARN
, ERROR
, FATAL
, OFF
. Von links nach rechts werden immer weniger Daten bis zu gar keinen geloggt.
Per Karaf Shell Kommando
Über das Karaf Shell Kommando log:list
kann man sich die konfigurierten Logger samt Level anzeigen lassen.
virtimo@bpc()> log:list
Logger │ Level
─────────────────────────────┼──────
ROOT │ INFO
audit │ TRACE
authentication │ WARN
de.virtimo.bpc │ WARN
org.apache.aries.spifly │ WARN
org.apache.felix.fileinstall │ INFO
org.apache.sshd │ INFO
Der Level eines Loggers lässt sich zur Laufzeit über das Kommando log:set <LEVEL> <Logger>
festlegen.
Im folgenden Beispiel wird der Logger de.virtimo.bpc
vom Log Level WARN
auf INFO
geändert.
virtimo@bpc()> log:set INFO de.virtimo.bpc
Per BPC Weboberfläche
Die Log Level können auch über die BPC Weboberfläche festgelegt werden. Dazu navigieren Sie als Administrator zu BPC Administration → Übersicht → Status
Durch klick auf den Level eines Loggers, öffnet sich eine Auswahlbox mit den möglichen Log Leveln. Die Auswahl wird hierbei direkt übernommen.