Debugging


How is it activated?

  • Windows: set fDebug to 1 in the registry (HKLM/Software/Fog Creek Software/[fb_install])
  • Unix set fDebug to 1 in the application.data file (found in /opt/fogbugz/Accessories)

What does it do?

  • A Tokens and Source link are shown above incoming emails in the case view. Tokens allows you to see how the mail was parsed into tokens for Bayesian analysis. Source allows you to view the original source of the incoming message
  • When logged on as an Administrator, you can visit this page: default.asp?pg=pgSQL to execute queries directly against your database, but only when you browse to it from the server hosting FogBugz (i.e. the web request is coming from localhost). Please be aware there are no checks on this and it is the same as direct database access. You should backup your database before ever typing any queries into this page.
  • On Windows: All outgoing and incoming mail connections are logged. These log files are purged after 1 week.

Where are the logs written?

  • Windows:
    • Outgoing mail is logged to:
      C:\Program Files (x86)\FogBugz\website\..\FileUploads\smtp.txt
    • Incoming mail is logged to:
      C:\Program Files (x86)\FogBugz\website\..\FileUploads\pop.txt
  • Linux: not applicable!

 

Maintenance Service Logging


How is it activated?

  • Windows: complete instructions for activating can be found here.
  • Unix: maintenance service logging is always enabled.

What does it do?

  • Creates a log entry every time the maintenance service wakes up and hits the maintenance URL.

Where are the logs written?

  • Windows:
    • You can check the Event Viewer to be certain, but the log is usually written to: C:\Users\[fogbugz_user]\AppData\Local\Temp\FogBugzMaint.txt
  • Linux:
    • /opt/fogbugz/logs/hb.log

 

Website Logging


How is it activated?

What does it do?

  • Creates log entries for all heartbeat tasks (Bayesian training, search indexing, mail delivery and retrieval, etc.) and other FogBugz web requests.
  • Do not leave this log enabled! It will grow very large!

Where are the logs written?

  • On Windows:
    • C:\Program Files (x86)\FogBugz\fogbugz_log.txt
  • On Linux:
    • /opt/fogbugz/fogbugz_log.txt

Pro-tips!

If the log indicates that a particular step in the heartbeat process is taking a long time, you may try skipping it temporarily for debugging. You can follow these instructions to do so in the Windows Registry, *nix/Mac application.data file, or simply as adding parameters to [Your FogBugz URL]/heartbeat.asp.

Setting HKLM/SOFTWARE/Fog Creek Software/FogBugz/Logging to 5 or 10 will trigger logging to FogUtil.txt.

Misc

What goes in /opt/fogbugz/logs/error.log on unix?

The FogBugz Apache process and the fogbugzctl script both write here.