nginx日誌對於統計、系統服務排錯很有用。nginx日誌主要分為兩種:access_log
(訪問日誌)和error_log
(錯誤日誌)。通過訪問日誌我們可以得到使用者的ip位址、瀏覽器的資訊,請求的處理時間等資訊。錯誤日誌記錄了訪問出錯的資訊,可以幫助我們定位錯誤的原因。本文將詳細描述一下如何配置nginx日誌。
訪問日誌主要記錄客戶端的請求。客戶端向nginx伺服器發起的每一次請求都記錄在這裡。客戶端ip,瀏覽器資訊,referer,請求處理時間,請求url等都可以在訪問日誌中得到。當然具體要記錄哪些資訊,你可以通過log_format
指令定義。
access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]]; # 設定訪問日誌
access_log off; # 關閉訪問日誌
另外,還有乙個特殊的值off。如果指定了該值,當前作用域下的所有的請求日誌都被關閉。
可以應用access_log
指令的作用域分別有http
,server
,location
,limit_except
。也就是說,在這幾個作用域外使用該指令,nginx會報錯。
以上是access_log指令的基本語法和引數的含義。下面我們看一幾個例子加深一下理解。
access_log /var/logs/nginx-access.log
該例子指定日誌的寫入路徑為/var/logs/nginx-access.log
,日誌格式使用預設的combined
。
access_log /var/logs/nginx-access.log buffer=32k gzip flush=1m
該例子指定日誌的寫入路徑為/var/logs/nginx-access.log
,日誌格式使用預設的combined
,指定日誌的快取大小為32k,日誌寫入前啟用gzip進行壓縮,壓縮比使用預設值1,快取資料有效時間為1分鐘。
nginx預定義了名為combined
日誌格式,如果沒有明確指定日誌格式預設使用該格式:
log_format combined '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent"';
如果不想使用nginx預定義的格式,可以通過log_format
指令來自定義。
log_format name [escape=default|json] string ...;
下面是log_format
指令中常用的一些變數:
變數含義
$bytes_sent
傳送給客戶端的總位元組數
$body_bytes_sent
傳送給客戶端的位元組數,不包括響應頭的大小
$connection
連線序列號
$connection_requests
當前通過連線發出的請求數量
$msec
日誌寫入時間,單位為秒,精度是毫秒
$pipe
如果請求是通過http流水線傳送,則其值為"p",否則為「."
$request_length
請求長度(包括請求行,請求頭和請求體)
$request_time
請求處理時長,單位為秒,精度為毫秒,從讀入客戶端的第乙個位元組開始,直到把最後乙個字元傳送張客戶端進行日誌寫入為止
$status
響應狀態碼
$time_iso8601
標準格式的本地時間,形如「2017-05-24t18:31:27+08:00」
$time_local
通用日誌格式下的本地時間,如"24/may/2017:18:31:27 +0800"
請求的referer位址。
客戶端瀏覽器資訊。
$remote_addr
客戶端ip
完整的原始請求行,如 "get / http/1.1"
$remote_user
客戶端使用者名稱,針對啟用了使用者認證的請求
$request_uri
完整的請求位址,如 ""
下面演示一下自定義日誌格式的使用:
'"$http_user_agent" "$http_x_forwarded_for"';我們使用log_format
指令定義了乙個main
的格式,並在access_log
指令中引用了它。假如客戶端有發起請求:,我們看一下我擷取的乙個請求的日誌記錄:
我們看到最終的日誌記錄中$remote_user
、$http_referer
、$http_x_forwarded_for
都對應了乙個-
,這是因為這幾個變數為空。
錯誤日誌在nginx中是通過error_log
指令實現的。該指令記錄伺服器和請求處理過程中的錯誤資訊。
配置錯誤日誌檔案的路徑和日誌級別。
error_log file [level];
default:
error_log logs/error.log error;
第乙個引數指定日誌的寫入位置。
第二個引數指定日誌的級別。level可以是debug
,info
,notice
,warn
,error
,crit
,alert
,emerg
中的任意值。可以看到其取值範圍是按緊急程度從低到高排列的。只有日誌的錯誤級別等於或高於level指定的值才會寫入錯誤日誌中。預設值是error
。
error_log /var/logs/nginx/nginx-error.log
它可以配置在:main
,http
,mail
,stream
,server
,location
作用域。
例子中指定了錯誤日誌的路徑為:/var/logs/nginx/nginx-error.log
,日誌級別使用預設的error
。
每一條日誌記錄的寫入都是先開啟檔案再寫入記錄,然後關閉日誌檔案。如果你的日誌檔案路徑中使用了變數,如access_log /var/logs/$host/nginx-access.log
,為提高效能,可以使用open_log_file_cache
指令設定日誌檔案描述符的快取。
open_log_file_cache max=n [inactive=time] [min_uses=n] [valid=time];
open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2;
它可以配置在http
、server
、location
作用域中。
例子中,設定快取最多快取1000個日誌檔案描述符,20s內如果快取中的日誌檔案描述符至少被被訪問2次,才不會被快取關閉。每隔1分鐘檢查快取中的檔案描述符的檔名是否還存在。
nginx中通過access_log
和error_log
指令配置訪問日誌和錯誤日誌,通過log_format
我們可以自定義日誌格式。如果日誌檔案路徑中使用了變數,我們可以通過open_log_file_cache
指令來設定快取,提公升效能。
另外,在access_log
和log_format
中使用了很多變數,這些變數沒有一一枚舉出來,詳細的變數資訊可以參考nginx官方文件
Nginx 日誌配置引數詳解
log format log format用來設定日誌格式,也就是日誌檔案中每條日誌的格式,具體如下 log format name 格式名稱 type 格式樣式 access log access log 指令用來指定日誌檔案的存放路徑 包含日誌檔名 格式和快取大小。具體如下 access log...
nginx 日誌詳解及自定義日誌配置
nginx的log日誌分為access log 和 error log 其中access log 記錄了哪些使用者,哪些頁面以及使用者瀏覽器 ip和其他的訪問資訊 error log 則是記錄伺服器錯誤日誌 錯誤日誌的形式如下 從上面我們可以看出幾部分資訊 2.訪問時間。如 上例中的 22 aug ...
Nginx日誌配置
一,日誌格式 http referer http user agent 此日誌格式為,ip不僅記錄 的ip還記錄遠端客戶端真實ip。remote addr與 http x forwarded for 用以記錄客戶端ip位址,乙個記錄 ip,乙個記錄真實ip remote user 用以記錄客戶端使用...