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 │ INFODer 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.bpcPer 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.
