From: mozilla%colinogilvie.co.uk <>
Date: Fri, 9 Sep 2005 03:57:06 +0000 (+0000)
Subject: Bug 165589: Add error logging support to Bugzilla (Docs Part)
X-Git-Tag: bugzilla-2.20~23
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7fc1db49d56f5c721e28424b48b26ee0f19eba1a;p=thirdparty%2Fbugzilla.git

Bug 165589: Add error logging support to Bugzilla (Docs Part)
Patch by: A. Karl Kornel <karl@kornel.name>; r=colin.ogilvie
---

diff --git a/docs/xml/troubleshooting.xml b/docs/xml/troubleshooting.xml
index e3b54b6e8b..46308bdc66 100644
--- a/docs/xml/troubleshooting.xml
+++ b/docs/xml/troubleshooting.xml
@@ -1,5 +1,5 @@
 <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"> -->
-<!-- $Id: troubleshooting.xml,v 1.5 2005/02/05 04:31:46 travis%sedsystems.ca Exp $ -->
+<!-- $Id: troubleshooting.xml,v 1.5.4.1 2005/09/08 20:57:06 mozilla%colinogilvie.co.uk Exp $ -->
 
 <appendix id="troubleshooting">
 <title>Troubleshooting</title>
@@ -29,6 +29,19 @@
     fix the problem. If not, see below for some commonly-encountered 
     errors. If that doesn't help, post the errors to the newsgroup.
     </para>
+
+    <para>
+      Bugzilla can also log all user-based errors (and many code-based errors)
+      that occur, without polluting the web server error log.  To enable
+      Bugzilla error logging, create a file that Bugzilla can write to, named
+      <filename>errorlog</filename>, in the Bugzilla <filename>data</filename>
+      directory.  Errors will be logged as they occur, and will include the type
+      of the error, the IP address and username (if available) of the user who
+      triggered the error, and the values of all environment variables; if a
+      form was being submitted, the data in the form will also be included.
+      To disable error logging, delete or rename the
+      <filename>errorlog</filename> file.
+    </para>
   </section>
         
   <section id="trbl-testserver">