之前在測試支持HTTP3的nginx服務器時遇到了一些問題，希望能夠通過nginx的error.log日志進行排查(error.log有debug級別的日志)，但是配置后并沒有生效，從官網查找了下關于debug日志的資料，翻譯如下。

想要開啟debug日志，需要在構建的時候將nginx配置為支持debug:

./configure --with-debug ...

接著可以將error日志的日志級別設置為debug

error_log /path/to/log debug;

預構建的Linux包提供了開箱即用的nginx-debug二進制文件(1.9.8)的調試日志支持，它可以通過如下命令運行，接著設置日志級別為debug級別就行。

service nginx stop service nginx-debug start

Windows 下的 nginx 的二進制版本在構建的時候都已經支持 debug 日志，因此只需設置日志為 debug 級別即可。

如果你在多個地方指定了日志級別，若在最近指定日志級別時沒有設置為 debug 級別，debug 日志將會被禁用 。在下述例子中，在 server 層重新指定了日志級別，將會導致該server的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;...

指定客戶端的debug日志

debug級別的日志會打印大量信息，有可能把磁盤寫滿，如果既想避免這種情形又希望能看到debug日志，可以只為指定的客戶端地址發來的請求開啟 debug 日志：

error_log /path/to/log;events {debug_connection 192.168.1.1;debug_connection 192.168.10.0/24; }

使用循環內存緩存區域記錄日志

上述debug日志可以寫入到一個循環使用的內存緩沖區

error_log memory:32m debug;

即使在高負載的情形下，把debug級別的日志寫入到內存緩沖區也不會對nginx性能產生顯著影響。
在這種情形下，可以使用如下gdb腳本提取日志:

set $log = ngx_cycle->logwhile $log->writer != ngx_log_memory_writerset $log = $log->next end

原文鏈接:
A debugging log

總結

以上是生活随笔為你收集整理的nginx如何开启debug日志及相关配置的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。