萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Nginx 日誌模組深度解析:error_log 與 access_log 運作機制

Nginx 的日誌系統圍繞兩大核心指令:error_log(錯誤日誌)與 access_log(存取日誌)。理解其底層運作,有助於高效排錯與效能調優。

一、error_log:雙模組共存的設計智慧

Nginx 內建兩個模組皆提供 error_log 指令:

  • ngx_errlog_module:核心層級,配置類型 NGX_MAIN_CONF,記錄進程啟動、事件模組、Socket 監聽等系統級事件,儲存於 cycle->new_log。
  • ngx_http_core_module:HTTP 層級,配置類型 NGX_HTTP_MAIN_CONF|SRV_CONF|LOC_CONF,記錄 HTTP 請求處理過程中的錯誤,儲存於 ngx_http_core_loc_conf_t->error_log。

為何不合併? 模組註冊順序決定了解析優先權。核心模組(如 event、regex)需在 HTTP 模組初始化前就能寫日誌,若合併會導致耦合與作用域衝突。兩套機制各司其職:cycle->new_log 服務於「進程生命週期」,clcf->error_log 服務於「請求生命週期」。

二、access_log:支援變數路徑的高效寫入

access_log 隸屬 ngx_http_log_module,處於 NGX_HTTP_LOG_PHASE 階段(請求結束時執行)。關鍵特性:

  • 變數路徑:如 access_log logs/'$remote_addr'access.log main; 可依客戶端 IP 自動分檔。
  • 檔案描述符快取:常量路徑下,Nginx 緩存 fd 至 cycle->open_files 避免重複 open();變數路徑則透過 ngx_http_log_script_t 動態解析。
  • open_log_file_cache:可進一步快取檔案元資料,減少 stat() 系統呼叫。

三、日誌檔案描述符何時會變更?

僅在兩種情況:

  1. 進程重啟(Master/Worker 重生)。
  2. 收到 NGX_REOPEN_SIGNAL(預設 SIGUSR1),觸發日誌切割(如 logrotate 配合 kill -USR1)。

其他情況(如手動刪除日誌檔)不會 自動建立新檔,且寫入資料將丟失(fd 仍指向已刪除的 inode)。生產環境請務必使用 logrotate + postrotate 發送重開信號。

copyright © 萬盛學電腦網 all rights reserved