The Logging Levels page can be used to modify logging levels of various classes.
UniTime is using log4j for logging. Each class writing messages into the log is using a separate logger, typically named after the class. The loggers form a tree in a similar manner as the classes do. A logging level can be changed for a particular class (logger) or for all classes (loggers) of a given package. For instance, all org.hibernate.cfg classes have the logging level set to Warning, meaning that only warnings or higher messages (errors, fatals) appear in the log. The following logging levels are available:
If a logging level is set to a particular level, only messages of the level or higher are printed in the log. The page requires Application Config permission.
UniTime logging is defined in the application properties (see application.properties) and can be overridden using custom properties (see customization). The changes to the logging made on the Logging Levels page are saved in the custom properties as well (see Application Configuration page). The format is
where <logger> is the name of the logger and <level> is the level, i.e., one of TRACE, DEBUG, WARN, ERROR, or FATAL.
By default, the logging messages are written in Tomcat/logs/unitime.log. Warning and higher messages are also written in the MessageLog table using the MessageLogAppender. The logging level for the MessageLog can be changed using the unitime.message.log.level application property (it defaults to WARN). The messages from the message log can be seen on the Administration Reports page, Message Log report.
To edit or delete a logging level, click on the appropriate line, Edit Logging Level page will appear. All the roles can be edited on the Edit Logging Levels page. To do so, click on the Edit button.
A new logging level can be added on the Edit Logging Levels page (button Edit) or using Add Logging Level page (button Add).
The table can be ordered by any of the columns. To do so, click on the column header and select Sort by <column name> option.
The Message Log report has the following HQL: