Mercurial > hg > nginx-site
changeset 213:5284967934df
Improved markup and wording.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Wed, 30 Nov 2011 09:19:04 +0000 |
parents | 18217133791f |
children | c99c8df86eb9 |
files | xml/en/docs/debugging_log.xml |
diffstat | 1 files changed, 22 insertions(+), 18 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/debugging_log.xml Tue Nov 29 11:22:26 2011 +0000 +++ b/xml/en/docs/debugging_log.xml Wed Nov 30 09:19:04 2011 +0000 @@ -8,56 +8,60 @@ <section> <para> -To enable a debugging log, you first should configure nginx to build with -the debugging: +To enable a debugging log, nginx needs to be configured to support +debugging during the build: <programlisting> ./configure --with-debug ... </programlisting> -and then set the <dirname>debug</dirname> level -of the <dirname>error_log</dirname>: +Then the <value>debug</value> level should be set with the +<link doc="ngx_core_module.xml" id="error_log"/> directive: <programlisting> -error_log /path/to/log debug; +error_log /path/to/log debug; </programlisting> -The nginx/Windows binary version is always built with the debugging log -support. Therefore, you should set the <dirname>debug</dirname> level only. +The nginx binary version for Windows is always built with the debugging log +support, so only setting the <value>debug</value> level will suffice. </para> <para> -Note, that a defining log on another level, for example, on <i>server</i> +Note that redefining the log without also specifying the <value>debug</value> +level will disable the debugging log. +In the example below, redefining the log on the +<link doc="http/ngx_http_core_module.xml" id="server"/> level disables the debugging log for this server: <programlisting> -error_log /path/to/log debug; +error_log /path/to/log debug; http { server { - error_log /path/to/log; + error_log /path/to/log; ... </programlisting> -You should either comment out this server log or add -the <dirname>debug</dirname> flag too: +To avoid this, either the line redefining the log should be +commented out, or the <value>debug</value> level specification should +also be added: <programlisting> -error_log /path/to/log debug; +error_log /path/to/log debug; http { server { - error_log /path/to/log debug; + error_log /path/to/log debug; ... </programlisting> </para> <para> -It is also possible to enable the debugging log only for some addresses: +It is also possible to enable the debugging log for selected addresses only: <programlisting> -error_log /path/to/log; +error_log /path/to/log; events { - debug_connection 192.168.1.1; - debug_connection 192.168.10.0/24; + debug_connection 192.168.1.1; + debug_connection 192.168.10.0/24; } </programlisting> </para>