Octopus Deploy Server and Tentacles write diagnostic log messages to their local Windows filesystem. The files are rolled periodically to avoid consuming excessive space.
The most recent warnings and errors can be view on the Configuration ➜ Diagnostics page
Finding the log files
When Octopus applications are installed, a "home directory" is chosen - this is usually
Octopus stores its logs in the
Logssubdirectory. Three sets of log files may be present:
OctopusTentacle.txt. Older versions of these files will be stored with numeric suffixes in their names, e.g. the most recent archived server log file will be in
When requesting support, send as much log information as possible - the repetitive nature of the files means they usually zip down well.
Changing log levels
Occasionally it may be necessary to change the logging level of an Octopus application.
First, find the
octopus.server.exe.nlog file associated with the application. This is usually in a subfolder of the Octopus "Program Files" folder. Take a backup of the file before making changes.
The verbosity of file logging is controlled in the
<logger name="*" minlevel="Info" writeTo="octopus-log-file" />
minlevel attribute is most useful for configuring the logging level. Change this value to
Trace to gather more information.
The Octopus process will automatically switch to the new logging level as soon as the file is saved.
Don't forget to reset your changes
minlevel too low will impact the performance of Octopus Server. We recommend resetting back to the default logging configuration once you have completed your diagnostics session.