Configuring the Logging Engine¶
Virtual DataPort uses the logging library Apache Log4j 2
to log the activity of the
Virtual DataPort server and Apache Log4j 1.x
to log the activity of the other components. Log4j allows
defining several categories on which the log level will be specified
independently. For each category, the log level can be TRACE
,
DEBUG
, INFO
, WARN
, ERROR
or FATAL
.
The Virtual DataPort Server logs are stored in
<DENODO_HOME>/logs/vdp
and the Administration Tool logs, in
<DENODO_HOME>/logs/vdp-admin
.
The configuration of Log4j of the Virtual DataPort server is controlled
by the file <DENODO_HOME>/conf/vdp/log4j2.xml
; for the
administration tool by <DENODO_HOME>/conf/vdp-admin/log4j.xml
.
You need some knowledge of Log4j to modify these configuration files. Their syntax is different because the Server uses Log4j version 2 and the other components, Log4J version 1.
To apply the changes made on log4j2.xml
or log4j.xml
, you have
to restart the Server or the administration tool respectively.
You can change the log level of a category in the Server without restarting by doing the following:
Invoking the stored procedure
LogController
. See more about this in the section LogController of the VQL Guide.Or, invoking the operation
setLogLevel
of theLogManagementInfo
MBean. See more about this operation in the section LogManagementInfo MBean.
The changes in the log levels performed at runtime are lost when the Server is restarted.
Note
In production environments, we recommend using an ERROR
log level. Lower levels degrade the system performance and are only
recommended for debugging tasks.