Debug Variables¶

• Table of contents
• Debug Variables
  • Core
  • mod_fcgi - Fastcgi Module
  • mod_auth - Authentication Module
  • mod_proxy - Proxy Module
  • mod_proxy_core - Proxy Core Module (Version 1.5)
  • mod_simple_vhost - Simple Vhost Module
  • mod_trigger_b4_dl - Trigger Before Download Module
  • mod_status - Status Module
  • mod_webdav - !WebDav module
  • See Also

To enable these settings, set them to "enable".

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

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 fastcgi troubleshooting (bottom of page)

mod_auth - Authentication Module¶

auth.debug
0 for off, 1 for 'auth-ok' messages, 2 for verbose debugging

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.

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.

mod_simple_vhost - Simple Vhost Module¶

simple-vhost.debug = 1

mod_trigger_b4_dl - Trigger Before Download Module¶

trigger-before-download.debug = "disable"

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

Documentation for mod_status

mod_webdav - !WebDav module¶

webdav.log-xml = "enable"

log the XML Request bodies for debugging

See Also¶

• How To backtrace, strace, ktrace memory leaks
• Log Condition Handling Blog Entry