Log4j configuration for log files

This topic outlines the log4j configuration details for IBM® Operations Analytics Log Analysis, the Generic Receiver, and the EIF Receiver

Note: All log4j log files for IBM Operations Analytics Log Analysis are set to a default maximum file size of 50 MB with 20 backup files at this maximum.

EIF Receiver log settings

The IBM Operations Analytics Log Analysis EIF Receiver has 2 logging components.

Standard EIF component logging

This is provided for the generic piece of the EIF Receiver and is controlled by the <HOME>/UnityEIFReceiver/config/eif.conf file. The default log level is ALL and the default log file is $UNITY_HOME/UnityEIFReceiver/logs/eif.log. For more information, see the Event Integration Facility Information Center.

log4j logging

The log4j logging is provided for wrapper code provided by IBM Operations Analytics Log Analysis. The log4j file for the EIF Receiver is named UnityEifReceiver.log and is added to the <HOME>/logs directory. The default log level is set to INFO. This log level can be changed to DEBUG by changing the log4j.logger.Unity=INFO property in the <HOME>/UnityEIFReceiver/jars/log4j.properties file to log4j.logger.Unity=DEBUG. At this level, all records read by the EIF Receiver are reported. The TRACE log level produces a higher volume of data and is only used for small files or for a small period of time. Otherwise, very high disk space usage can result. If required, you can also enable console logging. You can configure the logging level to provide detail based on the level you select:

INFO: Provides summary information
DEBUG: Provides detailed information
TRACE: Provides the greatest level of details available

Log4j log levels indicate an issue using WARN, ERROR, or FATAL log entries.

IBM Operations Analytics Log Analysis and Generic receiver log files

The log4j file configuration file for IBM Operations Analytics Log Analysis and the Generic receiver is named log4j.properties and is located in the <HOME>/wlp/usr/servers/Unity/apps/Unity.war/WEB-INF/classes directory.

The log4j file for IBM Operations Analytics Log Analysis is named UnityApplication.log and for the Generic receiver it is named GenericReceiver.log. Both files are added to the <HOME>/logs directory. The default log level is set to INFO.

You can change the log level for IBM Operations Analytics Log Analysis or the Generic Receiver to ERROR, DEBUG, or WARN by changing the appropriate property in the log4j.properties configuration file. To change the IBM Operations Analytics Log Analysis log level, amend thelog4j.logger.Unity=INFO property. To change the log level for the Generic receiver log to ERROR, DEBUG, or WARN, change the log4j.logger.UnityGenericReceiver=INFO property.