Start/notes.ini Parameters/KeepLogConfigFile

KeepLogConfigFile

🛠️
Parameter: KeepLogConfigFile
Summary: Path to a custom log4j2.properties file for the Domino REST API logging configuration.

Profile

Parameter
KeepLogConfigFile
Category
Logging / Debug
Component
Server
Available since
12.0
Supported versions
12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
Absolute path to a log4j2 properties file

Description

The Domino REST API uses Apache log4j2 as its logging framework. Without further configuration, DRAPI loads the default log4j2.properties from keep-core.jar. With KeepLogConfigFile you can supply your own file to define log levels per logger, custom appenders (separate log files, syslog, JSON output for SIEM systems), or specific filters – without touching the bundled JAR.

Example configuration

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

Notes & pitfalls

  • The file must use valid log4j2 properties (or XML) syntax – typos cause DRAPI startup to abort.
  • Export the default configuration from keep-core.jar as a template and adjust it as needed.
  • Takes effect on the next start of the restapi task.
  • Pairs well with central log aggregators (ELK, Loki, Splunk) – treat the output as an “app log” alongside the classic Domino console.log.