9. Troubleshooting and Debugging

Debugging

Occasionally you'll run into issues that prevent you from running test correctly. In order to pinpoint the issue, Zanebug provides a run-time logging engine to view events as they happen, via the log4net library. Unfortunately, because Zanebug loads test assemblies in remote AppDomains, the logging information can't be put into a simple .log file. Instead, you have to view events using a special TraceTool.

Using the TraceTool

In order to use the TraceTool, you'll need to do the following:

  1. Close any running instances of Zanebug

  2. Open the .config file

  3. Locate this section:

    		<root>
    			<level value="ERROR" />
    			<appender-ref ref="ConsoleAppender" />
    			<appender-ref ref="LogFileAppender" />
    			<!--appender-ref ref="TraceToolAppender" /-->
    		</root>
    

    Change it to this:

    		<root>
    			<level value="DEBUG" />
    			<appender-ref ref="ConsoleAppender" />
    			<appender-ref ref="LogFileAppender" />
    			<appender-ref ref="TraceToolAppender" />
    		</root>
    

    You'll note that ERROR was changed to DEBUG, and the TraceToolAppender section was uncommented

  4. Open the [install dir]\TraceTool.exe

  5. Launch Zanebug and run your tests

You'll see all logged information sent to the TraceTool in real-time.

Note

In order for the Zanebug uninstall to complete correctly, you'll need to shutdown the TraceTool. You can do this via the Windows Taskbar or Task Manager.