How to Enable Full Website Logging in FogBugz


Follow

Available as of FogBugz 7.2.17.

In order for this to work, the FogBugz user must have permission to WRITE to the FogBugz directory (e.g., C:\Program Files (x86)\FogBugz or /opt/fogbugz). This is NOT granted by default during the installation!

FogBugz 7.2.17 introduces full website logging. This is in addition to the existing maintenance service logging which tells you when the service runs; full website logging will tell you what goes on when the service hits the heartbeat URL.

Log events are written to a file called “fogbugz_log.txt“. On Windows and Linux, the file lives next to the Website folder (it is a sibling of the Website folder).

At present, this log file will keep on growing, so please make sure you turn logging off when you’re done troubleshooting! 🙂

The nLogThreshold registry value must be set to one of the following numbers:

0  (LOG_LEVEL_NONE)
1  (LOG_LEVEL_INFO)
5  (LOG_LEVEL_WARNING)
10 (LOG_LEVEL_DEBUG)
20 (LOG_LEVEL_PLUGIN)

How to enable

On Windows:

Use the nLogThreshold registry value to enable logging in FogBugz. This flag is set in the registry as a string, REG_SZ (string) inside your FogBugz installation’s key:

HKEY_LOCAL_MACHINE\SOFTWARE\Fog Creek Software\FogBugz\c:/yourfogbugz/website

(where c:/yourfogbugz/website is the path to your installation)

  1. Open the registry editor
  2. Find the key above
  3. Find the nLogThreshold value if it exists
    1. If it is not present, right-click in the right-hand pane and select New -> string value
    2. Name it nLogThreshold
  4. Set the value to one of the log level numbers listed above (0, 1, 5, 10 or 20)

On Linux:

Add the nLogThreshold value to your application.data file, which is located in [path_to_fogbugz]\Accessories.

Usage examples

  • If you set nLogThreshold to “10” (DEBUG) then all INFO, WARNING and DEBUG log events will be logged, but PLUGIN events will not.
  • If you set it to “1” (INFO) then only INFO log events will be logged.