DebugVariables » History » Revision 18
Revision 17 (nitrox, 2012-08-11 10:42) → Revision 18/23 (stbuehler, 2012-12-13 10:53)
h1. Debug Variables
{{>toc}}
The debug output will be written to the error.log. Please keep in mind that you can have only one global error.log.
If you don't know which debug option to go for, start with
<pre>
debug.log-request-handling = "enable"
</pre>
To enable these settings, set them to "enable".
h2. Core
*debug.log-request-header*
log all request headers.
default: disabled
*debug.log-request-header-on-error*
log request header, but only when there is an error.
default: disabled
*debug.log-response-header*
log the header we send out to the client.
default: disabled
*debug.log-file-not-found*
log if a file wasn't found.
default: disabled
*debug.log-request-handling*
log request handling inside lighttpd.
default: disabled
*debug.log-condition-handling*
log conditionals handling for debugging
default: disabled
See http://blog.lighttpd.net/articles/2006/04/02/log-condition-handling-the-hidden-feature-for-debuging
*debug.log-condition-cache-handling*
for developers only
default: disabled
*debug.log-ssl-noise*
log some ssl warnings we hide by default (ssl handshake, unknown/bad certificate).
default: disabled
*debug.log-timeouts*
NOTE: a request for /xxx.. timed out after writing xxx bytes. We waited xxx seconds. If this a problem increase server.max-write-idle
default: disabled
h2. mod_fcgi - Fastcgi Module
*fastcgi.debug*
a value between 0 and 65535 to set the debug-level in the FastCGI module. Currently only 0 and 1 are used. Use 1 to enable some debug output, 0 to disable it.
see also [[lighttpd:Docs_ModFastCGI|fastcgi troubleshooting (bottom of page)]]
h2. mod_auth - Authentication Module
*auth.debug*
0 for off, 1 for 'auth-ok' messages, 2 for verbose debugging
h2. mod_proxy - Proxy Module
*proxy.debug*
a value between 0 and 65535 to set the debug-level in the Proxy module. Currently only 0 and 1 are used. Use 1 to enable some debug output, 0 to disable it.
h2. mod_proxy_core - Proxy Core Module (Version 1.5)
*proxy-core.debug*
a value between 0 and 65535 to set the debug-level in the Proxy module. Currently only 0 and 1 are used. Use 1 to enable some debug output, 0 to disable it.
h2. mod_simple_vhost - Simple Vhost Module
simple-vhost.debug = 1
h2. mod_trigger_b4_dl - Trigger Before Download Module
trigger-before-download.debug = "disable"
h2. mod_status - Status Module
mod_status is also a great tool to troubleshoot lighttpd.
The server status module generates the status overview of the webserver. The information covers:
** uptime
** average throughput
** current throughput
** active connections and their state
[[lighttpd:Docs_ModStatus|Documentation for mod_status]]
h2. mod_webdav - !WebDav module
webdav.log-xml = "enable"
log the XML Request bodies for debugging
h2. See Also
* [[HowToReportABug|How To backtrace, strace, ktrace memory leaks]]
* "Log Condition Handling":http://blog.lighttpd.net/articles/2006/04/02/log-condition-handling-the-hidden-feature-for-debuging Blog Entry