Change the logging levels
In this topic
Changing the logging level can help troubleshoot installation and configuration issues. The following log levels are available for EM4C Server and EM4C Dispatcher:
- DEBUG
- INFO
- WARN
- ERROR
- FATAL
EM4C Server
The default level of logging is ERROR, which is suitable in most situations.
To change the log settings for EM4C Server, the following must be completed on each EM4C Server computer.
These steps must be performed by an administrator.
- Browse to <em4c_location>\webapps\em4c\WEB-INF\classes.
- Open the log4j.properties file in a text editor.
- Change the following lines (as appropriate):
log4j.logger.com.esri.em4c.cognos.custom.customRequestHandler=ERROR, stdout log4j.logger.com.esri.em4c=ERROR, stdout, A1 - Restart EM4C Server.
Note:
You can use Esri Maps for IBM Cognos Configuration on the EM4C Server computer to change the log file location for this component.
EM4C Dispatcher
EM4C Dispatcher logging must be manually configured.
By default, EM4C Dispatcher logs its entries in the IBM Cognos cogserver.log file. You can enable additional logging to help troubleshoot issues with EM4C Dispatcher.
Caution:
Enabling additional logging is recommended only for debug purposes. Configuring logging as a permanent process will affect system performance.
- On each EM4C Dispatcher in your environment, make a backup of the log4j.properties file. This file can be found in the following location:
<ibmcognos_root>\webapps\p2pd\WEB-INF\classes\
- Add the following to each log4j.properties file in your environment:
log4j.logger.com.esri.em4c.cognos.handlers.RSVPHandler=trace,EM4C log4j.logger.com.esri.em4c.cognos.handlers.ServiceStatusThread=trace,EM4C log4j.appender.EM4C=org.apache.log4j.DailyRollingFileAppender log4j.appender.EM4C.file=C:/logs/em4c_handler.log log4j.appender.EM4C.layout=org.apache.log4j.PatternLayout log4j.appender.EM4C.layout.ConversionPattern=%d %5p (%M:%F:%L) - %m%n - Restart the IBM Cognos service.
A log file, em4c_handler.log, is created in the location specified by the log4j.appender.EM4C.file property. You can specify a different location or file name by changing the value of this property.
- If you need help reading and understanding the log file, contact Esri Support.