Start/notes.ini Parameter/KeepLogConfigFile

KeepLogConfigFile

🛠️
Parameter: KeepLogConfigFile
Kurzbeschreibung: Pfad zu einer eigenen log4j2.properties für die Logging-Konfiguration der Domino REST API.

Steckbrief

Parameter
KeepLogConfigFile
Kategorie
Logging / Debug
Komponente
Server
Verfügbar seit
12.0
Unterstützte Versionen
12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI)
Mögliche Werte
Absoluter Pfad zu einer log4j2-Properties-Datei

Beschreibung

Die Domino REST API nutzt Apache log4j2 als Logging-Framework. Ohne weitere Konfiguration lädt DRAPI die Standard-log4j2.properties aus der keep-core.jar. Mit KeepLogConfigFile lässt sich stattdessen eine eigene Datei einbinden, um Log-Level pro Logger, eigene Appender (separate Logfiles, Syslog, JSON-Format für SIEM) oder spezielle Filter zu definieren – ohne das mitgelieferte JAR zu verändern.

Beispiel-Konfiguration

KeepLogConfigFile=/local/notesdata/restapi/log4j2.properties

Hinweise & Stolperfallen

  • Datei muss gültiges log4j2-Properties- (oder XML-) Format haben – Tippfehler führen zu DRAPI-Startabbruch.
  • Standard-Konfiguration aus keep-core.jar als Vorlage exportieren und gezielt anpassen.
  • Greift beim nächsten Start des restapi-Tasks.
  • Ergänzt sich mit zentralen Log-Aggregatoren (ELK, Loki, Splunk) – dort als „App-Log" gegenüber dem klassischen Domino console.log führen.