Skip to main content
Planview Customer Success Center

How do I change Hub's logging configuration?

Last Updated:    |  Applicable Hub Versions: All

Answer

The simplest way to increase logging is from the Settings page, to enable a duration for the Troubleshooting mode which will provide detailed TRACE logs for the time period specified.

Logging can be configured by editing the log4j.xml file in your Hub installation directory or if not available there, the working directory (e.g., C:\ProgramData\Tasktop).

The most common configuration change made to Hub's logging is to change the logging level of various log categories. In log4j.xml, there is a <logger> element for each log category. Find the <logger> element for the category you want, and change the value of the <level> element under it. Valid levels are errorwarninfo, and trace. As an example, the following will set the logging level for Hub core log messages to trace:

<logger name="com.tasktop.data">   <level value="trace" /> </logger>

For connector level logging, the following will set the logging level for Hub Connectors to trace:

<logger name="com.tasktop">   <level value="trace" /> </logger>

For more information on all possible logging configuration, refer to the Log4j documentation.

Note: Hub must be restarted for changes to the logging configuration to take effect.