A debugging log
一个调试日志
- 调试所选客户端的日志
- 记录到循环内存缓冲区
要启用调试日志,需要配置nginx以在构建期间支持调试:
./configure --with-debug ...
之后debug
应该使用error_log指令设置关卡:
error_log /path/to/log debug;
要验证nginx是否配置为支持调试,请运行以下nginx -V
命令:
configure arguments: --with-debug ...
预先构建的Linux软件包提供开箱即用的支持,以便nginx-debug
使用可以使用命令运行的二进制文件(1.9.8)来调试日志
service nginx stop
service nginx-debug start
然后设置debug
级别。Windows的nginx二进制版本始终是用调试日志支持构建的,因此只需设置该debug
级别即可。
请注意,重新定义日志而不指定debug
级别将禁用调试日志。在下面的示例中,重新定义服务器级别的日志会禁用此服务器的调试日志:
error_log /path/to/log debug;
http {
server {
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;
events {
debug_connection 192.168.1.1;
debug_connection 192.168.10.0/24;
}
记录到循环内存缓冲区
调试日志可以写入循环内存缓冲区:
error_log memory:32m debug;
即使在高负载情况下,在调试级别上记录到内存缓冲区也不会对性能产生重大影响。 在这种情况下,可以使用gdb脚本来提取日志,如下所示:
set $log = ngx_cycle->log
while $log->writer != ngx_log_memory_writer
set $log = $log->next
end
set $buf = (ngx_log_memory_buf_t *) $log->wdata
dump binary memory debug_log.txt $buf->start $buf->end