Using FogBugz On Demand? We've recently rolled out a new sidebar as part of taking FogBugz forward. Please see this article for details on what's new, what's changed, and where you can find all your favorite things.

When troubleshooting FogBugz On Site, it may be beneficial to enable logging either temporarily or permanently. If you’d like to permanently enable logging, please contact us so we can make sure you have a tractable plan for managing the volume of logs that can be created. The rest of this article is intended to help with temporarily logging to a file. For help with FogBugz 8.8.55 and below, please see the doc for logging with FogBugz For Your Server.

On Site ships with a basic log4net configuration that will meet most of your temporary logging needs. For those familiar with log4net, adjusting the verbosity and targets of the logs works as expected. Need help getting to the bottom of something? Contact us! We’re always happy to help.

Website Logging

Website logging enables output for each and every web request handled by FogBugz.

To enable website logging:

  1. Navigate to [Your On Site installation directory]\installed-components\fogbugz\fogbugz_{version}\Website
  2. Edit logging.config
  3. Uncomment the appropriate appender-ref node under the <root> node:
     <appender-ref ref="File" />
  4. (Optional) Change the log file location (default: C:\logs\fogbugz.log) and ensure the path exists
  5. Save the file

To disable website logging:

  1. Navigate to [Your On Site installation directory]\installed-components\fogbugz\fogbugz_{version}\Website
  2. Edit logging.config
  3. Comment out the appropriate appender-ref node under the <root> node:
     <!-- <appender-ref ref="File" /> -->
  4. Save the file

Heartbeat Pinger Logging

The Heartbeat Pinger ensures that periodic tasks in FogBugz (checking mail, firing Web Hooks, sending notifications, etc) are run. If these tasks aren’t working and website logging doesn’t indicate any problems, there might be a problem with Heartbeat.

To enable FogBugz Heartbeat Pinger logging:

  1. Navigate to [Your On Site installation directory]\installed-components\heartbeatpinger\heartbeatpinger_{version}
  2. Edit logging.config
  3. Ensure the file appender node (under the main <log4net> node) is uncommented, and adjust the file location if desired (default: C:\logs\pinger.log):
    <appender name="File" type="log4net.Appender.FileAppender">
      <file value="c:\logs\pinger.log" />
      <appendToFile value="true" />
      <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
      <layout type="log4net.Layout.PatternLayout" >
        <conversionPattern value="%utcdate %level %thread %logger - %message%newline" />
      </layout>
    </appender>
  4. Enable the file appender by uncommenting the appropriate appender-ref node under the <root> node:
     <appender-ref ref="File" />
  5. Save the file.

To disable Heartbeat Pinger logging:

  1. Navigate to [Your On Site installation directory]\installed-components\heartbeatpinger\heartbeatpinger_{version}
  2. Edit logging.config
  3. Comment out the appropriate appender-ref node under the <root> node:
     <!-- <appender-ref ref="File" /> -->
  4. Save the file