Managing Logging
Info*Engine uses the Apache log4j package (bundled with Info*Engine) to produce all log messages.
To manage logging, you should be familiar with the following:
• General information about the log4j package.
The following URL takes you to an introduction to log4j:
• General information about setting log levels, working with log files, and viewing and emailing the log files for all
Windchill products. For more information, see
Managing Windchill Logging.
• The loggers that are used for Info*Engine logging.
For descriptions of the out-of-the-box Windchill loggers, view the following file:
<Windchill>/codebase/loggers.html
The Info*Engine server uses the following loggers:
com.infoengine.log.audit
com.infoengine.log.debug
com.infoengine.log.error
com.infoengine.log.info (for Information)
com.infoengine.log.stat (for Statistics)
com.infoengine.log.transaction
These logger names mimic the previously defined Info*Engine log levels. Log messages issued to each of the legacy log levels are now issued to the corresponding log4j logger. Because these loggers replace the legacy logging, each logger is either essentially on or off. The error logger issues its messages on the ERROR log level, the debug logger issues its messages on the DEBUG log level, and all other loggers issue their messages on the INFO log level.
Because of this organization, you can enable all standard Info*Engine information logging by setting the log level of the parent logger (named com.infoengine.log) to INFO. This will enable all loggers except for the debug logger. To enable all Info*Engine logging, you can do one of the following:
• Set com.infoengine.log to DEBUG or ALL.
• Individually control each logger by configuring its log level separately.
Out of the box, only error logging is enabled.
You can set Info*Engine log file locations and logging levels for each logger in the following properties file (located in the <Windchill>/codebase/WEB-INF directory):
log4jMethodServer.properties
This file controls logging directly related to the Windchill method servers including all Info*Engine server messages when one or more Windchill solutions are installed. Since Tomcat is embedded in the method server, the Info*Engine log messages related to the interaction between the servlet engine and Info*Engine services are also captured using the settings in log4jMethodServer.properties. These messages are related to JSP processing and communications.
The default location for the log file is within the <Windchill>/logs directory.
Info*Engine maintains logger settings for each Info*Engine component. However, in-process gateway and adapter log messages are logged according to the settings for the server where the gateway or adapter is running in process.