As of December 31st, 2023 ThreadFix 2.X has reached End of Life and is no longer supported. For any further information please contact the Success and Implementation team.

Troubleshooting

Overview

When reporting errors or trying to debug unexpected behaviors in ThreadFix, it helps to know where to find logs and error messages that are generated. In addition, it can be helpful to increase the amount of logging in order to get access to more thorough debug information. This document describes where ThreadFix logs messages and error conditions as well as how to increase the amount of logging for deeper debugging.

Log Messages

ThreadFix logs events to text files. The default logging level is set to INFO. In addition, Tomcat logs its operations as well as STDOUT and STDERR.

Location of Log Messages

You can find these log files in <path/to/tomcat>/logs/ in the standard Tomcat installation. Note that in a typical configuration, these log files will roll over on a daily basis. The logging mechanism will name the older log files with the date of their creation. The log files are:

  • threadfix.log - ThreadFix-specific logging messages. Look here first.

  • catalina

  • localhost

  • manager

  • host-manager

Increasing the Amount of Logging

The default ThreadFix logging level of INFO is sufficient to debug most normal operations and error conditions. However, in certain cases there may be value in having access to more in-depth logging information. To increase the level of logging, update the logging configuration file and restart Tomcat.

The logging configuration file is located in the following file: <threadfix_deploy>/WEB-INF/classes/logback.xml (for versions prior to 2.8.5.1, the file would be log4j.xml)

You can update the root level logging as follows:

logback.xml
  <root level="DEBUG">
    <appender-ref ref="CONSOLE"/>
    <appender-ref ref="fileAppender"/>
  </root>

DEBUG logging results in degraded server performance and should only be used for troubleshooting. You should set the level back to INFO and restart Tomcat when finished.

System Error Messages

ThreadFix attempts to trap error conditions and return sensible error messages to the user. In cases where ThreadFix throws an unexpected exception, the system saves the message to the ThreadFix database. You can find these messages under ? → Error Messages.


www.threadfix.it | www.coalfire.com
Copyright © 2024 Coalfire. All rights reserved.

This Information Security Policy is CoalFire - Public: Distribution of this material is not limited.