Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To resolve complex issues, our VSoft team may need request some additional debugging information. Note Please note that debugging can will slow down the performance of your Continua environment so , it is highly recommended that you only enable debugging when you have an issue. Once your issue has been resolved, it is also highly recommended that you disable debugging.

To enable debugging on the server you will need to modify the Continua.Server.Service.exe.config file. By default, this is located at C":\Program Files\VSoft Technologies\ContinuaCI\Server".

To enable debugging on an agent you will need to modify the Continua.Agent.Service.exe.config file. By default, this is located at "C:\Program Files\VSoft Technologies\ContinuaCI Agent". Agent debugging can be useful for troubleshooting issues running actions as these are run by the Agent service

It can sometimes be useful to enable website debugging to troubleshoot issues such as website authentication. To do this you must first ensure that debugging is enabled on the server, then you will need to modify the Web.config file. By default, this is located in the folder "C:\Program Files\VSoft Technologies\ContinuaCI\Web" .Website debug messages are sent to the server for logging according to the server configuration.

Info

Note: It is highly recommended that you backup your config file before you modify its contents.

 


Open this Open the server or agent configuration file with notepad and find the <loggers> section under <continua-configuration>. you should see the following values:

Code Block
languagehtml/xml
<loggers>
	<logger name="Continua.Shared.Logging.WindowsEventLogLogger, Continua.Shared.Logging" level="Quiet"/>
	<!-- Uncomment the following line to enable logging to the diagnostics app.
	<logger name="Continua.Shared.Logging.UdpLogger, Continua.Shared.Logging" level="Debug" />
	-->
	<!-- Uncomment the following line to enable logging to a file
	<logger name="Continua.Shared.Logging.FileLogger, Continua.Shared.Logging" level="Debug" /> 
	-->
	<!-- Uncomment the following line to see logging when running Continua with the -console flag -->
	<logger name="Continua.Shared.Logging.FormattedConsoleLogger, Continua.Shared.Logging" level="Quiet"/>
</loggers>

...


File Logging

Enabling file logging will write all debug information to C:\ProgramData\VSoft\ContinuaContinuaCI\Logs. Note that ProgramData may be a hidden directory. Logs will be written to this folder and each log can be identified by the date the log was generated. Each log has the following name <year><month><date>. Logging will be added to the current log until the next day ticks over.

...

To disable debugging, which is highly recommended once your issue has been resolved, simply comment out the line above with <!-- --> .

You can also specify a folder to save the debug log to with the location option and add a suffix to the file name using the fileSuffix option . e.g.

Code Block
languagehtml/xml
<logger name="Continua.Shared.Logging.FileLogger, Continua.Shared.Logging" options="location: 'D:\ContinuaCI\Logs'; fileSuffix: Server1" /> 

The Continua Server and/or Agent service will need to be restarted once you have enabled, disabled or disabled made changes to file debugging.

UDP Logging

...

The Continua Server and/or Agent service will need to be restarted once you have enabled or disabled UDP debugging.

To enable website debug logging, edit the Web.config file as follows:

Code Block
languagehtml/xml
<appSettings>
...
	<add key="Continua.Web.Debug" value="true" />
</appSettings>