Logging

A set of ActivID AS log files can be configured to obtain additional information about the activity/behavior of the deployed ActivID AS applications.

Logging configuration file name Location Purpose
mclog4j.xml <ACTIVID_HOME>/ActivID_AS/applications/resources/mc Log file of the ActivID Management Console
ssplog4j.xml <ACTIVID_HOME>/ActivID_AS/applications/resources/ssp Log file of the ActivID Self-Service Portal
srvlog4j.xml <ACTIVID_HOME>/ActivID_AS/applications/resources/srv Log file of the ActivID Authentication Server and Authentication Portal

Change the Logging Level

A systems administrator can change the level of logging per application. The logging configuration is automatically refreshed every few minutes.

The logging levels are:

  • INFO – use in the early stages of troubleshooting when you suspect there is a problem
  • DEBUG – use to write the greatest amount of information to the log file
  • ERROR – use as a default value
Note: It is recommended that you only set the logging level to DEBUG when necessary and return to ERROR as soon as possible. For more information about syntax used in the log4 configuration file, go to https://logging.apache.org/log4j/2.x/

The configuration file is <ACTIVID_HOME>/ActivID_AS/applications/resources/srv/srvlog4j.xml

Set the logging level in the srv-log-level property.

For example, to set the logging level to DEBUG:

<Property name="srv-log-level">DEBUG</Property>

The configuration file is <ACTIVID_HOME>/ActivID_AS/applications/resources/mc/mclog4j.xml

Set the logging level in the mc-log-level property.

For example, to set the logging level to DEBUG:

<Property name="mc-log-level">DEBUG</Property>

The configuration file is <ACTIVID_HOME>/ActivID_AS/applications/resources/ssp/ssplog4j.xml

Set the logging level in the ssp-log-level property.

For example, to set the logging level to DEBUG:

<Property name="ssp-log-level">DEBUG</Property>

Note: After updating the logging configuration, the changes are taken into account after few minutes. For the changes to be applied immediately, you have to restart the applications.